Command/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

Description

Examples

Notes

Help from ConTeXt-Mailinglist/Forum

All issues with: