Command/setupclipping

From Wiki
Jump to navigation Jump to search

\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: (see example below)

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]}%

To clip a picture to a circle (from the MetaFun manual):

\startMPclip{circleclip}
     clip currentpicture to fullcircle shifted (.5,.5)
       xscaled \width yscaled \height ;
\stopMPclip

\clip[nx=1,ny=1,mp=circleclip]{\externalfigure[hacker.png]}

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: