Changes

< [[Visuals]] | [[Graphics]] | [[Using Graphics]] | [[Tables_Overview]] >

Floats Floating Objects (floats) are ConTeXt's "base class" for everything that uses a <tt>\placeplaced (and numbered) automatically.They are placed at an appropriate position determined by the TeX float placement algorithm..</tt> command (table, figure, own floats)The algorithm has a number of options that can influence float placement.

If you search Most options of e.g. <in the manual (such as {{cmd>|placeexternalfigure</cmd> you must look after <}}) are described using the generic {{cmd>|placefloat</cmd> in the manual! (same for <tt>\setup}}...</tt> etc.)

The float types Floats include "graphic", "figure", "table" , and "intermezzo" are readily defined. If you need more (i.e. if you need another numbering or table of something), you Additional floats can easily define your own floats with <be defined using {{cmd>|definefloat</cmd>}}.

<tr><td>90</td><td>orientation (rotation angle), both caption and contents</td></tr><tr bgcolor="#DDDDDD"><td>always</td><td>precedence over stored floats</td></tr><tr><td>force</td><td>per se here</td></tr><tr bgcolor="#DDDDDD"><td>forcesplit</td><td>per se here(For TABLES only) split tables</td></tr>

<{{cmd>|placefigure</cmd> }} and <{{cmd>|placetable</cmd> }} also accept the same set of options, and allow to create floating figures and captions respectively.

I will explain the examples in terms of <{{cmd>|placefigure</cmd> }} but the same set of options are also valid for other floats.

\placefigure[none] {} {\externalfigure{[figurename}]}

* Suppose you want the figure to be placed on the right side of the page, a few lines into the paragraph, and want the rest of the paragraph to warp wrap around the figure

This does not want work correctly at a page boundary. The <tt>line</tt> options option leaves the space above the figures empty, while the <tt>hang</tt> option also wraps texts above the figure. ==Floats and columns== This special case is discussed [[Columns#Floats_and_other_limitations_of_columns|here]]. ==Floats on empty pages== There’s a way to switch off page headings at full page floats: <texcode>\startplacefigure[title=Cow,location={page,high,header}] \externalfigure[cow.pdf]\stopplacefigure</texcode> ==Protruding Floats in Double-Sided Documents== If you have a double-sided document with wide outer margins then you might want your figures to protrude into the margin. In a double-sided document you need to tell ConTeXt to decide whether to make the figure protrude to the left or the right. This can be done as follows: <texcode>\definefloat[textmarginfigure][textmarginfigures]\setupfloat[textmarginfigure][location=inner]\placetextmarginfigure{\externalfigure[figurename]}</texcode> The following code gives a full example that can be pasted into live ConTeXt: <texcode>\setuppagenumbering [alternative=doublesided]\setuplayout[location=middle,backspace=2pc, width=20pc]\definefloat[textmarginfigure][textmarginfigures]\setupfloat[textmarginfigure][location=inner]\starttext\input knuth\placetextmarginfigure[here]{}{\externalfigure[figurename][width=30pc]}\input knuth\placetextmarginfigure[here]{}{\externalfigure[figurename][width=30pc]}\input knuth\stoptext</texcode> ==Landscape Floats in a Portrait Document==Wide tables, for example, can be turned and most likely will need to be put on a separate page.<texcode>\startplacetable [location={page,90},title=Table caption] \bTABLE [textwidth=\textheight] put a wide table here... \eTABLE\stopplacetable</texcode>Both the table caption and the contents will be rotated, but not the page header and footer which remain "upright". Notice that one must set the TABLE textwidth to {{cmd|textheight}} in order for the table macros to fit properly. == Floats and section headings ==By default, section headings don't wrap "around" floating objects. Instead, they will be moved down as far as needed to appear below the float. This behaviour can be controlled using the <tt>aligntitle</tt> option of the {{cmd|setupheads}} or {{cmd|setuphead}} commands. == Captions ==To change the style of figure(table) captions, use {{cmd|setupcaptions}}. To use a different (e.g. abbreviated) caption in the list of floats, you can do: <texcode>\defineselector[caption][max=2,n=2]\starttext\setupselector[caption][n=1]\completelistoffigures\setupselector[caption][n=2]\placefigure[][]{\select{caption} {Short caption for list} {A rather longer caption which will appear below the figure itself}} {This is the content of the actual figure}\stoptext</texcode> Or in more recent (circa November 2011 and later) versions of ConTeXt: <texcode>\startplacefigure[title={A rather long caption},list={A short caption}]This is the content of the actual figure\stopplacefigure</texcode> == Flushing floats == The command {{cmd|placefloats}} outputs all pending floats.