1 /*
2 * Copyright (c) 2000, 2006, 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 & 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</CODE> < 0 or <CODE>y</CODE>
75 * < 0 or <CODE>units</CODE> < 1 or <CODE>x</CODE> > <CODE>y</CODE>.
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</CODE> < 0 or <CODE>y</CODE>
96 * < 0 or <CODE>units</CODE> < 1 or <CODE>x</CODE> > <CODE>y</CODE>.
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</CODE> < 0 or <CODE>y</CODE>
119 * < 0 or <CODE>units</CODE> < 1 or <CODE>x</CODE> > <CODE>y</CODE>.
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</CODE> < 0 or <CODE>y</CODE>
145 * < 0 or <CODE>units</CODE> < 1 or <CODE>x</CODE> > <CODE>y</CODE>.
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 x <= 0, y <= 0, or units < 1
198 *
199 */
200 public static MediaSizeName findMedia(float x, float y, int units) {
201
202 MediaSize match = MediaSize.ISO.A4;
203
204 if (x <= 0.0f || y <= 0.0f || units < 1) {
205 throw new IllegalArgumentException("args must be +ve values");
206 }
207
208 double ls = x * x + y * y;
209 double tmp_ls;
210 float []dim;
211 float diffx = x;
212 float diffy = y;
213
214 for (int i=0; i < sizeVector.size() ; i++) {
215 MediaSize mediaSize = (MediaSize)sizeVector.elementAt(i);
216 dim = mediaSize.getSize(units);
217 if (x == dim[0] && y == dim[1]) {
218 match = mediaSize;
219 break;
220 } else {
221 diffx = x - dim[0];
222 diffy = y - dim[1];
223 tmp_ls = diffx * diffx + diffy * diffy;
224 if (tmp_ls < ls) {
225 ls = tmp_ls;
226 match = mediaSize;
227 }
228 }
229 }
230
231 return match.getMediaSizeName();
232 }
233
234 /**
235 * Returns whether this media size attribute is equivalent to the passed
236 * in object.
237 * To be equivalent, all of the following conditions must be true:
238 * <OL TYPE=1>
239 * <LI>
240 * <CODE>object</CODE> is not null.
241 * <LI>
242 * <CODE>object</CODE> is an instance of class MediaSize.
243 * <LI>
244 * This media size attribute's X dimension is equal to
245 * <CODE>object</CODE>'s X dimension.
246 * <LI>
247 * This media size attribute's Y dimension is equal to
248 * <CODE>object</CODE>'s Y dimension.
249 * </OL>
250 *
251 * @param object Object to compare to.
252 *
253 * @return True if <CODE>object</CODE> is equivalent to this media size
254 * attribute, false otherwise.
255 */
256 public boolean equals(Object object) {
257 return (super.equals(object) && object instanceof MediaSize);
258 }
259
260 /**
261 * Get the printing attribute class which is to be used as the "category"
262 * for this printing attribute value.
263 * <P>
264 * For class MediaSize and any vendor-defined subclasses, the category is
265 * class MediaSize itself.
266 *
267 * @return Printing attribute class (category), an instance of class
268 * {@link java.lang.Class java.lang.Class}.
269 */
270 public final Class<? extends Attribute> getCategory() {
271 return MediaSize.class;
272 }
273
274 /**
275 * Get the name of the category of which this attribute value is an
276 * instance.
277 * <P>
278 * For class MediaSize and any vendor-defined subclasses, the category
279 * name is <CODE>"media-size"</CODE>.
280 *
281 * @return Attribute category name.
282 */
283 public final String getName() {
284 return "media-size";
285 }
286
287 /**
288 * Class MediaSize.ISO includes {@link MediaSize MediaSize} values for ISO
289 * media.
290 * <P>
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 }