General ⇒ Wrapper for subcaptionbox: automatic vertical alignment

[woj-k]

Hello everyone,

I got stuck on designing easy-to-use command wrappers for multipanel floats (i.e. subfigures/subtables) built around the subcaption package. The problem has to do with vertical alignment of the individual panels of the float: the 'default' behaviour I have observed is bottom-alignment, but I would like the users to be able to specify rows where the panels are verticaly centered or top-aligned. This would require raising some of the panels by an amount which is dependent on the height of the 'tallest' panel in the given row.

In the MWE below I have omitted top-aligned panels for brevity.

The panel-environment evaluates its contents and dumps them into a macro \panelcontents. Although it does nothing with this value, it does evaluate the contents' height and stores it in \currentpanelheight---I imagine the final version will have to do it anyway, to decide which panel is the tallest automatically.

The problem disappears if I specify the tallest panel's height by hand (line 89 of the MWE). It is to have LaTeX determine this value automatically for each row that poses a problem. I considered a solution where each panel exports a value to an external file, and a separate macro selects the tallest panel on a subsequent run, rather than on-the-fly. There is probably a more elegant way to do it, but I am missing a piece of the puzzle. Can anyone offer any advice?

Code: Select all

Code, edit and compile here:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
\documentclass{book}
\usepackage{subcaption}
\usepackage[labelsep=space]{caption}
%Housekeeping code
\newlength\tallestpanelinrow
\newlength\currentpanelheight
\newlength\currentpanelwidth
\newif\ifcenterpanels
\newif\ifbottomalignpanels
\newcommand{\CenterPanels}{%
    \centerpanelstrue
    \bottomalignpanelsfalse
}%
\newcommand{\BottomAlignPanels}{%
    \centerpanelsfalse
    \bottomalignpanelstrue
}%
\BottomAlignPanels
%Row environments
\newenvironment{Bpanelrow}{\par\BottomAlignPanels}{}
%Centered panels dump contents in a savebox
%for future repositioning
\newsavebox{\rowpanelbox}
\newenvironment{Cpanelrow}{\par\CenterPanels%
\begin{lrbox}{\rowpanelbox}}%
{\end{lrbox}%
\usebox\rowpanelbox%
}
%The panel environment
\newsavebox{\panelbox}
\newenvironment{panel}[2][1.0]{%
%Housekeeping code
  \setlength{\currentpanelwidth}{#1\textwidth}%
 
 
הההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההה
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Run LaTeX here

[woj-k]

Fixed up a solution using the \VerbatimOut facility of the fancyvrb package, with export of each row to an external file and using the code twice---once to determine the size and once to print the correctly aligned row. It all happens on the same run. Had to redefine \panel for the size-determination step, and for some reason I could not simply return it to the previous version using \global\let---had to use \renewcommand again instead. Here's a top-aligned and centred example.

Code: Select all

Code, edit and compile here:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
\documentclass{article}
\usepackage{fancyvrb,caption}
\usepackage[labelsep=space]{subcaption}
\newlength\currentheight
\newlength\tallesttemp
\newlength\currentpanelwidth
\newenvironment{multipaneltable}[3][tbhp]{%
\begin{table}[#1]%
\begin{center}%
    \captionsetup{type=table,hypcap=false,position=bottom,subrefformat=parens}%
    \caption{#2\label{#3}}%
}%
{\end{center}\end{table}}
\newenvironment{Cpanelrow}%
  {%
    \newcommand{\panel}[3][1.0]{\setlength{\tallesttemp}{0.0pt}%
    \setlength{\currentpanelwidth}{##1\textwidth}%
    \gdef\panellabel{##2}%
    \gdef\panelcontents{##3}%
    \settoheight{\currentheight}{\panelcontents}\addtolength{\tallesttemp}{-\currentheight}%
    \subcaptionbox{\strut\label{\panellabel}}[\currentpanelwidth]{\raisebox{0.5\tallesttemp}{\panelcontents}}}%
    \VerbatimOut{\jobname.pnl}%
  }%
  {%
    \endVerbatimOut\par%
    \renewcommand{\panel}[3][1.0]{\gdef\panelcontents{##3}\raisebox{0.5\tallesttemp}{\panelcontents}}%
    \settoheight{\tallesttemp}{\input{\jobname.pnl}}%
    \xdef\hhtemp{\the\tallesttemp}%
%
    \renewcommand{\panel}[3][1.0]{\setlength{\tallesttemp}{0.0pt}%
    \setlength{\currentpanelwidth}{##1\textwidth}%
    \gdef\panellabel{##2}%
    \gdef\panelcontents{##3}%
    \settoheight{\currentheight}{\panelcontents}%
    \setlength{\tallesttemp}{\hhtemp}%
    \addtolength{\tallesttemp}{-\currentheight}%
 
 
הההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההה
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Run LaTeX here