Command/setupclipping

\setupclipping

Syntax (autogenerated)

\setupclipping[...=...,...]
state	start stop
width	dimension
height	dimension
hoffset	dimension
voffset	dimension
x	number
y	number
nx	number
ny	number
sx	number
sy	number
leftoffset	dimension
rightoffset	dimension
topoffset	dimension
bottomoffset	dimension
mp	name
n	number
offset	dimension

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

• \clip

Help from ConTeXt-Mailinglist/Forum

All issues with:

• setupclipping on the mailing list (all results)
• setupclipping on the mailing list (subject only)
• setupclipping on stack exchange
• setupclipping in ConTeXt's source