3,899
edits
Changes
Jump to navigation
Jump to search
Command/startcombination (view source)
Revision as of 09:42, 14 September 2023
, 09:42, 14 September 2023Created page with "Documentation for \startcombination ... \stopcombination"
<cd:commandgroup name="combination" type="environment" xmlns:cd="http://wiki.contextgarden.net/commanddoc/20200807">
<cd:shortdesc><!-- a short command summary goes here -->
The environment <tt>\startcombination ... \stopcombination</tt> is used for grouping visual objects
</cd:shortdesc>
<cd:variants>
<cd:command category="tables" file="pack-com.mkiv" interfacedate="2020-07-14T09:24" interfacefile="i-combination.xml" level="document" name="combination" type="environment" variantnumber="1">
<cd:arguments>
<cd:keywords optional="yes" ordinal="1">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="cd:name"></cd:constant>
</cd:keywords>
<cd:assignments list="yes" optional="yes" ordinal="2">
<cd:assignmentsdoc></cd:assignmentsdoc>
<cd:inherit name="setupcombination"></cd:inherit>
</cd:assignments>
</cd:arguments>
</cd:command>
<cd:command category="tables" file="pack-com.mkiv" interfacedate="2020-07-14T09:24" interfacefile="i-combination.xml" level="document" name="combination" type="environment" variant="matrix" variantnumber="2">
<cd:arguments>
<cd:keywords optional="yes" ordinal="1">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="cd:name"></cd:constant>
</cd:keywords>
<cd:keywords optional="yes" ordinal="2">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="cd:matrix"></cd:constant>
</cd:keywords>
</cd:arguments>
</cd:command>
</cd:variants>
<cd:description>A combination is a number of objects arranged in a matrix, with a caption below each object. (The captions may be empty.)</cd:description>
<cd:examples><cd:example title=""><context source="yes">
\setupexternalfigures[location={local, default}]
\placefigure
[here] % figure placement
[fig:combinations] % figure reference
{An example of \type{\startcombination...}.} % figure caption
{\startcombination[3*2] % contents of the figure: a combination
% first row
{\externalfigure[cow][height=1cm]} {a} % subfigure and subcaption
{\externalfigure[cow][height=1cm]} {b}
{\externalfigure[cow][height=1cm]} {c}
% second row
{\externalfigure[cow][height=1cm]} {d}
{\externalfigure[cow][height=1cm]} {e}
{\externalfigure[cow][height=1cm]} {f}
\stopcombination}
</context></cd:example><cd:example title="Automatic caption labels">This example shows how to autolabel figures
<context source="yes">
\useMPlibrary[dum]
\definecombination[mycombi][alternative=label]
\setuplabel[combination:mycombi][
text={Item },
numberconversion=character,
stopper=!,
]
4 pics
\startcombination[mycombi][2*2]
{\externalfigure[dummy][width=4cm,height=1cm]}
{\externalfigure[dummy][width=4cm,height=1cm]}
{\externalfigure[dummy][width=4cm,height=1cm]}
{\externalfigure[dummy][width=4cm,height=1cm]}
\stopcombination
\blank[2*big]
2 more pics
\startcombination[mycombi][nx=2,ny=1,continue=yes]
{\externalfigure[dummy][width=4cm,height=1cm]}
{\externalfigure[dummy][width=4cm,height=1cm]}
\stopcombination
</context>
</cd:example></cd:examples>
<cd:notes></cd:notes>
<cd:seealso>
<cd:commandref name="definecombination" originator="system"></cd:commandref>
<cd:commandref name="setupcombination" originator="system"></cd:commandref>
<cd:source file="pack-com.mkiv" originator="system"></cd:source>
<cd:wikipage originator="system" page="Category:Tables"></cd:wikipage>
<cd:commandref name="defineparagraphs">for non-floating side-by-side items.</cd:commandref>
<cd:commandref name="placefloat">for singular floating items.</cd:commandref>
<cd:wikipage page="Combinations"></cd:wikipage></cd:seealso>
</cd:commandgroup>
<cd:shortdesc><!-- a short command summary goes here -->
The environment <tt>\startcombination ... \stopcombination</tt> is used for grouping visual objects
</cd:shortdesc>
<cd:variants>
<cd:command category="tables" file="pack-com.mkiv" interfacedate="2020-07-14T09:24" interfacefile="i-combination.xml" level="document" name="combination" type="environment" variantnumber="1">
<cd:arguments>
<cd:keywords optional="yes" ordinal="1">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="cd:name"></cd:constant>
</cd:keywords>
<cd:assignments list="yes" optional="yes" ordinal="2">
<cd:assignmentsdoc></cd:assignmentsdoc>
<cd:inherit name="setupcombination"></cd:inherit>
</cd:assignments>
</cd:arguments>
</cd:command>
<cd:command category="tables" file="pack-com.mkiv" interfacedate="2020-07-14T09:24" interfacefile="i-combination.xml" level="document" name="combination" type="environment" variant="matrix" variantnumber="2">
<cd:arguments>
<cd:keywords optional="yes" ordinal="1">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="cd:name"></cd:constant>
</cd:keywords>
<cd:keywords optional="yes" ordinal="2">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="cd:matrix"></cd:constant>
</cd:keywords>
</cd:arguments>
</cd:command>
</cd:variants>
<cd:description>A combination is a number of objects arranged in a matrix, with a caption below each object. (The captions may be empty.)</cd:description>
<cd:examples><cd:example title=""><context source="yes">
\setupexternalfigures[location={local, default}]
\placefigure
[here] % figure placement
[fig:combinations] % figure reference
{An example of \type{\startcombination...}.} % figure caption
{\startcombination[3*2] % contents of the figure: a combination
% first row
{\externalfigure[cow][height=1cm]} {a} % subfigure and subcaption
{\externalfigure[cow][height=1cm]} {b}
{\externalfigure[cow][height=1cm]} {c}
% second row
{\externalfigure[cow][height=1cm]} {d}
{\externalfigure[cow][height=1cm]} {e}
{\externalfigure[cow][height=1cm]} {f}
\stopcombination}
</context></cd:example><cd:example title="Automatic caption labels">This example shows how to autolabel figures
<context source="yes">
\useMPlibrary[dum]
\definecombination[mycombi][alternative=label]
\setuplabel[combination:mycombi][
text={Item },
numberconversion=character,
stopper=!,
]
4 pics
\startcombination[mycombi][2*2]
{\externalfigure[dummy][width=4cm,height=1cm]}
{\externalfigure[dummy][width=4cm,height=1cm]}
{\externalfigure[dummy][width=4cm,height=1cm]}
{\externalfigure[dummy][width=4cm,height=1cm]}
\stopcombination
\blank[2*big]
2 more pics
\startcombination[mycombi][nx=2,ny=1,continue=yes]
{\externalfigure[dummy][width=4cm,height=1cm]}
{\externalfigure[dummy][width=4cm,height=1cm]}
\stopcombination
</context>
</cd:example></cd:examples>
<cd:notes></cd:notes>
<cd:seealso>
<cd:commandref name="definecombination" originator="system"></cd:commandref>
<cd:commandref name="setupcombination" originator="system"></cd:commandref>
<cd:source file="pack-com.mkiv" originator="system"></cd:source>
<cd:wikipage originator="system" page="Category:Tables"></cd:wikipage>
<cd:commandref name="defineparagraphs">for non-floating side-by-side items.</cd:commandref>
<cd:commandref name="placefloat">for singular floating items.</cd:commandref>
<cd:wikipage page="Combinations"></cd:wikipage></cd:seealso>
</cd:commandgroup>
