Command/setuplayer

\setuplayer

Summary

The command \setuplayer is used to set the options for a layer.

Settings

\setuplayer[...,...][...=...,...]
[...,...]	name
state	start stop continue next repeat
option	test
page	number
width	dimension
height	dimension
region	name
rotation	left right inner outer number
position	yes no overlay
hoffset	max dimension
voffset	max dimension
offset	dimension
dx	dimension
dy	dimension
sx	number
sy	number
x	dimension
y	dimension
corner	left middle right top bottom
location	grid left middle right top bottom line l c r m t b g
line	number
column	number
direction	normal reverse
doublesided	yes no
method	fit overlay
repeat	yes
preset	lefttop righttop leftbottom rightbottom middle middletop middlebottom middleleft middleright lefttopleft lefttopright name

Option	Explanation
Name of the layer
state	start layer is visible stop layer is invisible continue layer is visible on all pages except the first next layer is visible only on the following page repeat layer gets repeated on every page
option	only in \definelayer test draw a frame around the layer’s contents
page	layer is shown only on this page (makes more sense for \setlayer)
width	width of the layer (doesn’t limit elements)
height	height of the layer (doesn’t limit elements)
region	placement relates to this named region (unclear, plase add a working example if you know)
position	yes you can place a layer within running text and ConTeXt leaves a gap in the paragraph where it places the layer content afterwards
hoffset	horizontal offset from reference point (use in \setlayer with presets)
voffset	vertical offset from reference point (use in \setlayer with presets)
dx	horizontal offset (use in \setlayer)
dy	vertical offset (use in \setlayer)
sx	horizontal scaling(?)
sy	vertical scaling(?)
x	horizontal position from left edge of paper
y	vertical position from top edge of paper
corner	corner of reference point (see presets)
location	(see presets)
line	placement of elements in a virtual column grid (see \setuplayout)
column	placement of elements in a virtual column grid (see \setuplayout)
doublesided	only in \definelayer yes use the second optional argument of \setlayer to control whether your content is placed on an odd or even page
method	fit related to \startTEXpage
repeat	repeat on all pages?
preset	placement preset

See also

• \definelayer
• pack-lyr.mkiv
• Document layout and layers/Layers
• \setlayer
• \definelayer

Help from ConTeXt-Mailinglist/Forum

All issues with:

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