View Javadoc
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      * <P>
292      */
293     public final static class ISO {
294         /**
295          * Specifies the ISO A0 size, 841 mm by 1189 mm.
296          */
297         public static final MediaSize
298             A0 = new MediaSize(841, 1189, Size2DSyntax.MM, MediaSizeName.ISO_A0);
299         /**
300          * Specifies the ISO A1 size, 594 mm by 841 mm.
301          */
302         public static final MediaSize
303             A1 = new MediaSize(594, 841, Size2DSyntax.MM, MediaSizeName.ISO_A1);
304         /**
305          * Specifies the ISO A2 size, 420 mm by 594 mm.
306          */
307         public static final MediaSize
308             A2 = new MediaSize(420, 594, Size2DSyntax.MM, MediaSizeName.ISO_A2);
309         /**
310          * Specifies the ISO A3 size, 297 mm by 420 mm.
311          */
312         public static final MediaSize
313             A3 = new MediaSize(297, 420, Size2DSyntax.MM, MediaSizeName.ISO_A3);
314         /**
315          * Specifies the ISO A4 size, 210 mm by 297 mm.
316          */
317         public static final MediaSize
318             A4 = new MediaSize(210, 297, Size2DSyntax.MM, MediaSizeName.ISO_A4);
319         /**
320          * Specifies the ISO A5 size, 148 mm by 210 mm.
321          */
322         public static final MediaSize
323             A5 = new MediaSize(148, 210, Size2DSyntax.MM, MediaSizeName.ISO_A5);
324         /**
325          * Specifies the ISO A6 size, 105 mm by 148 mm.
326          */
327         public static final MediaSize
328             A6 = new MediaSize(105, 148, Size2DSyntax.MM, MediaSizeName.ISO_A6);
329         /**
330          * Specifies the ISO A7 size, 74 mm by 105 mm.
331          */
332         public static final MediaSize
333             A7 = new MediaSize(74, 105, Size2DSyntax.MM, MediaSizeName.ISO_A7);
334         /**
335          * Specifies the ISO A8 size, 52 mm by 74 mm.
336          */
337         public static final MediaSize
338             A8 = new MediaSize(52, 74, Size2DSyntax.MM, MediaSizeName.ISO_A8);
339         /**
340          * Specifies the ISO A9 size, 37 mm by 52 mm.
341          */
342         public static final MediaSize
343             A9 = new MediaSize(37, 52, Size2DSyntax.MM, MediaSizeName.ISO_A9);
344         /**
345          * Specifies the ISO A10 size, 26 mm by 37 mm.
346          */
347         public static final MediaSize
348             A10 = new MediaSize(26, 37, Size2DSyntax.MM, MediaSizeName.ISO_A10);
349         /**
350          * Specifies the ISO B0 size, 1000 mm by 1414 mm.
351          */
352         public static final MediaSize
353             B0 = new MediaSize(1000, 1414, Size2DSyntax.MM, MediaSizeName.ISO_B0);
354         /**
355          * Specifies the ISO B1 size, 707 mm by 1000 mm.
356          */
357         public static final MediaSize
358             B1 = new MediaSize(707, 1000, Size2DSyntax.MM, MediaSizeName.ISO_B1);
359         /**
360          * Specifies the ISO B2 size, 500 mm by 707 mm.
361          */
362         public static final MediaSize
363             B2 = new MediaSize(500, 707, Size2DSyntax.MM, MediaSizeName.ISO_B2);
364         /**
365          * Specifies the ISO B3 size, 353 mm by 500 mm.
366          */
367         public static final MediaSize
368             B3 = new MediaSize(353, 500, Size2DSyntax.MM, MediaSizeName.ISO_B3);
369         /**
370          * Specifies the ISO B4 size, 250 mm by 353 mm.
371          */
372         public static final MediaSize
373             B4 = new MediaSize(250, 353, Size2DSyntax.MM, MediaSizeName.ISO_B4);
374         /**
375          * Specifies the ISO B5 size, 176 mm by 250 mm.
376          */
377         public static final MediaSize
378             B5 = new MediaSize(176, 250, Size2DSyntax.MM, MediaSizeName.ISO_B5);
379         /**
380          * Specifies the ISO B6 size, 125 mm by 176 mm.
381          */
382         public static final MediaSize
383             B6 = new MediaSize(125, 176, Size2DSyntax.MM, MediaSizeName.ISO_B6);
384         /**
385          * Specifies the ISO B7 size, 88 mm by 125 mm.
386          */
387         public static final MediaSize
388             B7 = new MediaSize(88, 125, Size2DSyntax.MM, MediaSizeName.ISO_B7);
389         /**
390          * Specifies the ISO B8 size, 62 mm by 88 mm.
391          */
392         public static final MediaSize
393             B8 = new MediaSize(62, 88, Size2DSyntax.MM, MediaSizeName.ISO_B8);
394         /**
395          * Specifies the ISO B9 size, 44 mm by 62 mm.
396          */
397         public static final MediaSize
398             B9 = new MediaSize(44, 62, Size2DSyntax.MM, MediaSizeName.ISO_B9);
399         /**
400          * Specifies the ISO B10 size, 31 mm by 44 mm.
401          */
402         public static final MediaSize
403             B10 = new MediaSize(31, 44, Size2DSyntax.MM, MediaSizeName.ISO_B10);
404         /**
405          * Specifies the ISO C3 size, 324 mm by 458 mm.
406          */
407         public static final MediaSize
408             C3 = new MediaSize(324, 458, Size2DSyntax.MM, MediaSizeName.ISO_C3);
409         /**
410          * Specifies the ISO C4 size, 229 mm by 324 mm.
411          */
412         public static final MediaSize
413             C4 = new MediaSize(229, 324, Size2DSyntax.MM, MediaSizeName.ISO_C4);
414         /**
415          * Specifies the ISO C5 size, 162 mm by 229 mm.
416          */
417         public static final MediaSize
418             C5 = new MediaSize(162, 229, Size2DSyntax.MM, MediaSizeName.ISO_C5);
419         /**
420          * Specifies the ISO C6 size, 114 mm by 162 mm.
421          */
422         public static final MediaSize
423             C6 = new MediaSize(114, 162, Size2DSyntax.MM, MediaSizeName.ISO_C6);
424         /**
425          * Specifies the ISO Designated Long size, 110 mm by 220 mm.
426          */
427         public static final MediaSize
428             DESIGNATED_LONG = new MediaSize(110, 220, Size2DSyntax.MM,
429                                             MediaSizeName.ISO_DESIGNATED_LONG);
430 
431         /**
432          * Hide all constructors.
433          */
434         private ISO() {
435         }
436     }
437 
438     /**
439      * Class MediaSize.JIS includes {@link MediaSize MediaSize} values for JIS
440      * (Japanese) media.      *
441      */
442     public final static class JIS {
443 
444         /**
445          * Specifies the JIS B0 size, 1030 mm by 1456 mm.
446          */
447         public static final MediaSize
448             B0 = new MediaSize(1030, 1456, Size2DSyntax.MM, MediaSizeName.JIS_B0);
449         /**
450          * Specifies the JIS B1 size, 728 mm by 1030 mm.
451          */
452         public static final MediaSize
453             B1 = new MediaSize(728, 1030, Size2DSyntax.MM, MediaSizeName.JIS_B1);
454         /**
455          * Specifies the JIS B2 size, 515 mm by 728 mm.
456          */
457         public static final MediaSize
458             B2 = new MediaSize(515, 728, Size2DSyntax.MM, MediaSizeName.JIS_B2);
459         /**
460          * Specifies the JIS B3 size, 364 mm by 515 mm.
461          */
462         public static final MediaSize
463             B3 = new MediaSize(364, 515, Size2DSyntax.MM, MediaSizeName.JIS_B3);
464         /**
465          * Specifies the JIS B4 size, 257 mm by 364 mm.
466          */
467         public static final MediaSize
468             B4 = new MediaSize(257, 364, Size2DSyntax.MM, MediaSizeName.JIS_B4);
469         /**
470          * Specifies the JIS B5 size, 182 mm by 257 mm.
471          */
472         public static final MediaSize
473             B5 = new MediaSize(182, 257, Size2DSyntax.MM, MediaSizeName.JIS_B5);
474         /**
475          * Specifies the JIS B6 size, 128 mm by 182 mm.
476          */
477         public static final MediaSize
478             B6 = new MediaSize(128, 182, Size2DSyntax.MM, MediaSizeName.JIS_B6);
479         /**
480          * Specifies the JIS B7 size, 91 mm by 128 mm.
481          */
482         public static final MediaSize
483             B7 = new MediaSize(91, 128, Size2DSyntax.MM, MediaSizeName.JIS_B7);
484         /**
485          * Specifies the JIS B8 size, 64 mm by 91 mm.
486          */
487         public static final MediaSize
488             B8 = new MediaSize(64, 91, Size2DSyntax.MM, MediaSizeName.JIS_B8);
489         /**
490          * Specifies the JIS B9 size, 45 mm by 64 mm.
491          */
492         public static final MediaSize
493             B9 = new MediaSize(45, 64, Size2DSyntax.MM, MediaSizeName.JIS_B9);
494         /**
495          * Specifies the JIS B10 size, 32 mm by 45 mm.
496          */
497         public static final MediaSize
498             B10 = new MediaSize(32, 45, Size2DSyntax.MM, MediaSizeName.JIS_B10);
499         /**
500          * Specifies the JIS Chou ("long") #1 envelope size, 142 mm by 332 mm.
501          */
502         public static final MediaSize CHOU_1 = new MediaSize(142, 332, Size2DSyntax.MM);
503         /**
504          * Specifies the JIS Chou ("long") #2 envelope size, 119 mm by 277 mm.
505          */
506         public static final MediaSize CHOU_2 = new MediaSize(119, 277, Size2DSyntax.MM);
507         /**
508          * Specifies the JIS Chou ("long") #3 envelope size, 120 mm by 235 mm.
509          */
510         public static final MediaSize CHOU_3 = new MediaSize(120, 235, Size2DSyntax.MM);
511         /**
512          * Specifies the JIS Chou ("long") #4 envelope size, 90 mm by 205 mm.
513          */
514         public static final MediaSize CHOU_4 = new MediaSize(90, 205, Size2DSyntax.MM);
515         /**
516          * Specifies the JIS Chou ("long") #30 envelope size, 92 mm by 235 mm.
517          */
518         public static final MediaSize CHOU_30 = new MediaSize(92, 235, Size2DSyntax.MM);
519         /**
520          * Specifies the JIS Chou ("long") #40 envelope size, 90 mm by 225 mm.
521          */
522         public static final MediaSize CHOU_40 = new MediaSize(90, 225, Size2DSyntax.MM);
523         /**
524          * Specifies the JIS Kaku ("square") #0 envelope size, 287 mm by 382 mm.
525          */
526         public static final MediaSize KAKU_0 = new MediaSize(287, 382, Size2DSyntax.MM);
527         /**
528          * Specifies the JIS Kaku ("square") #1 envelope size, 270 mm by 382 mm.
529          */
530         public static final MediaSize KAKU_1 = new MediaSize(270, 382, Size2DSyntax.MM);
531         /**
532          * Specifies the JIS Kaku ("square") #2 envelope size, 240 mm by 332 mm.
533          */
534         public static final MediaSize KAKU_2 = new MediaSize(240, 332, Size2DSyntax.MM);
535         /**
536          * Specifies the JIS Kaku ("square") #3 envelope size, 216 mm by 277 mm.
537          */
538         public static final MediaSize KAKU_3 = new MediaSize(216, 277, Size2DSyntax.MM);
539         /**
540          * Specifies the JIS Kaku ("square") #4 envelope size, 197 mm by 267 mm.
541          */
542         public static final MediaSize KAKU_4 = new MediaSize(197, 267, Size2DSyntax.MM);
543         /**
544          * Specifies the JIS Kaku ("square") #5 envelope size, 190 mm by 240 mm.
545          */
546         public static final MediaSize KAKU_5 = new MediaSize(190, 240, Size2DSyntax.MM);
547         /**
548          * Specifies the JIS Kaku ("square") #6 envelope size, 162 mm by 229 mm.
549          */
550         public static final MediaSize KAKU_6 = new MediaSize(162, 229, Size2DSyntax.MM);
551         /**
552          * Specifies the JIS Kaku ("square") #7 envelope size, 142 mm by 205 mm.
553          */
554         public static final MediaSize KAKU_7 = new MediaSize(142, 205, Size2DSyntax.MM);
555         /**
556          * Specifies the JIS Kaku ("square") #8 envelope size, 119 mm by 197 mm.
557          */
558         public static final MediaSize KAKU_8 = new MediaSize(119, 197, Size2DSyntax.MM);
559         /**
560          * Specifies the JIS Kaku ("square") #20 envelope size, 229 mm by 324 mm.
561          */
562         public static final MediaSize KAKU_20 = new MediaSize(229, 324, Size2DSyntax.MM);
563         /**
564          * Specifies the JIS Kaku ("square") A4 envelope size, 228 mm by 312 mm.
565          */
566         public static final MediaSize KAKU_A4 = new MediaSize(228, 312, Size2DSyntax.MM);
567         /**
568          * Specifies the JIS You ("Western") #1 envelope size, 120 mm by 176 mm.
569          */
570         public static final MediaSize YOU_1 = new MediaSize(120, 176, Size2DSyntax.MM);
571         /**
572          * Specifies the JIS You ("Western") #2 envelope size, 114 mm by 162 mm.
573          */
574         public static final MediaSize YOU_2 = new MediaSize(114, 162, Size2DSyntax.MM);
575         /**
576          * Specifies the JIS You ("Western") #3 envelope size, 98 mm by 148 mm.
577          */
578         public static final MediaSize YOU_3 = new MediaSize(98, 148, Size2DSyntax.MM);
579         /**
580          * Specifies the JIS You ("Western") #4 envelope size, 105 mm by 235 mm.
581          */
582         public static final MediaSize YOU_4 = new MediaSize(105, 235, Size2DSyntax.MM);
583         /**
584          * Specifies the JIS You ("Western") #5 envelope size, 95 mm by 217 mm.
585          */
586         public static final MediaSize YOU_5 = new MediaSize(95, 217, Size2DSyntax.MM);
587         /**
588          * Specifies the JIS You ("Western") #6 envelope size, 98 mm by 190 mm.
589          */
590         public static final MediaSize YOU_6 = new MediaSize(98, 190, Size2DSyntax.MM);
591         /**
592          * Specifies the JIS You ("Western") #7 envelope size, 92 mm by 165 mm.
593          */
594         public static final MediaSize YOU_7 = new MediaSize(92, 165, Size2DSyntax.MM);
595         /**
596          * Hide all constructors.
597          */
598         private JIS() {
599         }
600     }
601 
602     /**
603      * Class MediaSize.NA includes {@link MediaSize MediaSize} values for North
604      * American media.
605      */
606     public final static class NA {
607 
608         /**
609          * Specifies the North American letter size, 8.5 inches by 11 inches.
610          */
611         public static final MediaSize
612             LETTER = new MediaSize(8.5f, 11.0f, Size2DSyntax.INCH,
613                                                 MediaSizeName.NA_LETTER);
614         /**
615          * Specifies the North American legal size, 8.5 inches by 14 inches.
616          */
617         public static final MediaSize
618             LEGAL = new MediaSize(8.5f, 14.0f, Size2DSyntax.INCH,
619                                                MediaSizeName.NA_LEGAL);
620         /**
621          * Specifies the North American 5 inch by 7 inch paper.
622          */
623         public static final MediaSize
624             NA_5X7 = new MediaSize(5, 7, Size2DSyntax.INCH,
625                                    MediaSizeName.NA_5X7);
626         /**
627          * Specifies the North American 8 inch by 10 inch paper.
628          */
629         public static final MediaSize
630             NA_8X10 = new MediaSize(8, 10, Size2DSyntax.INCH,
631                                    MediaSizeName.NA_8X10);
632         /**
633          * Specifies the North American Number 9 business envelope size,
634          * 3.875 inches by 8.875 inches.
635          */
636         public static final MediaSize
637             NA_NUMBER_9_ENVELOPE =
638             new MediaSize(3.875f, 8.875f, Size2DSyntax.INCH,
639                           MediaSizeName.NA_NUMBER_9_ENVELOPE);
640         /**
641          * Specifies the North American Number 10 business envelope size,
642          * 4.125 inches by 9.5 inches.
643          */
644         public static final MediaSize
645             NA_NUMBER_10_ENVELOPE =
646             new MediaSize(4.125f, 9.5f, Size2DSyntax.INCH,
647                           MediaSizeName.NA_NUMBER_10_ENVELOPE);
648         /**
649          * Specifies the North American Number 11 business envelope size,
650          * 4.5 inches by 10.375 inches.
651          */
652         public static final MediaSize
653             NA_NUMBER_11_ENVELOPE =
654             new MediaSize(4.5f, 10.375f, Size2DSyntax.INCH,
655                           MediaSizeName.NA_NUMBER_11_ENVELOPE);
656         /**
657          * Specifies the North American Number 12 business envelope size,
658          * 4.75 inches by 11 inches.
659          */
660         public static final MediaSize
661             NA_NUMBER_12_ENVELOPE =
662             new MediaSize(4.75f, 11.0f, Size2DSyntax.INCH,
663                           MediaSizeName.NA_NUMBER_12_ENVELOPE);
664         /**
665          * Specifies the North American Number 14 business envelope size,
666          * 5 inches by 11.5 inches.
667          */
668         public static final MediaSize
669             NA_NUMBER_14_ENVELOPE =
670             new MediaSize(5.0f, 11.5f, Size2DSyntax.INCH,
671                           MediaSizeName.NA_NUMBER_14_ENVELOPE);
672 
673         /**
674          * Specifies the North American 6 inch by 9 inch envelope size.
675          */
676         public static final MediaSize
677             NA_6X9_ENVELOPE = new MediaSize(6.0f, 9.0f, Size2DSyntax.INCH,
678                                             MediaSizeName.NA_6X9_ENVELOPE);
679         /**
680          * Specifies the North American 7 inch by 9 inch envelope size.
681          */
682         public static final MediaSize
683             NA_7X9_ENVELOPE = new MediaSize(7.0f, 9.0f, Size2DSyntax.INCH,
684                                             MediaSizeName.NA_7X9_ENVELOPE);
685         /**
686          * Specifies the North American 9 inch by 11 inch envelope size.
687          */
688         public static final MediaSize
689             NA_9x11_ENVELOPE = new MediaSize(9.0f, 11.0f, Size2DSyntax.INCH,
690                                              MediaSizeName.NA_9X11_ENVELOPE);
691         /**
692          * Specifies the North American 9 inch by 12 inch envelope size.
693          */
694         public static final MediaSize
695             NA_9x12_ENVELOPE = new MediaSize(9.0f, 12.0f, Size2DSyntax.INCH,
696                                              MediaSizeName.NA_9X12_ENVELOPE);
697         /**
698          * Specifies the North American 10 inch by 13 inch envelope size.
699          */
700         public static final MediaSize
701             NA_10x13_ENVELOPE = new MediaSize(10.0f, 13.0f, Size2DSyntax.INCH,
702                                               MediaSizeName.NA_10X13_ENVELOPE);
703         /**
704          * Specifies the North American 10 inch by 14 inch envelope size.
705          */
706         public static final MediaSize
707             NA_10x14_ENVELOPE = new MediaSize(10.0f, 14.0f, Size2DSyntax.INCH,
708                                               MediaSizeName.NA_10X14_ENVELOPE);
709         /**
710          * Specifies the North American 10 inch by 15 inch envelope size.
711          */
712         public static final MediaSize
713             NA_10X15_ENVELOPE = new MediaSize(10.0f, 15.0f, Size2DSyntax.INCH,
714                                               MediaSizeName.NA_10X15_ENVELOPE);
715         /**
716          * Hide all constructors.
717          */
718         private NA() {
719         }
720     }
721 
722     /**
723      * Class MediaSize.Engineering includes {@link MediaSize MediaSize} values
724      * for engineering media.
725      */
726     public final static class Engineering {
727 
728         /**
729          * Specifies the engineering A size, 8.5 inch by 11 inch.
730          */
731         public static final MediaSize
732             A = new MediaSize(8.5f, 11.0f, Size2DSyntax.INCH,
733                               MediaSizeName.A);
734         /**
735          * Specifies the engineering B size, 11 inch by 17 inch.
736          */
737         public static final MediaSize
738             B = new MediaSize(11.0f, 17.0f, Size2DSyntax.INCH,
739                               MediaSizeName.B);
740         /**
741          * Specifies the engineering C size, 17 inch by 22 inch.
742          */
743         public static final MediaSize
744             C = new MediaSize(17.0f, 22.0f, Size2DSyntax.INCH,
745                               MediaSizeName.C);
746         /**
747          * Specifies the engineering D size, 22 inch by 34 inch.
748          */
749         public static final MediaSize
750             D = new MediaSize(22.0f, 34.0f, Size2DSyntax.INCH,
751                               MediaSizeName.D);
752         /**
753          * Specifies the engineering E size, 34 inch by 44 inch.
754          */
755         public static final MediaSize
756             E = new MediaSize(34.0f, 44.0f, Size2DSyntax.INCH,
757                               MediaSizeName.E);
758         /**
759          * Hide all constructors.
760          */
761         private Engineering() {
762         }
763     }
764 
765     /**
766      * Class MediaSize.Other includes {@link MediaSize MediaSize} values for
767      * miscellaneous media.
768      */
769     public final static class Other {
770         /**
771          * Specifies the executive size, 7.25 inches by 10.5 inches.
772          */
773         public static final MediaSize
774             EXECUTIVE = new MediaSize(7.25f, 10.5f, Size2DSyntax.INCH,
775                                       MediaSizeName.EXECUTIVE);
776         /**
777          * Specifies the ledger size, 11 inches by 17 inches.
778          */
779         public static final MediaSize
780             LEDGER = new MediaSize(11.0f, 17.0f, Size2DSyntax.INCH,
781                                    MediaSizeName.LEDGER);
782 
783         /**
784          * Specifies the tabloid size, 11 inches by 17 inches.
785          * @since 1.5
786          */
787         public static final MediaSize
788             TABLOID = new MediaSize(11.0f, 17.0f, Size2DSyntax.INCH,
789                                    MediaSizeName.TABLOID);
790 
791         /**
792          * Specifies the invoice size, 5.5 inches by 8.5 inches.
793          */
794         public static final MediaSize
795             INVOICE = new MediaSize(5.5f, 8.5f, Size2DSyntax.INCH,
796                               MediaSizeName.INVOICE);
797         /**
798          * Specifies the folio size, 8.5 inches by 13 inches.
799          */
800         public static final MediaSize
801             FOLIO = new MediaSize(8.5f, 13.0f, Size2DSyntax.INCH,
802                                   MediaSizeName.FOLIO);
803         /**
804          * Specifies the quarto size, 8.5 inches by 10.83 inches.
805          */
806         public static final MediaSize
807             QUARTO = new MediaSize(8.5f, 10.83f, Size2DSyntax.INCH,
808                                    MediaSizeName.QUARTO);
809         /**
810          * Specifies the Italy envelope size, 110 mm by 230 mm.
811          */
812         public static final MediaSize
813         ITALY_ENVELOPE = new MediaSize(110, 230, Size2DSyntax.MM,
814                                        MediaSizeName.ITALY_ENVELOPE);
815         /**
816          * Specifies the Monarch envelope size, 3.87 inch by 7.5 inch.
817          */
818         public static final MediaSize
819         MONARCH_ENVELOPE = new MediaSize(3.87f, 7.5f, Size2DSyntax.INCH,
820                                          MediaSizeName.MONARCH_ENVELOPE);
821         /**
822          * Specifies the Personal envelope size, 3.625 inch by 6.5 inch.
823          */
824         public static final MediaSize
825         PERSONAL_ENVELOPE = new MediaSize(3.625f, 6.5f, Size2DSyntax.INCH,
826                                          MediaSizeName.PERSONAL_ENVELOPE);
827         /**
828          * Specifies the Japanese postcard size, 100 mm by 148 mm.
829          */
830         public static final MediaSize
831             JAPANESE_POSTCARD = new MediaSize(100, 148, Size2DSyntax.MM,
832                                               MediaSizeName.JAPANESE_POSTCARD);
833         /**
834          * Specifies the Japanese Double postcard size, 148 mm by 200 mm.
835          */
836         public static final MediaSize
837             JAPANESE_DOUBLE_POSTCARD = new MediaSize(148, 200, Size2DSyntax.MM,
838                                      MediaSizeName.JAPANESE_DOUBLE_POSTCARD);
839         /**
840          * Hide all constructors.
841          */
842         private Other() {
843         }
844     }
845 
846     /* force loading of all the subclasses so that the instances
847      * are created and inserted into the hashmap.
848      */
849     static {
850         MediaSize ISOA4 = ISO.A4;
851         MediaSize JISB5 = JIS.B5;
852         MediaSize NALETTER = NA.LETTER;
853         MediaSize EngineeringC = Engineering.C;
854         MediaSize OtherEXECUTIVE = Other.EXECUTIVE;
855     }
856 }