1 /*
   2  * Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.  Oracle designates this
   8  * particular file as subject to the "Classpath" exception as provided
   9  * by Oracle in the LICENSE file that accompanied this code.
  10  *
  11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 package javax.print.attribute.standard;
  26 
  27 import java.util.HashMap;
  28 import java.util.Vector;
  29 
  30 import javax.print.attribute.Size2DSyntax;
  31 import javax.print.attribute.Attribute;
  32 
  33 /**
  34  * Class MediaSize is a two-dimensional size valued printing attribute class
  35  * that indicates the dimensions of the medium in a portrait orientation, with
  36  * the X dimension running along the bottom edge and the Y dimension running
  37  * along the left edge. Thus, the Y dimension must be greater than or equal to
  38  * the X dimension. Class MediaSize declares many standard media size
  39  * values, organized into nested classes for ISO, JIS, North American,
  40  * engineering, and other media.
  41  * <P>
  42  * MediaSize is not yet used to specify media. Its current role is
  43  * as a mapping for named media (see {@link MediaSizeName MediaSizeName}).
  44  * Clients can use the mapping method
  45  * <code>MediaSize.getMediaSizeForName(MediaSizeName)</code>
  46  * to find the physical dimensions of the MediaSizeName instances
  47  * enumerated in this API. This is useful for clients which need this
  48  * information to format {@literal &} paginate printing.
  49  * <P>
  50  *
  51  * @author  Phil Race, Alan Kaminsky
  52  */
  53 public class MediaSize extends Size2DSyntax implements Attribute {
  54 
  55     private static final long serialVersionUID = -1967958664615414771L;
  56 
  57     private MediaSizeName mediaName;
  58 
  59     private static HashMap mediaMap = new HashMap(100, 10);
  60 
  61     private static Vector sizeVector = new Vector(100, 10);
  62 
  63     /**
  64      * Construct a new media size attribute from the given floating-point
  65      * values.
  66      *
  67      * @param  x  X dimension.
  68      * @param  y  Y dimension.
  69      * @param  units
  70      *     Unit conversion factor, e.g. <CODE>Size2DSyntax.INCH</CODE> or
  71      *     <CODE>Size2DSyntax.MM</CODE>.
  72      *
  73      * @exception  IllegalArgumentException
  74      *   (Unchecked exception) Thrown if {@code x < 0} or {@code y < 0} or
  75      *   {@code units < 1} or {@code x > y}.
  76      */
  77     public MediaSize(float x, float y,int units) {
  78         super (x, y, units);
  79         if (x > y) {
  80             throw new IllegalArgumentException("X dimension > Y dimension");
  81         }
  82         sizeVector.add(this);
  83     }
  84 
  85     /**
  86      * Construct a new media size attribute from the given integer values.
  87      *
  88      * @param  x  X dimension.
  89      * @param  y  Y dimension.
  90      * @param  units
  91      *     Unit conversion factor, e.g. <CODE>Size2DSyntax.INCH</CODE> or
  92      *     <CODE>Size2DSyntax.MM</CODE>.
  93      *
  94      * @exception  IllegalArgumentException
  95      *   (Unchecked exception) Thrown if {@code x < 0} or {@code y < 0} or
  96      *   {@code units < 1} or {@code x > y}.
  97      */
  98     public MediaSize(int x, int y,int units) {
  99         super (x, y, units);
 100         if (x > y) {
 101             throw new IllegalArgumentException("X dimension > Y dimension");
 102         }
 103         sizeVector.add(this);
 104     }
 105 
 106    /**
 107      * Construct a new media size attribute from the given floating-point
 108      * values.
 109      *
 110      * @param  x  X dimension.
 111      * @param  y  Y dimension.
 112      * @param  units
 113      *     Unit conversion factor, e.g. <CODE>Size2DSyntax.INCH</CODE> or
 114      *     <CODE>Size2DSyntax.MM</CODE>.
 115      * @param media a media name to associate with this MediaSize
 116      *
 117      * @exception  IllegalArgumentException
 118      *   (Unchecked exception) Thrown if {@code x < 0} or {@code y < 0} or
 119      *   {@code units < 1} or {@code x > y}.
 120      */
 121     public MediaSize(float x, float y,int units, MediaSizeName media) {
 122         super (x, y, units);
 123         if (x > y) {
 124             throw new IllegalArgumentException("X dimension > Y dimension");
 125         }
 126         if (media != null && mediaMap.get(media) == null) {
 127             mediaName = media;
 128             mediaMap.put(mediaName, this);
 129         }
 130         sizeVector.add(this);
 131     }
 132 
 133     /**
 134      * Construct a new media size attribute from the given integer values.
 135      *
 136      * @param  x  X dimension.
 137      * @param  y  Y dimension.
 138      * @param  units
 139      *     Unit conversion factor, e.g. <CODE>Size2DSyntax.INCH</CODE> or
 140      *     <CODE>Size2DSyntax.MM</CODE>.
 141      * @param media a media name to associate with this MediaSize
 142      *
 143      * @exception  IllegalArgumentException
 144      *   (Unchecked exception) Thrown if {@code x < 0} or {@code y < 0} or
 145      *   {@code units < 1} or {@code x > y}.
 146      */
 147     public MediaSize(int x, int y,int units, MediaSizeName media) {
 148         super (x, y, units);
 149         if (x > y) {
 150             throw new IllegalArgumentException("X dimension > Y dimension");
 151         }
 152         if (media != null && mediaMap.get(media) == null) {
 153             mediaName = media;
 154             mediaMap.put(mediaName, this);
 155         }
 156         sizeVector.add(this);
 157     }
 158 
 159     /**
 160      * Get the media name, if any, for this size.
 161      *
 162      * @return the name for this media size, or null if no name was
 163      * associated with this size (an anonymous size).
 164      */
 165     public MediaSizeName getMediaSizeName() {
 166         return mediaName;
 167     }
 168 
 169     /**
 170      * Get the MediaSize for the specified named media.
 171      *
 172      * @param media - the name of the media for which the size is sought
 173      * @return size of the media, or null if this media is not associated
 174      * with any size.
 175      */
 176     public static MediaSize getMediaSizeForName(MediaSizeName media) {
 177         return (MediaSize)mediaMap.get(media);
 178     }
 179 
 180     /**
 181      * The specified dimensions are used to locate a matching MediaSize
 182      * instance from amongst all the standard MediaSize instances.
 183      * If there is no exact match, the closest match is used.
 184      * <p>
 185      * The MediaSize is in turn used to locate the MediaSizeName object.
 186      * This method may return null if the closest matching MediaSize
 187      * has no corresponding Media instance.
 188      * <p>
 189      * This method is useful for clients which have only dimensions and
 190      * want to find a Media which corresponds to the dimensions.
 191      * @param x - X dimension
 192      * @param y - Y dimension.
 193      * @param  units
 194      *     Unit conversion factor, e.g. <CODE>Size2DSyntax.INCH</CODE> or
 195      *     <CODE>Size2DSyntax.MM</CODE>
 196      * @return MediaSizeName matching these dimensions, or null.
 197      * @exception IllegalArgumentException if {@code x <= 0},
 198      *      {@code y <= 0}, or {@code units < 1}.
 199      *
 200      */
 201     public static MediaSizeName findMedia(float x, float y, int units) {
 202 
 203         MediaSize match = MediaSize.ISO.A4;
 204 
 205         if (x <= 0.0f || y <= 0.0f || units < 1) {
 206             throw new IllegalArgumentException("args must be +ve values");
 207         }
 208 
 209         double ls = x * x + y * y;
 210         double tmp_ls;
 211         float []dim;
 212         float diffx = x;
 213         float diffy = y;
 214 
 215         for (int i=0; i < sizeVector.size() ; i++) {
 216             MediaSize mediaSize = (MediaSize)sizeVector.elementAt(i);
 217             dim = mediaSize.getSize(units);
 218             if (x == dim[0] && y == dim[1]) {
 219                 match = mediaSize;
 220                 break;
 221             } else {
 222                 diffx = x - dim[0];
 223                 diffy = y - dim[1];
 224                 tmp_ls = diffx * diffx + diffy * diffy;
 225                 if (tmp_ls < ls) {
 226                     ls = tmp_ls;
 227                     match = mediaSize;
 228                 }
 229             }
 230         }
 231 
 232         return match.getMediaSizeName();
 233     }
 234 
 235     /**
 236      * Returns whether this media size attribute is equivalent to the passed
 237      * in object.
 238      * To be equivalent, all of the following conditions must be true:
 239      * <OL TYPE=1>
 240      * <LI>
 241      * <CODE>object</CODE> is not null.
 242      * <LI>
 243      * <CODE>object</CODE> is an instance of class MediaSize.
 244      * <LI>
 245      * This media size attribute's X dimension is equal to
 246      * <CODE>object</CODE>'s X dimension.
 247      * <LI>
 248      * This media size attribute's Y dimension is equal to
 249      * <CODE>object</CODE>'s Y dimension.
 250      * </OL>
 251      *
 252      * @param  object  Object to compare to.
 253      *
 254      * @return  True if <CODE>object</CODE> is equivalent to this media size
 255      *          attribute, false otherwise.
 256      */
 257     public boolean equals(Object object) {
 258         return (super.equals(object) && object instanceof MediaSize);
 259     }
 260 
 261     /**
 262      * Get the printing attribute class which is to be used as the "category"
 263      * for this printing attribute value.
 264      * <P>
 265      * For class MediaSize and any vendor-defined subclasses, the category is
 266      * class MediaSize itself.
 267      *
 268      * @return  Printing attribute class (category), an instance of class
 269      *          {@link java.lang.Class java.lang.Class}.
 270      */
 271     public final Class<? extends Attribute> getCategory() {
 272         return MediaSize.class;
 273     }
 274 
 275     /**
 276      * Get the name of the category of which this attribute value is an
 277      * instance.
 278      * <P>
 279      * For class MediaSize and any vendor-defined subclasses, the category
 280      * name is <CODE>"media-size"</CODE>.
 281      *
 282      * @return  Attribute category name.
 283      */
 284     public final String getName() {
 285         return "media-size";
 286     }
 287 
 288     /**
 289      * Class MediaSize.ISO includes {@link MediaSize MediaSize} values for ISO
 290      * media.
 291      */
 292     public final static class ISO {
 293         /**
 294          * Specifies the ISO A0 size, 841 mm by 1189 mm.
 295          */
 296         public static final MediaSize
 297             A0 = new MediaSize(841, 1189, Size2DSyntax.MM, MediaSizeName.ISO_A0);
 298         /**
 299          * Specifies the ISO A1 size, 594 mm by 841 mm.
 300          */
 301         public static final MediaSize
 302             A1 = new MediaSize(594, 841, Size2DSyntax.MM, MediaSizeName.ISO_A1);
 303         /**
 304          * Specifies the ISO A2 size, 420 mm by 594 mm.
 305          */
 306         public static final MediaSize
 307             A2 = new MediaSize(420, 594, Size2DSyntax.MM, MediaSizeName.ISO_A2);
 308         /**
 309          * Specifies the ISO A3 size, 297 mm by 420 mm.
 310          */
 311         public static final MediaSize
 312             A3 = new MediaSize(297, 420, Size2DSyntax.MM, MediaSizeName.ISO_A3);
 313         /**
 314          * Specifies the ISO A4 size, 210 mm by 297 mm.
 315          */
 316         public static final MediaSize
 317             A4 = new MediaSize(210, 297, Size2DSyntax.MM, MediaSizeName.ISO_A4);
 318         /**
 319          * Specifies the ISO A5 size, 148 mm by 210 mm.
 320          */
 321         public static final MediaSize
 322             A5 = new MediaSize(148, 210, Size2DSyntax.MM, MediaSizeName.ISO_A5);
 323         /**
 324          * Specifies the ISO A6 size, 105 mm by 148 mm.
 325          */
 326         public static final MediaSize
 327             A6 = new MediaSize(105, 148, Size2DSyntax.MM, MediaSizeName.ISO_A6);
 328         /**
 329          * Specifies the ISO A7 size, 74 mm by 105 mm.
 330          */
 331         public static final MediaSize
 332             A7 = new MediaSize(74, 105, Size2DSyntax.MM, MediaSizeName.ISO_A7);
 333         /**
 334          * Specifies the ISO A8 size, 52 mm by 74 mm.
 335          */
 336         public static final MediaSize
 337             A8 = new MediaSize(52, 74, Size2DSyntax.MM, MediaSizeName.ISO_A8);
 338         /**
 339          * Specifies the ISO A9 size, 37 mm by 52 mm.
 340          */
 341         public static final MediaSize
 342             A9 = new MediaSize(37, 52, Size2DSyntax.MM, MediaSizeName.ISO_A9);
 343         /**
 344          * Specifies the ISO A10 size, 26 mm by 37 mm.
 345          */
 346         public static final MediaSize
 347             A10 = new MediaSize(26, 37, Size2DSyntax.MM, MediaSizeName.ISO_A10);
 348         /**
 349          * Specifies the ISO B0 size, 1000 mm by 1414 mm.
 350          */
 351         public static final MediaSize
 352             B0 = new MediaSize(1000, 1414, Size2DSyntax.MM, MediaSizeName.ISO_B0);
 353         /**
 354          * Specifies the ISO B1 size, 707 mm by 1000 mm.
 355          */
 356         public static final MediaSize
 357             B1 = new MediaSize(707, 1000, Size2DSyntax.MM, MediaSizeName.ISO_B1);
 358         /**
 359          * Specifies the ISO B2 size, 500 mm by 707 mm.
 360          */
 361         public static final MediaSize
 362             B2 = new MediaSize(500, 707, Size2DSyntax.MM, MediaSizeName.ISO_B2);
 363         /**
 364          * Specifies the ISO B3 size, 353 mm by 500 mm.
 365          */
 366         public static final MediaSize
 367             B3 = new MediaSize(353, 500, Size2DSyntax.MM, MediaSizeName.ISO_B3);
 368         /**
 369          * Specifies the ISO B4 size, 250 mm by 353 mm.
 370          */
 371         public static final MediaSize
 372             B4 = new MediaSize(250, 353, Size2DSyntax.MM, MediaSizeName.ISO_B4);
 373         /**
 374          * Specifies the ISO B5 size, 176 mm by 250 mm.
 375          */
 376         public static final MediaSize
 377             B5 = new MediaSize(176, 250, Size2DSyntax.MM, MediaSizeName.ISO_B5);
 378         /**
 379          * Specifies the ISO B6 size, 125 mm by 176 mm.
 380          */
 381         public static final MediaSize
 382             B6 = new MediaSize(125, 176, Size2DSyntax.MM, MediaSizeName.ISO_B6);
 383         /**
 384          * Specifies the ISO B7 size, 88 mm by 125 mm.
 385          */
 386         public static final MediaSize
 387             B7 = new MediaSize(88, 125, Size2DSyntax.MM, MediaSizeName.ISO_B7);
 388         /**
 389          * Specifies the ISO B8 size, 62 mm by 88 mm.
 390          */
 391         public static final MediaSize
 392             B8 = new MediaSize(62, 88, Size2DSyntax.MM, MediaSizeName.ISO_B8);
 393         /**
 394          * Specifies the ISO B9 size, 44 mm by 62 mm.
 395          */
 396         public static final MediaSize
 397             B9 = new MediaSize(44, 62, Size2DSyntax.MM, MediaSizeName.ISO_B9);
 398         /**
 399          * Specifies the ISO B10 size, 31 mm by 44 mm.
 400          */
 401         public static final MediaSize
 402             B10 = new MediaSize(31, 44, Size2DSyntax.MM, MediaSizeName.ISO_B10);
 403         /**
 404          * Specifies the ISO C3 size, 324 mm by 458 mm.
 405          */
 406         public static final MediaSize
 407             C3 = new MediaSize(324, 458, Size2DSyntax.MM, MediaSizeName.ISO_C3);
 408         /**
 409          * Specifies the ISO C4 size, 229 mm by 324 mm.
 410          */
 411         public static final MediaSize
 412             C4 = new MediaSize(229, 324, Size2DSyntax.MM, MediaSizeName.ISO_C4);
 413         /**
 414          * Specifies the ISO C5 size, 162 mm by 229 mm.
 415          */
 416         public static final MediaSize
 417             C5 = new MediaSize(162, 229, Size2DSyntax.MM, MediaSizeName.ISO_C5);
 418         /**
 419          * Specifies the ISO C6 size, 114 mm by 162 mm.
 420          */
 421         public static final MediaSize
 422             C6 = new MediaSize(114, 162, Size2DSyntax.MM, MediaSizeName.ISO_C6);
 423         /**
 424          * Specifies the ISO Designated Long size, 110 mm by 220 mm.
 425          */
 426         public static final MediaSize
 427             DESIGNATED_LONG = new MediaSize(110, 220, Size2DSyntax.MM,
 428                                             MediaSizeName.ISO_DESIGNATED_LONG);
 429 
 430         /**
 431          * Hide all constructors.
 432          */
 433         private ISO() {
 434         }
 435     }
 436 
 437     /**
 438      * Class MediaSize.JIS includes {@link MediaSize MediaSize} values for JIS
 439      * (Japanese) media.      *
 440      */
 441     public final static class JIS {
 442 
 443         /**
 444          * Specifies the JIS B0 size, 1030 mm by 1456 mm.
 445          */
 446         public static final MediaSize
 447             B0 = new MediaSize(1030, 1456, Size2DSyntax.MM, MediaSizeName.JIS_B0);
 448         /**
 449          * Specifies the JIS B1 size, 728 mm by 1030 mm.
 450          */
 451         public static final MediaSize
 452             B1 = new MediaSize(728, 1030, Size2DSyntax.MM, MediaSizeName.JIS_B1);
 453         /**
 454          * Specifies the JIS B2 size, 515 mm by 728 mm.
 455          */
 456         public static final MediaSize
 457             B2 = new MediaSize(515, 728, Size2DSyntax.MM, MediaSizeName.JIS_B2);
 458         /**
 459          * Specifies the JIS B3 size, 364 mm by 515 mm.
 460          */
 461         public static final MediaSize
 462             B3 = new MediaSize(364, 515, Size2DSyntax.MM, MediaSizeName.JIS_B3);
 463         /**
 464          * Specifies the JIS B4 size, 257 mm by 364 mm.
 465          */
 466         public static final MediaSize
 467             B4 = new MediaSize(257, 364, Size2DSyntax.MM, MediaSizeName.JIS_B4);
 468         /**
 469          * Specifies the JIS B5 size, 182 mm by 257 mm.
 470          */
 471         public static final MediaSize
 472             B5 = new MediaSize(182, 257, Size2DSyntax.MM, MediaSizeName.JIS_B5);
 473         /**
 474          * Specifies the JIS B6 size, 128 mm by 182 mm.
 475          */
 476         public static final MediaSize
 477             B6 = new MediaSize(128, 182, Size2DSyntax.MM, MediaSizeName.JIS_B6);
 478         /**
 479          * Specifies the JIS B7 size, 91 mm by 128 mm.
 480          */
 481         public static final MediaSize
 482             B7 = new MediaSize(91, 128, Size2DSyntax.MM, MediaSizeName.JIS_B7);
 483         /**
 484          * Specifies the JIS B8 size, 64 mm by 91 mm.
 485          */
 486         public static final MediaSize
 487             B8 = new MediaSize(64, 91, Size2DSyntax.MM, MediaSizeName.JIS_B8);
 488         /**
 489          * Specifies the JIS B9 size, 45 mm by 64 mm.
 490          */
 491         public static final MediaSize
 492             B9 = new MediaSize(45, 64, Size2DSyntax.MM, MediaSizeName.JIS_B9);
 493         /**
 494          * Specifies the JIS B10 size, 32 mm by 45 mm.
 495          */
 496         public static final MediaSize
 497             B10 = new MediaSize(32, 45, Size2DSyntax.MM, MediaSizeName.JIS_B10);
 498         /**
 499          * Specifies the JIS Chou ("long") #1 envelope size, 142 mm by 332 mm.
 500          */
 501         public static final MediaSize CHOU_1 = new MediaSize(142, 332, Size2DSyntax.MM);
 502         /**
 503          * Specifies the JIS Chou ("long") #2 envelope size, 119 mm by 277 mm.
 504          */
 505         public static final MediaSize CHOU_2 = new MediaSize(119, 277, Size2DSyntax.MM);
 506         /**
 507          * Specifies the JIS Chou ("long") #3 envelope size, 120 mm by 235 mm.
 508          */
 509         public static final MediaSize CHOU_3 = new MediaSize(120, 235, Size2DSyntax.MM);
 510         /**
 511          * Specifies the JIS Chou ("long") #4 envelope size, 90 mm by 205 mm.
 512          */
 513         public static final MediaSize CHOU_4 = new MediaSize(90, 205, Size2DSyntax.MM);
 514         /**
 515          * Specifies the JIS Chou ("long") #30 envelope size, 92 mm by 235 mm.
 516          */
 517         public static final MediaSize CHOU_30 = new MediaSize(92, 235, Size2DSyntax.MM);
 518         /**
 519          * Specifies the JIS Chou ("long") #40 envelope size, 90 mm by 225 mm.
 520          */
 521         public static final MediaSize CHOU_40 = new MediaSize(90, 225, Size2DSyntax.MM);
 522         /**
 523          * Specifies the JIS Kaku ("square") #0 envelope size, 287 mm by 382 mm.
 524          */
 525         public static final MediaSize KAKU_0 = new MediaSize(287, 382, Size2DSyntax.MM);
 526         /**
 527          * Specifies the JIS Kaku ("square") #1 envelope size, 270 mm by 382 mm.
 528          */
 529         public static final MediaSize KAKU_1 = new MediaSize(270, 382, Size2DSyntax.MM);
 530         /**
 531          * Specifies the JIS Kaku ("square") #2 envelope size, 240 mm by 332 mm.
 532          */
 533         public static final MediaSize KAKU_2 = new MediaSize(240, 332, Size2DSyntax.MM);
 534         /**
 535          * Specifies the JIS Kaku ("square") #3 envelope size, 216 mm by 277 mm.
 536          */
 537         public static final MediaSize KAKU_3 = new MediaSize(216, 277, Size2DSyntax.MM);
 538         /**
 539          * Specifies the JIS Kaku ("square") #4 envelope size, 197 mm by 267 mm.
 540          */
 541         public static final MediaSize KAKU_4 = new MediaSize(197, 267, Size2DSyntax.MM);
 542         /**
 543          * Specifies the JIS Kaku ("square") #5 envelope size, 190 mm by 240 mm.
 544          */
 545         public static final MediaSize KAKU_5 = new MediaSize(190, 240, Size2DSyntax.MM);
 546         /**
 547          * Specifies the JIS Kaku ("square") #6 envelope size, 162 mm by 229 mm.
 548          */
 549         public static final MediaSize KAKU_6 = new MediaSize(162, 229, Size2DSyntax.MM);
 550         /**
 551          * Specifies the JIS Kaku ("square") #7 envelope size, 142 mm by 205 mm.
 552          */
 553         public static final MediaSize KAKU_7 = new MediaSize(142, 205, Size2DSyntax.MM);
 554         /**
 555          * Specifies the JIS Kaku ("square") #8 envelope size, 119 mm by 197 mm.
 556          */
 557         public static final MediaSize KAKU_8 = new MediaSize(119, 197, Size2DSyntax.MM);
 558         /**
 559          * Specifies the JIS Kaku ("square") #20 envelope size, 229 mm by 324 mm.
 560          */
 561         public static final MediaSize KAKU_20 = new MediaSize(229, 324, Size2DSyntax.MM);
 562         /**
 563          * Specifies the JIS Kaku ("square") A4 envelope size, 228 mm by 312 mm.
 564          */
 565         public static final MediaSize KAKU_A4 = new MediaSize(228, 312, Size2DSyntax.MM);
 566         /**
 567          * Specifies the JIS You ("Western") #1 envelope size, 120 mm by 176 mm.
 568          */
 569         public static final MediaSize YOU_1 = new MediaSize(120, 176, Size2DSyntax.MM);
 570         /**
 571          * Specifies the JIS You ("Western") #2 envelope size, 114 mm by 162 mm.
 572          */
 573         public static final MediaSize YOU_2 = new MediaSize(114, 162, Size2DSyntax.MM);
 574         /**
 575          * Specifies the JIS You ("Western") #3 envelope size, 98 mm by 148 mm.
 576          */
 577         public static final MediaSize YOU_3 = new MediaSize(98, 148, Size2DSyntax.MM);
 578         /**
 579          * Specifies the JIS You ("Western") #4 envelope size, 105 mm by 235 mm.
 580          */
 581         public static final MediaSize YOU_4 = new MediaSize(105, 235, Size2DSyntax.MM);
 582         /**
 583          * Specifies the JIS You ("Western") #5 envelope size, 95 mm by 217 mm.
 584          */
 585         public static final MediaSize YOU_5 = new MediaSize(95, 217, Size2DSyntax.MM);
 586         /**
 587          * Specifies the JIS You ("Western") #6 envelope size, 98 mm by 190 mm.
 588          */
 589         public static final MediaSize YOU_6 = new MediaSize(98, 190, Size2DSyntax.MM);
 590         /**
 591          * Specifies the JIS You ("Western") #7 envelope size, 92 mm by 165 mm.
 592          */
 593         public static final MediaSize YOU_7 = new MediaSize(92, 165, Size2DSyntax.MM);
 594         /**
 595          * Hide all constructors.
 596          */
 597         private JIS() {
 598         }
 599     }
 600 
 601     /**
 602      * Class MediaSize.NA includes {@link MediaSize MediaSize} values for North
 603      * American media.
 604      */
 605     public final static class NA {
 606 
 607         /**
 608          * Specifies the North American letter size, 8.5 inches by 11 inches.
 609          */
 610         public static final MediaSize
 611             LETTER = new MediaSize(8.5f, 11.0f, Size2DSyntax.INCH,
 612                                                 MediaSizeName.NA_LETTER);
 613         /**
 614          * Specifies the North American legal size, 8.5 inches by 14 inches.
 615          */
 616         public static final MediaSize
 617             LEGAL = new MediaSize(8.5f, 14.0f, Size2DSyntax.INCH,
 618                                                MediaSizeName.NA_LEGAL);
 619         /**
 620          * Specifies the North American 5 inch by 7 inch paper.
 621          */
 622         public static final MediaSize
 623             NA_5X7 = new MediaSize(5, 7, Size2DSyntax.INCH,
 624                                    MediaSizeName.NA_5X7);
 625         /**
 626          * Specifies the North American 8 inch by 10 inch paper.
 627          */
 628         public static final MediaSize
 629             NA_8X10 = new MediaSize(8, 10, Size2DSyntax.INCH,
 630                                    MediaSizeName.NA_8X10);
 631         /**
 632          * Specifies the North American Number 9 business envelope size,
 633          * 3.875 inches by 8.875 inches.
 634          */
 635         public static final MediaSize
 636             NA_NUMBER_9_ENVELOPE =
 637             new MediaSize(3.875f, 8.875f, Size2DSyntax.INCH,
 638                           MediaSizeName.NA_NUMBER_9_ENVELOPE);
 639         /**
 640          * Specifies the North American Number 10 business envelope size,
 641          * 4.125 inches by 9.5 inches.
 642          */
 643         public static final MediaSize
 644             NA_NUMBER_10_ENVELOPE =
 645             new MediaSize(4.125f, 9.5f, Size2DSyntax.INCH,
 646                           MediaSizeName.NA_NUMBER_10_ENVELOPE);
 647         /**
 648          * Specifies the North American Number 11 business envelope size,
 649          * 4.5 inches by 10.375 inches.
 650          */
 651         public static final MediaSize
 652             NA_NUMBER_11_ENVELOPE =
 653             new MediaSize(4.5f, 10.375f, Size2DSyntax.INCH,
 654                           MediaSizeName.NA_NUMBER_11_ENVELOPE);
 655         /**
 656          * Specifies the North American Number 12 business envelope size,
 657          * 4.75 inches by 11 inches.
 658          */
 659         public static final MediaSize
 660             NA_NUMBER_12_ENVELOPE =
 661             new MediaSize(4.75f, 11.0f, Size2DSyntax.INCH,
 662                           MediaSizeName.NA_NUMBER_12_ENVELOPE);
 663         /**
 664          * Specifies the North American Number 14 business envelope size,
 665          * 5 inches by 11.5 inches.
 666          */
 667         public static final MediaSize
 668             NA_NUMBER_14_ENVELOPE =
 669             new MediaSize(5.0f, 11.5f, Size2DSyntax.INCH,
 670                           MediaSizeName.NA_NUMBER_14_ENVELOPE);
 671 
 672         /**
 673          * Specifies the North American 6 inch by 9 inch envelope size.
 674          */
 675         public static final MediaSize
 676             NA_6X9_ENVELOPE = new MediaSize(6.0f, 9.0f, Size2DSyntax.INCH,
 677                                             MediaSizeName.NA_6X9_ENVELOPE);
 678         /**
 679          * Specifies the North American 7 inch by 9 inch envelope size.
 680          */
 681         public static final MediaSize
 682             NA_7X9_ENVELOPE = new MediaSize(7.0f, 9.0f, Size2DSyntax.INCH,
 683                                             MediaSizeName.NA_7X9_ENVELOPE);
 684         /**
 685          * Specifies the North American 9 inch by 11 inch envelope size.
 686          */
 687         public static final MediaSize
 688             NA_9x11_ENVELOPE = new MediaSize(9.0f, 11.0f, Size2DSyntax.INCH,
 689                                              MediaSizeName.NA_9X11_ENVELOPE);
 690         /**
 691          * Specifies the North American 9 inch by 12 inch envelope size.
 692          */
 693         public static final MediaSize
 694             NA_9x12_ENVELOPE = new MediaSize(9.0f, 12.0f, Size2DSyntax.INCH,
 695                                              MediaSizeName.NA_9X12_ENVELOPE);
 696         /**
 697          * Specifies the North American 10 inch by 13 inch envelope size.
 698          */
 699         public static final MediaSize
 700             NA_10x13_ENVELOPE = new MediaSize(10.0f, 13.0f, Size2DSyntax.INCH,
 701                                               MediaSizeName.NA_10X13_ENVELOPE);
 702         /**
 703          * Specifies the North American 10 inch by 14 inch envelope size.
 704          */
 705         public static final MediaSize
 706             NA_10x14_ENVELOPE = new MediaSize(10.0f, 14.0f, Size2DSyntax.INCH,
 707                                               MediaSizeName.NA_10X14_ENVELOPE);
 708         /**
 709          * Specifies the North American 10 inch by 15 inch envelope size.
 710          */
 711         public static final MediaSize
 712             NA_10X15_ENVELOPE = new MediaSize(10.0f, 15.0f, Size2DSyntax.INCH,
 713                                               MediaSizeName.NA_10X15_ENVELOPE);
 714         /**
 715          * Hide all constructors.
 716          */
 717         private NA() {
 718         }
 719     }
 720 
 721     /**
 722      * Class MediaSize.Engineering includes {@link MediaSize MediaSize} values
 723      * for engineering media.
 724      */
 725     public final static class Engineering {
 726 
 727         /**
 728          * Specifies the engineering A size, 8.5 inch by 11 inch.
 729          */
 730         public static final MediaSize
 731             A = new MediaSize(8.5f, 11.0f, Size2DSyntax.INCH,
 732                               MediaSizeName.A);
 733         /**
 734          * Specifies the engineering B size, 11 inch by 17 inch.
 735          */
 736         public static final MediaSize
 737             B = new MediaSize(11.0f, 17.0f, Size2DSyntax.INCH,
 738                               MediaSizeName.B);
 739         /**
 740          * Specifies the engineering C size, 17 inch by 22 inch.
 741          */
 742         public static final MediaSize
 743             C = new MediaSize(17.0f, 22.0f, Size2DSyntax.INCH,
 744                               MediaSizeName.C);
 745         /**
 746          * Specifies the engineering D size, 22 inch by 34 inch.
 747          */
 748         public static final MediaSize
 749             D = new MediaSize(22.0f, 34.0f, Size2DSyntax.INCH,
 750                               MediaSizeName.D);
 751         /**
 752          * Specifies the engineering E size, 34 inch by 44 inch.
 753          */
 754         public static final MediaSize
 755             E = new MediaSize(34.0f, 44.0f, Size2DSyntax.INCH,
 756                               MediaSizeName.E);
 757         /**
 758          * Hide all constructors.
 759          */
 760         private Engineering() {
 761         }
 762     }
 763 
 764     /**
 765      * Class MediaSize.Other includes {@link MediaSize MediaSize} values for
 766      * miscellaneous media.
 767      */
 768     public final static class Other {
 769         /**
 770          * Specifies the executive size, 7.25 inches by 10.5 inches.
 771          */
 772         public static final MediaSize
 773             EXECUTIVE = new MediaSize(7.25f, 10.5f, Size2DSyntax.INCH,
 774                                       MediaSizeName.EXECUTIVE);
 775         /**
 776          * Specifies the ledger size, 11 inches by 17 inches.
 777          */
 778         public static final MediaSize
 779             LEDGER = new MediaSize(11.0f, 17.0f, Size2DSyntax.INCH,
 780                                    MediaSizeName.LEDGER);
 781 
 782         /**
 783          * Specifies the tabloid size, 11 inches by 17 inches.
 784          * @since 1.5
 785          */
 786         public static final MediaSize
 787             TABLOID = new MediaSize(11.0f, 17.0f, Size2DSyntax.INCH,
 788                                    MediaSizeName.TABLOID);
 789 
 790         /**
 791          * Specifies the invoice size, 5.5 inches by 8.5 inches.
 792          */
 793         public static final MediaSize
 794             INVOICE = new MediaSize(5.5f, 8.5f, Size2DSyntax.INCH,
 795                               MediaSizeName.INVOICE);
 796         /**
 797          * Specifies the folio size, 8.5 inches by 13 inches.
 798          */
 799         public static final MediaSize
 800             FOLIO = new MediaSize(8.5f, 13.0f, Size2DSyntax.INCH,
 801                                   MediaSizeName.FOLIO);
 802         /**
 803          * Specifies the quarto size, 8.5 inches by 10.83 inches.
 804          */
 805         public static final MediaSize
 806             QUARTO = new MediaSize(8.5f, 10.83f, Size2DSyntax.INCH,
 807                                    MediaSizeName.QUARTO);
 808         /**
 809          * Specifies the Italy envelope size, 110 mm by 230 mm.
 810          */
 811         public static final MediaSize
 812         ITALY_ENVELOPE = new MediaSize(110, 230, Size2DSyntax.MM,
 813                                        MediaSizeName.ITALY_ENVELOPE);
 814         /**
 815          * Specifies the Monarch envelope size, 3.87 inch by 7.5 inch.
 816          */
 817         public static final MediaSize
 818         MONARCH_ENVELOPE = new MediaSize(3.87f, 7.5f, Size2DSyntax.INCH,
 819                                          MediaSizeName.MONARCH_ENVELOPE);
 820         /**
 821          * Specifies the Personal envelope size, 3.625 inch by 6.5 inch.
 822          */
 823         public static final MediaSize
 824         PERSONAL_ENVELOPE = new MediaSize(3.625f, 6.5f, Size2DSyntax.INCH,
 825                                          MediaSizeName.PERSONAL_ENVELOPE);
 826         /**
 827          * Specifies the Japanese postcard size, 100 mm by 148 mm.
 828          */
 829         public static final MediaSize
 830             JAPANESE_POSTCARD = new MediaSize(100, 148, Size2DSyntax.MM,
 831                                               MediaSizeName.JAPANESE_POSTCARD);
 832         /**
 833          * Specifies the Japanese Double postcard size, 148 mm by 200 mm.
 834          */
 835         public static final MediaSize
 836             JAPANESE_DOUBLE_POSTCARD = new MediaSize(148, 200, Size2DSyntax.MM,
 837                                      MediaSizeName.JAPANESE_DOUBLE_POSTCARD);
 838         /**
 839          * Hide all constructors.
 840          */
 841         private Other() {
 842         }
 843     }
 844 
 845     /* force loading of all the subclasses so that the instances
 846      * are created and inserted into the hashmap.
 847      */
 848     static {
 849         MediaSize ISOA4 = ISO.A4;
 850         MediaSize JISB5 = JIS.B5;
 851         MediaSize NALETTER = NA.LETTER;
 852         MediaSize EngineeringC = Engineering.C;
 853         MediaSize OtherEXECUTIVE = Other.EXECUTIVE;
 854     }
 855 }