.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "PDF::Builder::Resource::PaperSizes 3pm"
.TH PDF::Builder::Resource::PaperSizes 3pm "2023-12-15" "perl v5.36.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
PDF::Builder::Resource::PaperSizes \- list of standard paper sizes and their dimensions
.SS "Information and Usage"
.IX Subsection "Information and Usage"
This is a list of standard page (media) sizes by \fIname\fR (e.g., 'A4' or 
\&'Legal'), given by width and height in Big Points (72 per inch). See the code 
in PaperSizes.pm for the actual entries. You do \fBnot\fR have to use these names; 
they are merely provided as convenient shortcuts. You can always specify the 
desired dimensions (in points) yourself.
.PP
The \s-1PDF\s0 specification (and \s-1PDF\s0 readers) default to \s-1US\s0 Letter size (portrait
orientation, 8.5 inches wide by 11 inches high). If you want to use anything
else, you will have to make a \f(CW\*(C`mediabox()\*(C'\fR call to specify the media (paper)
size. For named sizes, capitalization doesn't matter (all entries are folded 
to lower case, so 'A4' and 'a4' work the same).
.PP
Different sources give somewhat different paper dimensions, especially for
archaic or unusual sizes, so take care and measure your actual paper before
printing, so you can avoid wasting paper and time printing to the wrong 
mediabox! Also keep in mind that many printers cannot print all the way to the
edge (don't want to get ink or toner on the paper rollers), so set your margins
accordingly.
.SS "Available named media sizes, and size"
.IX Subsection "Available named media sizes, and size"
You can certainly edit this module to add more named sizes, if you wish to.
Or, you can directly give the desired size in Points, in a \*(L"box\*(R" method.
.PP
\&\fB\s-1CAUTION:\s0\fR Before using one of the larger sizes, check if your \s-1PDF\s0 reader
and/or printer will be able to handle it. The official \s-1PDF\s0 definition only 
allows up to 200 inches square (14400 Points square), requiring the use of 
User Units to handle larger media. Many non-Adobe systems ignore this 
limitation and support much larger sizes, but you should check before doing a 
lot of work!
.PP
\fIMetric sizes\fR
.IX Subsection "Metric sizes"
.PP
.Vb 1
\&      4a0 \-\-  4760 x 6716 (1679 mm x 2639 mm)
\&
\&      2a0 \-\-  3368 x 4760 (1188 mm x 1679 mm)
\&
\&      a0 \-\-   2380 x 3368 (840 mm x 1188 mm)
\&
\&      a1 \-\-   1684 x 2380 (594 mm x 840 mm)
\&
\&      a2 \-\-   1190 x 1684 (420 mm x 594 mm)
\&
\&      a3 \-\-   842 x 1190 (297 mm x 420 mm)
\&
\&      a4 \-\-   595 x 842 (210 mm x 297 mm)
\&
\&      a5 \-\-   421 x 595 (149 mm x 210 mm)
\&
\&      a6 \-\-   297 x 421 (105 mm x 149 mm)
\&
\&      a7 \-\-   210 x 297 (74 mm x 105 mm)
\&
\&      a8 \-\-   147 x 210 (52 mm x 74 mm)
\&
\&      a9 \-\-   105 x 147 (37 mm x 52 mm)
\&
\&      a10 \-\-  74 x 105 (26 mm x 37 mm)
\&
\&      4b0 \-\-  5656 x 8000 (1995 mm x 2822 mm)
\&
\&      2b0 \-\-  4000 x 5656 (1411 mm x 1995 mm)
\&
\&      b0 \-\-   2828 x 4000 (998 mm x 1411 mm)
\&
\&      b1 \-\-   2000 x 2828 (706 mm x 998 mm)
\&
\&      b2 \-\-   1414 x 2000 (499 mm x 706 mm)
\&
\&      b3 \-\-   1000 x 1414 (353 mm x 499 mm)
\&
\&      b4 \-\-   707 x 1000 (249 mm x 353 mm)
\&
\&      b5 \-\-   500 x 707 (176 mm x 249 mm)
\&
\&      b6 \-\-   353 x 500 (125 mm x 176 mm)
\&
\&      b7 \-\-   250 x 353 (88 mm x 125 mm)
\&
\&      b8 \-\-   176 x 250 (62 mm x 88 mm)
\&
\&      b9 \-\-   125 x 176 (44 mm x 62 mm)
\&
\&      b10 \-\-  88 x 125 (31 mm x 44 mm)
\&
\&      c0 \-\-   2600 x 3677 (917 mm x 1297 mm)  Envelope sizes
\&
\&      c1 \-\-   1837 x 2600 (648 mm x 917 mm)
\&
\&      c2 \-\-   1298 x 1837 (458 mm x 648 mm)
\&
\&      c3 \-\-   918 x 1298 (324 mm x 458 mm)
\&
\&      c4 \-\-   649 x 918 (229 mm x 324 mm)
\&
\&      c5 \-\-   459 x 649 (162 mm x 229 mm)
\&
\&      c6 \-\-   323 x 459 (114 mm x 162 mm)
\&
\&      c7 \-\-   230 x 323 (81 mm x 114 mm)
\&
\&      c8 \-\-   162 x 230 (57 mm x 81 mm)
\&
\&      c9 \-\-   113 x 162 (40 mm x 57 mm)
\&
\&      c10 \-\-  79 x 113 (28 mm x 40 mm)
\&
\&      jis\-b5 \-\-  516 x 729 (182 mm x 257 mm)
\&
\&      folio \-\-   595 x 935 (210 mm x 330 mm)
\&
\&      chinese\-16k \-\-  524 x 737 (185 mm x 260 mm)
\&
\&      chinese\-32k \-\-  369 x 524 (130 mm x 185 mm)
\&
\&      16k \-\-  553 x 765 (195 mm x 270 mm)
\&
\&      jp\-postcard \-\-  283 x 420 (100 mm x 148 mm)
\&
\&      dbl\-postcard \-\-  420 x 567 (148 mm x 200 mm)
\&
\&      env\-c5 \-\-  459 x 649 (162 mm x 229 mm)
\&
\&      env\-dl \-\-  312 x 624 (110 mm x 220 mm)
\&
\&      env\-c6 \-\-  323 x 459 (114 mm x 162 mm)
\&
\&      env\-cho\-3 \-\-  340 x 666 (120 mm x 235 mm)
\&
\&      env\-cho\-4 \-\-  255 x 581 (90 mm x 205 mm)
\&
\&      p1 \-\-  1587 x 2438 (560 mm x 860 mm)  Canadian correspondence
\&
\&      p2 \-\-  1219 x 1587 (430 mm x 560 mm) 
\&
\&      p3 \-\-  794 x 1219 (280 mm x 430 mm)
\&
\&      p4 \-\-  609 x 794 (215 mm x 280 mm)
\&
\&      p5 \-\-  397 x 609 (140 mm x 215 mm)
\&
\&      p6 \-\-  303 x 397 (107 mm x 140 mm)
.Ve
.PP
\fIMixed sizes\fR
.IX Subsection "Mixed sizes"
.PP
.Vb 1
\&      universal \-\-  595 x 792 (210 mm x 11 in)
.Ve
.PP
This is not a standard or official size, but a PDF::Builder size, which should 
print \s-1OK\s0 on either A4 or \s-1US\s0 Letter paper size. It is narrow (like A4) and short 
(like letter). Your content will be in the lower left of the paper, when
printed, with extra top margin on A4 or extra right margin on Letter.
.PP
\fIUS/British (non-metric) sizes\fR
.IX Subsection "US/British (non-metric) sizes"
.PP
.Vb 1
\&      broadsheet \-\-  1296 x 1584 (18 in x 22 in) sometimes 1224 x 1584!
\&
\&      executive \-\-  522 x 756 (7.25 in x 10.5 in)
\&
\&      foolscap \-\-  576 x 936 (8 in x 13 in) sometimes 360 x 486!
\&
\&      gov\-legal \-\-  612 x 936 (8.5 in x 13 in)
\&
\&      gov\-letter \-\-  576 x 756 (8 in x 10.5 in)
\&
\&      jr\-legal \-\-  360 x 576 (5 in x 8 in)
\&
\&      ledger \-\-  1224 x 792 (17 in x 11 in)
\&
\&      legal \-\-  612 x 1008 (8.5 in x 14 in)
\&
\&      letter \-\-  612 x 792 (8.5 in x 11 in)
\&
\&      letter\-plus \-\-  612 x 914 (8.5 in x 12.7 in)
\&
\&      quarto \-\-  576 x 720 (8 in x 10 in)
\&
\&      student \-\-  396 x 612 (5.5 in x 8.5 in) a.k.a. statement, half\-letter
\&
\&      tabloid \-\-  792 x 1224 (11 in x 17 in) ledger rotated (portrait mode)
\&
\&      36x36 \-\-  2592 x 2592 (36 in x 36 in)
\&
\&      dbill \-\-  216 x 504 (3 in x 7 in)
\&
\&      old\-paper \-\-  648 x 864 (9 in x 12 in)
\&
\&      env\-10 \-\-  297 x 684 (4.125 in x 9.5 in)
\&
\&      env\-monarch \-\-  279 x 540 (3.875 in x 7.5 in)
\&
\&      a \-\-  612 x 791 (8.5 in x 11 in) ANSI technical drawing paper
\&
\&      b \-\-  791 x 1225 (11 in x 17 in)
\&
\&      c \-\-  1225 x 1585 (17 in x 22 in)
\&
\&      d \-\-  1585 x 2449 (22 in x 34 in)
\&
\&      e \-\-  2449 x 3169 (34 in x 44 in)
\&
\&      f \-\-  2016 x 2880 (28 in x 40 in)
\&
\&      b\-plus \-\-  936 x 1368 (13 in x 19 in)  a.k.a. super\-B, A3+, super\-A3
\&
\&      arch\-a \-\-  648 x 864 (9 in x 12 in)
\&
\&      arch\-b \-\-  864 x 1296 (12 in x 18 in)
\&
\&      arch\-c \-\-  1296 x 1728 (18 in x 24 in)
\&
\&      arch\-d \-\-  1728 x 2592 (24 in x 36 in)
\&
\&      arch\-e \-\-  2592 x 3456 (36 in x 48 in)
\&
\&      arch\-e1 \-\-  2160 x 3024 (30 in x 42 in)
\&
\&      pott \-\-  288 x 450 (3.9 in x 6.25 in)  British sizes
\&
\&      post \-\-  360 x 576 (5 in x 8 in)
\&
\&      large\-post \-\-  378 x 594 (5.25 in x 8.25 in)
\&
\&      crown \-\-  360 x 540 (5 in x 7.5 in)
\&
\&      large\-crown \-\-  378 x 576 (5.25 in x 8 in)
\&
\&      demy \-\-  409 x 630 (5.68 in x 8.75 in)
\&
\&      small\-demy \-\-  409 x 612 (5.68 in x 8.5 in)
\&
\&      medium \-\-  414 x 648 (5.75 in x 9 in)
\&
\&      royal \-\-  450 x 720 (6.25 in x 10 in)
\&
\&      small\-royal \-\-  445 x 666 (6.18 in x 9.25 in)
\&
\&      super\-royal \-\-  486 x 738 (6.75 in x 10.25 in)
\&
\&      imperial \-\-  540 x 792 (7.5 in x 11 in)
.Ve