Command/setuppapersize

From Wiki
< Command
Revision as of 19:47, 13 May 2023 by Hraban (talk | contribs) (fix source links)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

\setuppapersize

Syntax (autogenerated)

\setuppapersize[...,...][...,...]
[...,...]reset landscape mirrored negative rotated 90 180 270 name
[...,...]reset landscape mirrored negative rotated 90 180 270 name


\setuppapersize[...][...=...,...]
[...]name
topcommand
bottomcommand
leftcommand
rightcommand
methodnormal none name
scalenumber
nxnumber
nynumber
dxdimension
dydimension
widthdimension
heightdimension
topspacedimension
backspacedimension
offsetdimension
pagereset landscape mirrored negative rotated 90 180 270 name
paperreset landscape mirrored negative rotated 90 180 270 name
optionfit max
distancedimension


Description

The first argument of \setuppapersize is the dimension a page will have. The second argument is the size of the paper the pages will be printed on; see \setuparranging for placing multiple pages on a sheet. If the second argument is omitted, the paper size is assumed to equal the page size.

For example:

\setuppapersize[letter,landscape][letter,landscape,oversized]

sets the size of the pages to letter size (landscape), and the size of the paper (before cutting) to oversized letter size, which has edges that are 1.5 cm longer. letter is a pre-defined papersize; one can define one's own papersizes using \definepapersize.

There are several options one can use to modify a predefined paper size:

  • portrait: the default paper sizes are 'standing up', taller than they are wide.
  • landscape: turn the paper 90 degrees so it is lying down
  • samesized: same size as the first argument
  • oversized: adds 1.5 cm to each edge
  • undersized: subtracts 1.5 cm from each edge
  • doublesized: doubles the width
  • doubleoversized: doubles the width and adds 1.5 cm to each edge

There are quite a few pre-defined paper sizes:

Size Remarks
letter, ledger, tabloid, legal, folio, executive Sizes from the North American paper standard.
A0A10, B0B10, C0C10 From the A, B, and C series of the ISO-216 standard.
RA0RA4, SRA0SRA4 From the RA and SRA series of ISO-217 paper standard.
C6/C5, DL, E4 From the ISO-269 standard envelope sizes.
envelope 9envelope 14 Sizes from the American postal standard.
G5 and E5 From the Swedish SIS-014711 standard. These are used for Swedish theses.
CD (12x12cm) for CD covers.
S3S6, S8, SM, SW For screen sizes. These sizes are useful for presentations. S3S6 and S8 have an aspect ratio of 4:3. S3 is 300pt wide, S4 is 400pt wide, and so on. S6 is almost as wide as a A4 paper. SM and SW are for medium and wide screens; they have the same height as S6.

page-lay.mkiv/page-lay.mkxl

A few more paper sizes, which are not mention here. (Scroll down to the end.)

Example

% Create a paper that can accomodate 2x4 squares of 52x52mm
% (A9 is 37x52mm, and we're placing it both portrait and landscape)
\definepapersize[sheet][width=104mm,height=156mm]

% We want 2x3 pages on a sheet. \setuppaper must come *before* \setuparranging!
\setuppaper[nx=2, ny=3, dx=0mm, dy=0mm]
\setuparranging[XY]

% Define two papersizes in terms of A9 and sheet
\definepapersize[standing][A9]          [sheet]
\definepapersize[lying]   [A9,landscape][sheet]

% Show the pages.
\showframe

\starttext
  \setuppapersize[standing]
  Page 1: standing pages from here on. \page
  Page 2. \page
  \setuppapersize[lying]
  Page 3: lying pages from here on. \page
  Page 4. \page
  \adaptpapersize[standing]
  Page 5: adapted to standing \page
  Page 6: automatically back to lying \page
\stoptext


See also

Help from ConTeXt-Mailinglist/Forum

All issues with: