texlive[68254] Master/texmf-dist: photobook (12sep23)
commits+karl at tug.org
commits+karl at tug.org
Tue Sep 12 22:15:07 CEST 2023
Revision: 68254
http://tug.org/svn/texlive?view=revision&revision=68254
Author: karl
Date: 2023-09-12 22:15:07 +0200 (Tue, 12 Sep 2023)
Log Message:
-----------
photobook (12sep23)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/latex/photobook/photobook.pdf
trunk/Master/texmf-dist/tex/latex/photobook/photobook.cls
Modified: trunk/Master/texmf-dist/doc/latex/photobook/photobook.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/tex/latex/photobook/photobook.cls
===================================================================
--- trunk/Master/texmf-dist/tex/latex/photobook/photobook.cls 2023-09-12 20:14:54 UTC (rev 68253)
+++ trunk/Master/texmf-dist/tex/latex/photobook/photobook.cls 2023-09-12 20:15:07 UTC (rev 68254)
@@ -93,7 +93,7 @@
%%% NOTE: \def\<module-name>@[A-Z]+ macros will be visible to both the
%%% code and the generated docs...
-\edef\photobook at FILEVERSION{v0.1.26}
+\edef\photobook at FILEVERSION{v0.1.28}
\edef\photobook at FILEDATE{2023-08-24}
@@ -965,8 +965,8 @@
%%% \DescribeMacro{\clearancetop=<len>}
%%% \DescribeMacro{\clearanceright=<len>}
%%% \DescribeMacro{\clearancebottom=<len>}
-% XXX LEGACY CLEARANCE
-%%% \DescribeMacro{\clearance=<len>}
+% XXX revise...
+%%% \DescribeMacro{\clearances=<len's>}
%
%% Cell geometry.
%%
@@ -987,7 +987,6 @@
\setlength\celloffsetleft{0pt}
\newlength\celloffsettop
\setlength\celloffsettop{0pt}
-% XXX EXPERIMENTAL CLEARANCE
\newlength\clearanceleft
\setlength\clearanceleft{0pt}
\newlength\clearancetop
@@ -997,9 +996,6 @@
\newlength\clearancebottom
\setlength\clearancebottom{0pt}
\def\clearances{0pt}
-% XXX LEGACY CLEARANCE
-%\newlength\clearance
-%\setlength\clearance{0pt}
%% \DescribeMacro{\clearfoldoutgutter=<len>}
@@ -1491,6 +1487,9 @@
%%
%% Note that this may span more than one page if there is enough stuff
%% packed in.
+%% Also note that items within the page environment are placed in the
+%% same way as in any normal page, for absolute placement use either
+%% specific cells/environments like |papercell| or more generic |call|.
%%
\newenvironment{page}{%
% XXX do we need \null here???
@@ -1617,8 +1616,6 @@
%%% \DescribeMacro{\clearancetop=<len>}
%%% \DescribeMacro{\clearanceright=<len>}
%%% \DescribeMacro{\clearancebottom=<len>}
-% XXX LEGACY CLEARANCE
-%%% \DescribeMacro{\clearance=<len>}
%%
%% A cell defines a set of contextual lengths:
%%
@@ -1750,13 +1747,10 @@
\setlength\cellheight{\photobook at protect@h}%
\setlength\celloffsettop{0pt}%
\setlength\celloffsetleft{0pt}%
- % XXX EXPERIMENTAL CLEARANCE
\setlength\clearanceleft{0pt}%
\setlength\clearancetop{0pt}%
\setlength\clearanceright{0pt}%
\setlength\clearancebottom{0pt}%
- % XXX LEGACY CLEARANCE
- %\setlength\clearance{0pt}%
%
\begin{MinipageCellContent}[\photobook at minipagecell@parentvalign]{minipagecell}%
}{%
@@ -2013,7 +2007,7 @@
%% \DescribeEnv{cliptocell}
-%% \DescribeEnv{cliptocellbleeds}
+%% \DescribeEnv{setcliptocellbleeds}
%
%% Clip content to parent cell.
%%
@@ -2046,24 +2040,27 @@
\setlength\photobook at cliptocell@right{0mm}%
\newlength\photobook at cliptocell@bottom
\setlength\photobook at cliptocell@bottom{0mm}%
+
+\def\cliptocellbleeds{{0mm} {0mm} {0mm} {0mm}}%
\def\cliptocellclearances{{0mm} {0mm} {0mm} {0mm}}%
%% Set the default bleeds for |cliptocell| environments
%%
-%% >> \cliptocellbleeds{<size>}
-%% >> \cliptocellbleeds{<horizontal> <vertical>}
-%% >> \cliptocellbleeds{<left> <bottom> <right> <top>}
+%% >> \setcliptocellbleeds{<size>}
+%% >> \setcliptocellbleeds{<horizontal> <vertical>}
+%% >> \setcliptocellbleeds{<left> <bottom> <right> <top>}
%%
%% This will only affect |cliptocell| environments on the same level,
%% without affecting the nested |cliptocell|s.
%%
+%%% \DescribeEnv{cliptocellbleeds=<left> <bottom> <right> <top>}
%%% \DescribeEnv{cliptocellclearances=<left> <bottom> <right> <top>}
%%%
-%%% Set by |\cliptocellbleeds{..}| and contains clearances (negative
-%%% clipping bleeds) usable by imagecell.
+%%% Set by |\setcliptocellbleeds{..}| and contain bleeds and clearances (negative
+%%% clipping bleeds) respectively, usable by imagecell and others.
%%%
%%% XXX still testing....
-\newcommand\cliptocellbleeds[1]{
+\newcommand\setcliptocellbleeds[1]{
\setsepchar{ }%
\readlist*\photobook at cliptocell@bleeds{#1}%
\setsepchar{,}%
@@ -2100,6 +2097,11 @@
% NOTE: trailing spaces here are significant...
% XXX should we use \the here?
% ...it makes things printable...
+ \def\cliptocellbleeds{%
+ {\the\photobook at cliptocell@left} %
+ {\the\photobook at cliptocell@bottom} %
+ {\the\photobook at cliptocell@right} %
+ {\the\photobook at cliptocell@top}}%
\def\cliptocellclearances{%
{-\the\photobook at cliptocell@left} %
{-\the\photobook at cliptocell@bottom} %
@@ -2109,7 +2111,7 @@
% XXX use \cliptocellclearances as default...
\newenvironment{cliptocell}[1][0mm]{%
\begingroup%
- \cliptocellbleeds{#1}
+ \setcliptocellbleeds{#1}
% NOTE: the spaces at the end of each line here are significant!!
\begin{trimbox}{{\photobook at cliptocell@left} %
{\photobook at cliptocell@bottom} %
@@ -2120,7 +2122,7 @@
{\cellwidth + \photobook at cliptocell@right} %
{\height + \photobook at cliptocell@top}}%
% set defaults for nested cells...
- \cliptocellbleeds{0mm}%
+ \setcliptocellbleeds{0mm}%
\begin{minipage}[t][\cellheight][t]{\cellwidth}%
\ignorespaces%
}{%
@@ -2331,9 +2333,6 @@
\setlength\photobook at imagecell@clearance at right{0pt}
\newlength\photobook at imagecell@clearance at bottom
\setlength\photobook at imagecell@clearance at bottom{0pt}
-% XXX LEGACY
-\newlength\photobook at imagecell@clearance
-\setlength\photobook at imagecell@clearance{0pt}
% NOTE: these feel like a hack...
\newlength\photobook at imagecell@imgratio
@@ -2348,13 +2347,11 @@
\define at boolkey{imagecell at args}{center}[true]{%
\def\photobook at imagecell@top{\dimexpr
+0.5\cellheight
- % XXX EXPERIMENTAL CLEARANCE -- test...
+0.5\photobook at imagecell@clearance at top
-0.5\photobook at imagecell@clearance at bottom
-0.5\ht\photobook at imagebox \relax}%
\def\photobook at imagecell@left{\dimexpr
+0.5\cellwidth
- % XXX EXPERIMENTAL CLEARANCE -- test...
+0.5\photobook at imagecell@clearance at left
-0.5\photobook at imagecell@clearance at right
-0.5\wd\photobook at imagebox \relax}}%
@@ -2363,7 +2360,6 @@
\newcommand\photobook at imagecell@LEFT{%
\def\photobook at imagecell@left{\dimexpr%
+\photobook at imagecell@clearance at left \relax}%
- %+\photobook at imagecell@clearance \relax}%
\def\photobook at imagecell@captionleft{
% XXX not sure why this branch is needed...
\ifKV at imagecell@args at fit
@@ -2403,7 +2399,6 @@
\define at boolkey{imagecell at args}{top}[true]{%
\def\photobook at imagecell@top{%
\photobook at imagecell@clearance at top}%
- %\photobook at imagecell@clearance}%
\def\photobook at imagecell@captiontop{%
-\dimexpr
+\cellheight
@@ -2419,7 +2414,6 @@
\dimexpr
\photobook at imagecell@top
+\photobook at imagecell@clearance at bottom \relax}}%
- %+\photobook at imagecell@clearance \relax}}%
% clearance=<len>...
% clearance=<horizontal> <vertical>...
% clearance=<left> <bottom> <right> <top>...
@@ -2427,7 +2421,7 @@
% XXX EXPERIMENTAL
% XXX this is essentially the same as \photobook at cliptocell@bleeds -- unite...
\def\photobook at imagecell@clearances{#1}%
- \setsepchar{ }
+ \setsepchar{ }%
\readlist*\photobook at imagecell@clearencelist{#1}%
\setsepchar{,}%
%% args: size
@@ -2459,9 +2453,7 @@
\setlength\photobook at imagecell@clearance at right{%
\photobook at imagecell@clearencelist[3]}%
\setlength\photobook at imagecell@clearance at top{%
- \photobook at imagecell@clearencelist[4]}\fi%
- % XXX LEGACY...
- \setlength\photobook at imagecell@clearance{#1}}%
+ \photobook at imagecell@clearencelist[4]}\fi}%
% offsettop=<len> / offsetleft=<len>...
% XXX DOC!!!
@@ -2511,12 +2503,10 @@
\cellwidth
- \photobook at imagecell@clearance at left
- \photobook at imagecell@clearance at right \relax,
- %- ((\photobook at imagecell@clearance) * 2) \relax,
height=\photobook at imagecell@scale\dimexpr
\cellheight
- \photobook at imagecell@clearance at top
- \photobook at imagecell@clearance at bottom \relax]{#3}}%
- %- ((\photobook at imagecell@clearance) * 2) \relax]{#3}}%
% fill...
\else\ifKV at imagecell@args at fill%
% preload image to get its proportions...
@@ -2537,7 +2527,6 @@
+ \cellwidth
- \photobook at imagecell@clearance at left
- \photobook at imagecell@clearance at right \relax]{#3}}%
- %- ((\photobook at imagecell@clearance) * 2) \relax]{#3}}%
\else%
\sbox{\photobook at imagebox}{%
\includegraphics[%
@@ -2546,7 +2535,6 @@
+ \cellheight
- \photobook at imagecell@clearance at top
- \photobook at imagecell@clearance at bottom \relax]{#3}}%
- %- ((\photobook at imagecell@clearance) * 2) \relax]{#3}}%
\fi\fi\fi%
%
\setlength\celloffsetleft{%
@@ -2589,14 +2577,11 @@
\maxdim{\celloffsetleft}{0pt}}%
\setlength\celloffsettop{%
\maxdim{\celloffsettop}{0pt}}%
- % XXX EXPERIMENTAL CLEARANCE
\setlength\clearanceleft{\photobook at imagecell@clearance at left}
\setlength\clearancetop{\photobook at imagecell@clearance at top}
\setlength\clearanceright{\photobook at imagecell@clearance at right}
\setlength\clearancebottom{\photobook at imagecell@clearance at bottom}
\def\clearances{\photobook at imagecell@clearences}
- % XXX LEGACY CLEARANCE
- %\setlength\clearance{\photobook at imagecell@clearance}%
% clear parent...
% XXX might be a good idea to put this into a special reusable cell...
\ifphotobook at imagecell@captionclearparent%
@@ -3055,10 +3040,12 @@
- \photobook at captionblockcell@spacing
- \cellwidth
- \clearcaption
+ % XXX EXPERIMENTAL CLEARANCE
% XXX this is only present in images...
- % XXX change this to use \clearanceleft / \clearanceright / ...
+ - \clearanceleft
+ %- \clearanceright
% XXX LEGACY CLEARANCE
- - \clearance
+ %- \clearance
\relax%
\else%
\photobook at captionblockcell@width\fi}%
@@ -4079,8 +4066,10 @@
% XXX EXPERIMENTAL
\newenvironment{leftside*}{%
\begin{leftside}%
- \cliptocellbleeds{{\bleed} {\bleed} 0mm {\bleed}}%
+ \begin{cliptocell}[{\bleed} {\bleed} 0mm {\bleed}]%
+ \setcliptocellbleeds{{\bleed} {\bleed} 0mm {\bleed}}%
}{%
+ \end{cliptocell}
\end{leftside}}
\newenvironment{rightside}{%
@@ -4092,8 +4081,10 @@
% XXX EXPERIMENTAL
\newenvironment{rightside*}{%
\begin{rightside}%
- \cliptocellbleeds{0mm {\bleed} {\bleed} {\bleed}}%
+ \begin{cliptocell}[0mm {\bleed} {\bleed} {\bleed}]%
+ \setcliptocellbleeds{0mm {\bleed} {\bleed} {\bleed}}%
}{%
+ \end{cliptocell}
\end{rightside}}
@@ -4872,7 +4863,8 @@
%\clearpage%
\begin{page}%
% NOTE: this does not account for \bindingoffset...
- \begin{pagecell}%
+ % XXX should this be a page or a paper cell???
+ \begin{papercell}%
\imagecell[%
center,
clearance=-\bleed,
@@ -4881,7 +4873,7 @@
offsetleft=\imageoffsetleft,
captionclearparent=\captionclearpage,
#1]{#2}{#3}%
- \end{pagecell}%
+ \end{papercell}%
\end{page}%
% special case: centered vertical image -> account for \bindingoffset...
\else%
@@ -5462,6 +5454,10 @@
%%
%% This is a no-op for |layoutmode=block|.
%%
+%% To change text color set |\textcolor{<color>}| the usual way and for
+%% line and fill colors use |\textblockrulecolour{<color>}| and
+%% |\textblockcolour{<colour>}| respecitvely.
+%%
% XXX should digits/rounding be configurable???
\newcommand\photobook at TemplateCell[2][mm]{
\begin{center}
More information about the tex-live-commits
mailing list.