Command/placefloat

\placefloat

Syntax (autogenerated)

\placefloat[...][...,...][...,...]{...}{...}
[...]	singular
[...,...]	split always left right inner outer backspace cutspace inleft inright inmargin leftmargin rightmargin leftedge rightedge innermargin outermargin inneredge outeredge text opposite reset height depth [+-]line halfline grid high low fit 90 180 270 nonumber none local here force margin [+-]hang hanging tall both middle offset top bottom auto page leftpage rightpage somewhere effective header footer tblr lrtb tbrl rltb fxtb btlr lrbt btrl rlbt fxbt fixd
[...,...]	reference
{...}	text
{...}	CONTENT
variants are placefloat/instance placefloat(current)

Syntax

\placefloat[...][ref,ref,...]{...}{...}
[...]	left right here top bottom inleft inright inmargin margin leftmargin rightmargin leftedge rightedge innermargin outermargin inneredge outeredge inner outer line high low fit page leftpage rightpage opposite always auto force tall reset line height depth
[ref,ref,...]	references
{...}	caption
{...}	float contents

Description

With \placefloat[location][ref]{caption}{contents} you can declare that you want to take certain contents, and place them on the page as a (numbered) figure, table, graphic, or intermezzo, or as some other float type that you defined using \definefloat. ref is an optional reference label; location is an optional positioning key. There are a great many positioning keys defined; the following table describes them.

Keyword	Meaning
none	Suppress the caption, including the "Figure 1" label.
left	Left of text
right	To the right of the text
here	Preferably here
force	Force placement here
top	At the top of the page
bottom	At the bottom of the page
inleft	In the left margin
inright	In the right margin
inmargin	In the margin (left or right)
margin	In the margin (margin float)
leftmargin
rightmargin
leftedge
rightedge
innermargin
outermargin
inneredge
outeredge
inner
outer
line
high
low
fit
page	on a new (empty) page
leftpage
rightpage
opposite	on the left page (is this correct?)
always	precedence over stored floats
auto
tall
reset
line
height
depth

Example

% Tell ConTeXt where the cow picture is stored
\setupexternalfigures[location={local,default}]

\startcolumns[n=3]
    caption=none
    \placefigure{none}{\externalfigure[cow][height=1cm]}
\column
    key=none
    \placefigure[none]{}{\externalfigure[cow][height=1cm]}
\column
    empty caption
    \placefigure{}{\externalfigure[cow][height=1cm]}
\stopcolumns

See also

• \startplacefloat start-stop version of \placefloat
• \definefloat to define a new kind of float object.
• \startcombination to place multiple figures.
• \setupcaption to place the caption differently than 'below and centered'.

Help from ConTeXt-Mailinglist/Forum

All issues with:

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