Command/startcombination

\startcombination ... \stopcombination

Summary

The environment \startcombination ... \stopcombination is used for grouping visual objects

Settings

\startcombination[...][...=...,...] ... \stopcombination
[...]	name
...=...,...	inherits from \setupcombination

Settings matrix

\startcombination[...][...] ... \stopcombination
[...]	name
[...]	matrix

Description

A combination is a number of objects arranged in a matrix, with a caption below each object. (The captions may be empty.)

Examples

Example 1

\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}

Automatic caption labels

This example shows how to autolabel figures

\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

Alternative input syntax

On the mailinglist Hans answered on 14 may 2021 what you can do with combinations and how to add captions in in a different way:

\startplacefigure[location=here]
   \startcombination[distance=2mm,after=,nx=2,ny=1,location=middle]
       \startcontent
           \externalfigure[mill.png]  [width=.4\textwidth]
       \stopcontent
       \startcaption
           pic 1
       \stopcaption
       \startcontent
           \externalfigure[hacker.jpg][width=.4\textwidth]
       \stopcontent
       \startcaption
           pic 2
       \stopcaption
   \stopcombination
\stopplacefigure

grid alignment

\setuppapersize[A7,landscape]
\setuplayout[grid=yes]
\useMPlibrary[dum]
\showgrid
\starttext
before

\startcombination [nx=2,ny=1,continue=yes]
  {\externalfigure[dummy][width=4cm,height=1cm]} {}
  {\externalfigure[dummy][width=4cm,height=1cm]} {}
 \stopcombination

after

before

\startlinecorrection
 \startcombination [nx=2,ny=1,continue=yes]
  {\externalfigure[dummy][width=4cm,height=1cm]} {}
  {\externalfigure[dummy][width=4cm,height=1cm]} {}
 \stopcombination
\stoplinecorrection

after
\stoptext

See also

• \definecombination
• \setupcombination
• pack-com.mkiv
• \defineparagraphs for non-floating side-by-side items.
• \placefloat for singular floating items.
• Combinations

Help from ConTeXt-Mailinglist/Forum

All issues with:

• \startcombination on the mailing list (all results)
• \startcombination on the mailing list (subject only)
• \startcombination on stack exchange
• \startcombination in ConTeXt's source