Difference between revisions of "Command/setupclipping"

From ConTeXt wiki
 
Line 4: Line 4:
 
}}
 
}}
  
== [[Help:Reference|Syntax]] (autogenerated)] ==
+
== [[Help:Reference|Syntax]] (autogenerated) ==
 
<syntax>setupclipping</syntax>
 
<syntax>setupclipping</syntax>
 
== [[Help:Reference|Syntax]] ==
 
== [[Help:Reference|Syntax]] ==

Latest revision as of 14:43, 15 October 2019

\setupclipping

Syntax (autogenerated)

\setupclipping[...=...,...]
statestart stop
widthdimension
heightdimension
hoffsetdimension
voffsetdimension
xnumber
ynumber
nxnumber
nynumber
sxnumber
synumber
leftoffsetdimension
rightoffsetdimension
topoffsetdimension
bottomoffsetdimension
mpname
nnumber
offsetdimension


Syntax

\setupclipping[...,...=...,...]
nx number
ny number
x number
y number
width dimension
height dimension
hoffset dimension
voffset dimension
mp name

Description

Specify the default clipping settings. There are three methods:

A) Tiles, where

  • nx, ny specify to cut the contents into nx horizontal (ny vertical) pieces of equal size, and
  • x, y choose the piece at x (, y).

B) size/offset, where

  • width, height specify the horizontal (vertical) size of the clipping window, and
  • hoffset, voffset: window shift

C) metapost path

  • mp:

Example

To clip, from page 3 of a PDF, a piece of 60x25, 25 mm from the left edge of the paper and 18+25 mm from the top (assuming A4 paper):

\clip
   [width=60mm,
    height=25mm,
    hoffset=25mm,
    voffset=\dimexpr 297mm-18mm-25mm\relax]
   {\externalfigure[file.pdf][page=3]}%

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: