texlive[66931] Master/texmf-dist: photobook (24apr23)

[commits+karl at tug.org]

Revision: 66931
          http://tug.org/svn/texlive?view=revision&revision=66931
Author:   karl
Date:     2023-04-24 22:17:01 +0200 (Mon, 24 Apr 2023)
Log Message:
-----------
photobook (24apr23)

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-04-24 20:16:35 UTC (rev 66930)
+++ trunk/Master/texmf-dist/tex/latex/photobook/photobook.cls	2023-04-24 20:17:01 UTC (rev 66931)
@@ -38,10 +38,16 @@
 %
 % - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 %
+% XXX should cliptocell offsets be tweakable???
+% XXX ASAP should cover/jacket/endpaper/spread template cells account 
+%		for bleeds as an option???
+%		...i.e. include cliptocell defaults???
 % XXX ASAP should cover/jacket/endpaper/spread templates/cells account
 %		for \bindingoffset (likely no) and/or \gutteroffset ???
 %		...especially relevant to endpaper/spread...
 % XXX ASAP revise how bleeds are handled by cells...
+%		...all cells should ignore bleeds unless explicitly stated 
+%		otherwise -- needs testing...
 %
 % XXX captions behave in an odd way...
 %		the internal (macro) minipage for some reason does not affect text 
@@ -79,8 +85,8 @@
 
 %%% NOTE: \def\<module-name>@[A-Z]+ macros will be visible to both the 
 %%%		code and the generated docs...
-\edef\photobook at FILEVERSION{v0.1.19}
-\edef\photobook at FILEDATE{2023-04-11}
+\edef\photobook at FILEVERSION{v0.1.20}
+\edef\photobook at FILEDATE{2023-04-22}
 
 
 %% \documentclass{ltxdoc}
@@ -1962,6 +1968,7 @@
 	\end{inlinecell*}%
 	\end{turn}}
 
+
 %% \DescribeEnv{cliptocell}
 %
 %% Clip content to parent cell.
@@ -1968,14 +1975,25 @@
 %%
 %%	>> \begin{cliptocell} ... \end{cliptocell}
 %%
-%% Clip content to cell adding bleeds
+%% Clip content to cell plus offsets (bleeds) from each side
 %%
 %%	>> \begin{cliptocell}[<size>] ... \end{cliptocell}
 %%	>> \begin{cliptocell}[<horizontal> <vertical>] ... \end{cliptocell}
 %%	>> \begin{cliptocell}[<left> <bottom> <right> <top>] ... \end{cliptocell}
 %%
-%% Clipping to bleeds will not affect the cell content positioning.
+%% Offset order, i.e. left-bottom-right-top is made consistent with 
+%% \href{https://ctan.org/pkg/graphicx}{graphicx} and 
+%% \href{https://ctan.org/pkg/trimclip}{trimclip} modules and represents 
+%% the bottom-left and top-right viewport point offsets from the parent 
+%% cell.
 %%
+%% |cliptocell| does not affect the cell content positioning in any way.
+%%
+%% This is designed to simplify filling template cells and adding bleeds 
+%% to certain sides and clipping flush to others, for example for cells 
+%% of a dust jacket or a foldout, but |cliptocell| is not limited to 
+%% this one use-case.
+%%
 \newlength\photobook at cliptocell@left
 \setlength\photobook at cliptocell@left{0mm}%
 \newlength\photobook at cliptocell@top
@@ -1990,7 +2008,7 @@
 		\setsepchar{ }%
 		\readlist*\photobook at cliptocell@bleeds{#1}%
 		%
-		% bleed
+		% args: size
 		\ifnum \photobook at cliptocell@bleedslen = 1%
 			\setlength\photobook at cliptocell@left{%
 				\photobook at cliptocell@bleeds[1]}%
@@ -2000,7 +2018,7 @@
 				\photobook at cliptocell@bleeds[1]}%
 			\setlength\photobook at cliptocell@top{%
 				\photobook at cliptocell@bleeds[1]}\fi%
-		% horizontal vertical
+		% args: horizontal vertical
 		\ifnum \photobook at cliptocell@bleedslen = 2%
 			\setlength\photobook at cliptocell@left{%
 				\photobook at cliptocell@bleeds[1]}%
@@ -2010,7 +2028,7 @@
 				\photobook at cliptocell@bleeds[1]}%
 			\setlength\photobook at cliptocell@top{%
 				\photobook at cliptocell@bleeds[2]}\fi%
-		% left top right bottom
+		% args: left bottom right top
 		\ifnum \photobook at cliptocell@bleedslen = 4%
 			\setlength\photobook at cliptocell@left{%
 				\photobook at cliptocell@bleeds[1]}%
@@ -2021,7 +2039,7 @@
 			\setlength\photobook at cliptocell@top{%
 				\photobook at cliptocell@bleeds[4]}\fi%
 		%
-		% XXX the spaces at the end of each line here are significant...
+		% NOTE: the spaces at the end of each line here are significant!!
 		\begin{trimbox}{{\photobook at cliptocell@left} %
 				{\photobook at cliptocell@bottom} %
 				{\photobook at cliptocell@right} %
@@ -2030,6 +2048,11 @@
 				{\height - \cellheight - \photobook at cliptocell@bottom} %
 				{\cellwidth + \photobook at cliptocell@right} %
 				{\height + \photobook at cliptocell@top}}%
+		% set defaults for nested cells...
+		\setlength\photobook at cliptocell@left{0mm}%
+		\setlength\photobook at cliptocell@top{0mm}%
+		\setlength\photobook at cliptocell@right{0mm}%
+		\setlength\photobook at cliptocell@bottom{0mm}%
 		\begin{minipage}[t][\cellheight][t]{\cellwidth}% 
 			\ignorespaces%
 	}{%
@@ -2039,8 +2062,6 @@
 	\endgroup}
 
 
-
-
 %% \DescribeMacro{\imagecell\{..\}}
 %
 %% Place image in cell.