69
edits
Changes
Jump to navigation
Jump to search
m
< [[Visuals]] | [[Graphics]] | [[Using Graphics]] >= Introduction =
Floats are elements like tables or figures that Floating Objects (floats) are placed (and numbered) automatically by TeX, with a configurable (and optional) caption. They are so called as they can ''placed at an appropriate position determined by the TeX float'' around the output pages to placement algorithm. The algorithm has a place where TeX thinks they are appropriate (You number of options that can influence what TeX thinks as appropriate)float placement.
Floats Most options in the manual (such as {{cmd|placeexternalfigure}}) are ConTeXt's "base class" for everything that uses a <tt>\placedescribed using the generic {{cmd|placefloat}}...</tt> command (tableAdditionally, figure, own floats){{cmd|placelistoffigures}} creates a list of the figures used in the document.
If you search options of e.g. <cmd>placeexternalfigure</cmd> you must look after <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>}}.
<{{cmd>|placefigure</cmd> }} and <{{cmd>|placetable</cmd> }} also accept the same set of options, and allow to create floating figures and captions respectively.
== Examples ==I will explain the examples in terms of <{{cmd>|placefigure</cmd> }} but the same set of options are also valid for other floats.
==Floats and columns==
==Landscape Floats in a Portrait Document==
== 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</cmd> or <cmd>setuphead</cmd> commands.
=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</cmd>}}.
Or in more recent (circa November 2011 and later) versions of ConTeXt:= Float Combinations =
</texcode>
=See \in{figure}[fig:left] and \in{figure}[fig:right].</context> See also {{cmd|startcombination}}, {{cmd|startfloatcombination}}, [[Combinations]] and {{cmd|startsubfloatcombination}}. = Flushing floats == The command {{cmd|placefloats}} outputs all pending floats.
The command <cmd>placefloats</cmd> outputs all pending floats.[[Category:Basics]][[Category:Layout]]
Remove TEXpage from code snippets
<texcode>
(table copied from the manual)
'''reference'''
If you don't need to refer to your float, you can leave this parameter out.
* If you do not want a caption
This does not work correctly at a page boundary. The <tt>line</tt> option leaves the space above the figures empty, while the <tt>hang</tt> option also wraps texts above the figure.
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>
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]
\startTEXpage bTABLE [widthtextwidth=\textheight]
put a wide table here...
\stopTEXpageeTABLE
\stopplacetable
</texcode>
Both the table caption and the contents will be rotated, but not the page header and footer which remain "upright". The <Notice that one must set the TABLE textwidth to {{cmd>startTEXpage</cmd> <cmd>stopTEXpage</cmd> is a trick to allow |textheight}} in order for the table macros to work correctlyfit properly.
To use a different (e.g. abbreviated) caption in the list of floats, you can do:
<texcode>
\startplacefigure[title={A rather long caption},list={A short caption}]
This is the content of the actual figure
\stopplacefigure
</texcode>
In MkII this was possible by:
<texcode>
</texcode>
If you want to place floats besides each other or in a regular matrix,each with its own number and caption, you need a float combination: <context source=yes>\useMPlibrary [dum] %% sample images \startplacefigure [location=none] % disable numbering of outer float \startfloatcombination [nx=2, ny=1] % two columns, one row \startplacefigure [title=Left] \externalfigure [dummy] \stopplacefigure \startplacefigure [title=Right] \externalfigure [dummy] \stopplacefigure \stopfloatcombination\stopplacefigure<texcode/context> If you want only one number for the whole thing, you may use a regular combination within a float: <context source=yes>\useMPlibrary [dum] %% sample images \startplacefigure[title=My combination] \startcombination [nx=2, ny=1] \startcontent \externalfigure [dummy] \stopcontent \startcaption Left \stopcaption \startcontent \externalfigure [dummy] \stopcontent \startcaption Right \stopcaption \stopcombination\stopplacefigure</context> See also {{A rather long captioncmd|startcombination}},list{{cmd|startfloatcombination}} and [[Combinations]]. =Subfloats =Subfloatnumbering creates subfigures sharing a mutual figure prefix and anindividual subfigure designator (e.g. figure 1a), figure 1b, etc.). The command {A short caption{cmd|startsubfloatnumbering}}is used for this. <context source=yes>\useMPlibrary [dum] %% sample images \startsubfloatnumbering \startplacefigure [title=Alpha]This is the content of the actual figure \externalfigure \stopplacefigure \startplacefigure [title=Beta] \externalfigure \stopplacefigure\stopsubfloatnumbering</context> Subfloats can also be used with floatcombinations: <context source=yes>\useMPlibrary [dum] %% sample images \startplacefigure [location=none] \startsubfloatnumbering \startfloatcombination [nx=2, ny=1] \startplacefigure [title=Left, reference=fig:left] \externalfigure \stopplacefigure \startplacefigure [title=Right, reference=fig:right] \externalfigure \stopplacefigure \stopfloatcombination \stopsubfloatnumbering
\stopplacefigure
