Debian Codegraph @

texmf-dist/source/latex/paracol/bgpaint.dtx

raw
1 % \backgroundcolor{t}[rgb]{0.7,0,0}
2 % \backgroundcolor{b}[rgb]{0.8,0.6,0}
3 % \backgroundcolor{l}[rgb]{0,0,0.7}
4 % \backgroundcolor{r}[rgb]{0,0.7,0}
5 % \backgroundcolor{c[0]}[rgb]{1,0.8,1}
6 % \backgroundcolor{c[1]}[rgb]{1,1,0.8}
7 % \backgroundcolor{g}[rgb]{0.8,1,1}
8 % \backgroundcolor{f}[rgb]{0.8,0,1}
9 % \backgroundcolor{n}[rgb]{0.8,0.6,1}
10 % \backgroundcolor{p}[rgb]{0.8,1,0.6}
11 % \backgroundcolor{s}[rgb]{0.8,0.8,0.8}
12 % \pagerim5pt
13 %
14 % \section{Examples of Background Painting}
15 % \label{sec:bgpaint}
16 % \subsection{Fundamental Painting}
17 % \label{sec:bgpaint-fund}
18 % \twosided[pcm]
19 %
20 % As you undoubtedly notice, this page and a few pages following it are
21 % colorfully painted. For this and the next three pages, the author
22 % declared the \bground{} color of each region as follows.
23 % 
24 % \begin{itemize}\item[]
25 % |\backgroundcolor{t}[rgb]{0.7,0,0} % dark red for top margin|\\
26 % |\backgroundcolor{b}[rgb]{0.8,0.6,0} % dark orange for bottom margin|\\
27 % |\backgroundcolor{l}[rgb]{0,0,0.7} % dark blue for left margin|\\
28 % |\backgroundcolor{r}[rgb]{0,0.7,0} % dark green for right margin|\\
29 % |\backgroundcolor{c[0]}[rgb]{1,0.8,1} % pink for colunmn-0|\\
30 % |\backgroundcolor{c[1]}[rgb]{1,1,0.8} % cream yellow for column-1|\\
31 % |\backgroundcolor{g}[rgb]{0.8,1,1} % light blue for the gap|\\
32 % |\backgroundcolor{f}[rgb]{0.8,0,1} % purple for page-wise floats|\\
33 % |\backgroundcolor{n}[rgb]{0.8,0.6,1} |
34 % |% light purple for page-wise footnotes|\\
35 % |\backgroundcolor{p}[rgb]{0.8,1,0.6} |
36 % |% pale green for pre/post-environment|\\
37 % |\backgroundcolor{s}[rgb]{0.8,0.8,0.8} % light gray for spanning texts|
38 % \end{itemize}
39 % 
40 % \SpecialUsageIndex{\backgroundcolor}
41 % 
42 % Therefore, the \bground{} of this |p|re-environment paragraph and other
43 % stuff above is painted by pale green.
44 % 
45 % \Index{pre-environment stuff}
46 % 
47 % Since the author set \Uidx{\!\pagerim!} to be 5\,|pt|, you will see
48 % unpainted strips of 5\,|pt| wide at all paper edges surrounding painted
49 % regions. For this and the next three pages, \Uidx{\!\twosided!}|[pcm]| is
50 % declared to enable |p|, |c| and |m| features but to disable the |b|
51 % feature. Therefore, though this page \pageref{sec:bgpaint} is even and
52 % thus the left outside margin is wider than the right inside one, the
53 % \bground{}s of |l|(eft) and |r|(ight) margins are painted by dark blue and
54 % dark green respectively.
55 % \par\bigskip
56 % 
57 % \begin{paracol}{2}
58 % This column-0 is now right and inside because of the |c| feature of
59 % \!\twosided! is enabled. On the other hand, the \bground{} is this column
60 % is painted by pink because \!\backgroundcolor! for |c[0]| specifies so.
61 % That is, the column ordinals optionally given to |c|(olumn) (and |g|(ap))
62 % regions are \emph{logical} ones not always corresponding to their
63 % \emph{physical} positions in a page.
64 %
65 % \switchcolumn
66 % \begingroup\it
67 % As explained in the right column-0, the \bground{} of this left and
68 % outside column-1 is painted by cream yellow as
69 % {\rm\!\backgroundcolor!|{c[1]}|} specifies. Now we have a
70 % {\rm\!\switchcolumn!|*|} with a \mctext{} to show the \bgpaint{} for
71 % it\footnote{
72 % 
73 % Since the footnotes in this \env{paracol} environment are \scfnote{} and
74 % \mgfnote{}, and \!\backgroundcolor!\texttt{\char`\{n\char`\}} specifies
75 % light purple, the \bground{} of this (foot)|n|(ote) region is painted by
76 % the color.}.
77 % 
78 % \par\endgroup
79 % \switchcolumn*[\subsection*{The background of this |s|(panning text)
80 % region is painted by light gray}\medskip]
81 %
82 % \begin{figure*}\nosv
83 % \def\arraystretch{0.8}
84 % \centerline{\begin{tabular}[b]{|c|}\hline
85 % \hbox to.9\textwidth{}\\
86 % \texttt{f}(loat) region for this page-wise figure is painted by purple\\
87 % \\\hline
88 % \end{tabular}}
89 % \caption{A Page-Wise Figure}
90 % \end{figure*}
91 %
92 % This paragraph is to show how the first line of a paragraph just below a
93 % \mctext{} is placed in the painted region.
94 % \par\vfill
95 %
96 % \switchcolumn
97 % \begingroup\it
98 % See the right column for the reason why this paragraph is here.
99 % \par\vfill
100 %
101 % See the right column for what we are now doing.
102 % \par\endgroup
103 % \switchcolumn
104 %
105 % Now we have a \!\flushpage! to see the \bgpaint{} for a material not shown
106 % in the page, i.e., a page-wise float.
107 % \flushpage
108 %
109 % Since we are now in an odd-numbered page \pageref{page:bgpaint2}, this
110 % column-0 is now a left one and is still painted by pink of course.
111 % \par\vfill\label{page:bgpaint2}
112 %
113 % This paragraph is to show how the last line of a page without \Scfnote{}s
114 % is placed in the painted region.
115 % \par\newpage
116 %
117 % This page is to show how the page without any \pwstuff{} looks like.
118 % \par\vfill
119 %
120 % Shortly we will close this \env{paracol} environment in the next page.
121 % \par\newpage
122 %
123 % Now we are closing this \env{paracol} environment to show how its
124 % \postenv{} is painted.
125 %
126 % \switchcolumn
127 % \begingroup\it
128 % As expected, the \bground{} of this column-1 is still painted by cream
129 % yellow.
130 % \par\vfill
131 %
132 % See the comment in the left column.
133 % \par\newpage
134 %
135 % See the right column for the reason why we have this almost blank page.
136 % \par\vfill
137 %
138 % See the right column for what will happen shortly.
139 % \par\newpage
140 %
141 % See the left column for the reason why we are now closing the environment.
142 % \endgroup
143 % \end{paracol}
144 % \bigskip
145 % 
146 % The \bground{} of this paragraph in |p|(ost-environment) region is also
147 % painted by pale green, because \postenv{} can be \preenv{} at the same
148 % time as we see shortly. \par\bigskip
149 %
150 % \begin{paracol}{2}
151 % This short \env{paracol} environment illustrates how the \preenv{} of this
152 % environment, or the \postenv{} of the last environment in other words, is
153 % painted.
154 %
155 % \switchcolumn
156 % \begingroup\it
157 % Therefore, the author does not have much to say in this column, except for
158 % giving a footnote here\footnote{
159 % 
160 % Since this footnote is \mgfnote{} with that in the \postenv{}, it is
161 % considered as a part of \postenv{} and thus painted by pale green rather
162 % than light purple.\label{fn:bgpaint1}}.
163 % \endgroup
164 % \end{paracol}
165 % \bigskip
166 %
167 % Before moving to the next example, one caution is given for \bgpaint{} of
168 % \Mgfnote{}s. As the footnote \ref{fn:bgpaint1} itself says, \Mgfnote{}s
169 % given in the \lpage{} of a \env{paracol} environment are considered as
170 % belonging to \postenv{}. Therefore, the footnote \ref{fn:bgpaint1} is
171 % painted by pale green as well as another footnote given now\footnote{
172 % 
173 % Since this footnote really belongs to \postenv{}, its \bground{} is painted
174 % by pale green naturally.}.
175 % \par\label{page:bgpaint4}
176 %
177 %
178 %
179 % \newpage
180 % \backgroundcolor{t(0pt,0pt)(0pt,-4pt)}[rgb]{0.7,0,0}
181 % \backgroundcolor{b(0pt,-4pt)(0pt,0pt)}[rgb]{0.8,0.6,0}
182 % \backgroundcolor{l(0pt,4pt)(-4pt,4pt)}[rgb]{0,0,0.7}
183 % \backgroundcolor{r(-4pt,4pt)(0pt,4pt)}[rgb]{0,0.7,0}
184 % \backgroundcolor{c[0](4pt,4pt)}[rgb]{1,0.8,1}
185 % \backgroundcolor{c[1](4pt,4pt)}[rgb]{1,1,0.8}
186 % \backgroundcolor{g(-4pt,4pt)}[rgb]{0.8,1,1}
187 % \backgroundcolor{f(4pt,4pt)(4pt,-4pt)}[rgb]{0.8,0,1}
188 % \backgroundcolor{n(4pt,-4pt)(4pt,4pt)}[rgb]{0.8,0.6,1}
189 % \backgroundcolor{p(4pt,4pt)}[rgb]{0.8,1,0.6}
190 % \backgroundcolor{s(4pt,-4pt)}[rgb]{0.8,0.8,0.8}
191 %
192 % \subsection{Mirrored Painting and Enlarging/Shrinking/Shifting Regions}
193 % \label{sec:bgpaint-me}
194 % \twosided
195 %
196 % At a glance, this and the next three pages look painted similarly to
197 % previous four pages, but by a careful examination you should notice
198 % two important differences. The first one is found in the colors
199 % of left and right margins. As the author enabled all features of
200 % \Uidx{\!\twosided!} including |b| for \mirror{}ing and we are now in an
201 % even-numbered page \pageref{sec:bgpaint-me}, the left and outside margin
202 % is painted by dark green for the region |r|(ight margin), while the right
203 % and inside one is painted by dark blue for |l|(eft margin).
204 %
205 % The other is that regions are enlarged, shrunk or shifted by 4\,|pt| by
206 % the following \!\backgroundcolor! commands with extensions.
207 % 
208 % \begin{itemize}\item[]
209 % |\backgroundcolor{t(0pt,0pt)(0pt,-4pt)}[rgb]{0.7,0,0} |
210 % |% B up|\\
211 % |\backgroundcolor{b(0pt,-4pt)(0pt,0pt)}[rgb]{0.8,0.6,0} |
212 % |% T down|\\
213 % |\backgroundcolor{l(0pt,4pt)(-4pt,4pt)}[rgb]{0,0,0.7} |
214 % |% R left T/B outside|\\
215 % |\backgroundcolor{r(-4pt,4pt)(0pt,4pt)}[rgb]{0,0.7,0} |
216 % |% L right T/B outside|\\
217 % |\backgroundcolor{c[0](4pt,4pt)}[rgb]{1,0.8,1} |
218 % |% all edges outside|\\
219 % |\backgroundcolor{c[1](4pt,4pt)}[rgb]{1,1,0.8} |
220 % |% all edges outside|\\
221 % |\backgroundcolor{g(-4pt,4pt)}[rgb]{0.8,1,1} |
222 % |% L/R inside & T/B outside|\\
223 % |\backgroundcolor{f(4pt,4pt)(4pt,-4pt)}[rgb]{0.8,0,1} |
224 % |% L/R outside & T/B up|\\
225 % |\backgroundcolor{n(4pt,-4pt)(4pt,4pt)}[rgb]{0.8,0.6,1} |
226 % |% L/R outside & T/B down|\\
227 % |\backgroundcolor{p(4pt,4pt)}[rgb]{0.8,1,0.6} |
228 % |% all edges outside|\\
229 % |\backgroundcolor{s(4pt,-4pt)}[rgb]{0.8,0.8,0.8} |
230 % |% L/R outside & T/B inside|
231 % \end{itemize}
232 % 
233 % \SpecialUsageIndex{\backgroundcolor}
234 % 
235 % In the comments above, |L|(eft), |R|(ight), |T|(op) and |B|(ottom) mean
236 % edges moved by a given extension. Therefore, for example,
237 % ``|L/R outside & T/B up|'' for |f|(loat) region means it is enlarged
238 % horizontally and shifted up vertically by the asymmetric extension
239 % |(4pt,4pt)(4pt,-4pt)|. These a little bit complicated setting of
240 % extensions are to solve the problems in the fundamental example shown in
241 % previous four pages, namely too strict definition of the regions to be
242 % painted. That is, both vertical edges of regions having texts, e.g.,
243 % |c|(olumn) regions, should look too close to the first and last letters.
244 % Similarly both horizontal edges of those regions seem too close especially
245 % when the first line is tall (e.g., the section title in
246 % p.\Tie\pageref{sec:bgpaint} and the page-wise figure in
247 % p.\Tie\pageref{page:bgpaint2}) and the last line of a column is followed by
248 % \mctext{} or \postenv. Therefore, the author made fine tuning moving
249 % inside edges of margins outside, and so on. We will come back this issue
250 % after exemplifying the effect of the tuning.
251 % \par\bigskip
252 % 
253 % \advance\skip\footins4pt\relax
254 % \begin{paracol}{2}
255 % By the tuning to enlarge this |c|(olumn) region, this paragraph has
256 % comfortable spaces above and below it, as well as at the both side edges.
257 %
258 % \switchcolumn
259 % \begingroup\it
260 % This paragraph is surrounded by spaces of a small but comfortable amount as
261 % well.\footnote{
262 % 
263 % Shifting this (foot)|n|(ote) region down a little bit, the space below this
264 % footnote and above the top edge of the |b|(ottom margin) region is enlarged.}.
265 % 
266 % \par\endgroup
267 % \switchcolumn*[\subsection*{The background of this |s|(panning text)
268 % region is painted by light gray and enlarged horizontally but shrunk
269 % vertically}\par\medskip]
270 %
271 % \begin{figure*}\nosv
272 % \def\arraystretch{0.8}
273 % \centerline{\begin{tabular}[b]{|c|}\hline
274 % \hbox to.9\textwidth{}\\
275 % shifting up this \texttt{f}(loat) region gives us a small space above
276 % the top edge of the rectangle\\
277 % \\\hline
278 % \end{tabular}}
279 % \caption{A Page-Wise Figure}
280 % \end{figure*}
281 %
282 % This paragraph is to show how well the first line of a paragraph just below a
283 % \mctext{} is separated from the boundary of two painted regions.
284 % \par\vfill
285 %
286 % \switchcolumn
287 % \begingroup\it
288 % See the right column for the reason why this paragraph is here.
289 % \par\vfill
290 %
291 % See the right column for what we are now doing.
292 % \par\endgroup
293 % \switchcolumn
294 %
295 % By enlarging this |c|(olumn) region and shift the (foot)|n|(ote) region
296 % down, this paragraph has a comfortable amount of space below it.
297 % \flushpage
298 %
299 % Similarly to other paragraphs below \pwstuff, this paragraph is well
300 % separated from the bottom edge of the |f|(loat) region above.
301 %
302 % \par\vfill\label{page:bgpaint-me2}
303 %
304 % As in the case of the line above \Scfnote{}s, the last line of this
305 % paragraph has a sufficient space separating it from the top edge of the
306 % |b|(ottom margin) region.
307 % \par\newpage
308 %
309 % This page is to show how the page without any \pwstuff{} looks like. As
310 % you are seeing, the space above this paragraph is sufficient and
311 % comfortable.
312 % \par\vfill
313 %
314 % Shortly we will close this \env{paracol} environment in the next page.
315 % \par\newpage
316 %
317 % Now we are closing this \env{paracol} environment to show how this
318 % paragraph is separated from the boundary of |c|(olumn) and
319 % |p|(ost-environment) regions.
320 %
321 % \switchcolumn
322 % \begingroup\it
323 % See the comment in the left column for the intention of placing this
324 % paragraph here.
325 % \par\vfill
326 %
327 % See the comment in the left column, too.
328 % \par\newpage
329 %
330 % See the right column for the reason why we have this almost blank page.
331 % \par\vfill
332 %
333 % See the right column for what will happen shortly.
334 % \par\newpage
335 %
336 % See the left column for the reason why we are now closing the environment.
337 % \endgroup
338 % \end{paracol}
339 % \bigskip
340 % 
341 % The \bground{} of this paragraph in |p|(ost-environment) region is
342 % painted by pale green as done in p.\Tie\pageref{page:bgpaint4}, but its top
343 % and bottom edges \emph{look} shifted down and up to give spaces below and
344 % above the last and first paragraphs in \env{paracol} environments,
345 % respectively.
346 % \par\bigskip
347 %
348 % \begin{paracol}{2}
349 % This short \env{paracol} environment illustrates how the \preenv{} of this
350 % environment, or the \postenv{} of the last environment in other words, is
351 % painted.
352 %
353 % \switchcolumn
354 % \begingroup\it
355 % Therefore, the author does not have much to say in this column, except for
356 % giving a footnote here\footnote{
357 % 
358 % As the footnote \ref{fn:bgpaint1} in p.\Tie\pageref{fn:bgpaint1}, this
359 % \Mgfnote{} is a part of \postenv{} and thus painted by pale green rather
360 % than light purple.\label{fn:bgpaint-me1}}.
361 % \endgroup
362 % \end{paracol}
363 % \bigskip
364 %
365 % In the setting with \!\backgroundcolor! commands in
366 % p.\Tie\pageref{sec:bgpaint-me}, the author carefully moved contacting edges
367 % of regions. For example, to enlarge |c|(olumn) regions, the inside edges
368 % of |l|(eft margin) and |r|(ight margin) regions are moved outside, and both
369 % vertical edges of the |g|(ap) region shifted toward its inside. As for
370 % the horizontal edges, the bottom edges of |t|(op margin) and |f|(loat)
371 % regions are moved up, the top edges of |b|(ottom margin) and
372 % (foot)|n|(ote) regions are moved down, and both top and bottom edges of
373 % the |s|(panning text) region are shifted toward its inside.
374 %
375 % These edge shifting could make a region too narrow or too much shifted
376 % resulting in a material in it overreaching its boundary, especially in
377 % vertical shifting of horizontal edges. However we can exploit some large
378 % space automatically or manually inserted above and/or below the material
379 % to avoid overreaching. That is the author exploited the following spaces;
380 % \!\headsep! below the page head (though it is empty in this document);
381 % \!\dbltextfloatsep! below the bottom-most page-wise float; spaces that
382 % \!\subsection!|*| inserts above and below it together with manually
383 % inserted \!\medskip! below it; \!\skip!\!\footins!\footnote{
384 % 
385 % This is a kind of ``length command'' maybe not widely known.}
386 % 
387 % above the first footnote which the author enlarged by 4\,|pt| temporarily
388 % for this and the next subsections; and \!\footskip! from the bottom edge
389 % of text area to that of the page number.
390 %
391 % Now you might notice that the explanation above does not mention the |p|
392 % region for \Preenv{} and \postenv. As you should find in the settings,
393 % this region is enlarged horizontally \emph{and vertically} so that its top
394 % and bottom edges are moved up and down when the region is at the top or
395 % bottom of a page, as you are seeing now and find in
396 % p.\Tie\pageref{sec:bgpaint-me}. However, this enlargement of course has a
397 % side effect that the region collides against |c|(olumn) and |g|(ap) regions
398 % also enlarged vertically making them overlapped. This overlap will be
399 % invisible with most of \emph{printers} because, as shown in
400 % Section\Tie\ref{sec:ref-bgpaint}, |p| region is painted \emph{before} |c|
401 % and |g| regions are painted. In addition, since relatively large spaces
402 % of \!\bigskip! are manually inserted before each \beginparacol{} and after
403 % each \Endparacol{}, texts in \Preenv{} and \postenv{} are well separated
404 % from region boundaries.
405 %
406 % This overlay painting |c| and |g| over |p|, however, might produce an
407 % unexpected result with some printer with which, for example, two colors
408 % are \emph{blended} in the thin overlapped strip\footnote{
409 % 
410 % For example, a dvi previewer |dviout| produces such a blended result with
411 % the default setting of coloring.}.
412 % 
413 % Unfortunately, this overlay painting is inevitable in the current version
414 % 1.3, but in a future version, hopefully 1.4, more sophisticated
415 % \emph{position-dependent} region definition, for example, to shift the top
416 % edge of |p| region only when the region is at the top of page, could be
417 % introduced.
418 %
419 % Another remark is that the \mirror{}ing specified by the |b| feature of
420 % \!\twosided! works not only on the colors of side margins but also on
421 % their asymmetric shrinkage. That is, the asymmetric shifts of vertical
422 % edges of |l| and |r| regions correctly performed irrespective of their
423 % physical positions, i.e., even when the |l| (resp.\ |r|) region is at
424 % the right (resp.\ left) margin and the edge to be shift is the left
425 % (resp.\ right) one rather than right (resp.\ left).
426 %
427 %
428 %
429 % \newpage \suppressfloats
430 % \nobackgroundcolor{t}
431 % \nobackgroundcolor{b}
432 % \nobackgroundcolor{l}
433 % \nobackgroundcolor{r}
434 % \nobackgroundcolor{g}
435 % \backgroundcolor{c[0](4pt,4pt)(0.5\columnsep,4pt)}[rgb]{1,0.8,1}
436 % \backgroundcolor{c[1](0.5\columnsep,4pt)(4pt,4pt)}[rgb]{1,1,0.8}
437 % \backgroundcolor{C[0](10000pt,10000pt)(0.5\columnsep,10000pt)}[rgb]{1,0.8,1}
438 % \backgroundcolor{C[1](0.5\columnsep,10000pt)(10000pt,10000pt)}[rgb]{1,1,0.8}
439 %
440 % \subsection{Regions with Infinite Extensions}
441 % \label{sec:bgpaint-inf}
442 %
443 % You are now seeing another \bgpaint{} much different from previous two
444 % examples. That is, after disabling painting of |t|, |b|, |l|, |r| and |g|
445 % regions by \Uidx{\!\nobackgroundcolor!}, the author gave the followings
446 % for painting this and the next pages.
447 % 
448 % \begin{itemize}\item[]
449 % |\backgroundcolor|
450 % |{c[0](4pt,4pt)(0.5\columnsep,4pt)}[rgb]{1,0.8,1}|\\
451 % |\backgroundcolor|
452 % |{c[1](0.5\columnsep,4pt)(4pt,4pt)}[rgb]{1,1,0.8}|\\
453 % |\backgroundcolor|
454 % |{C[0](10000pt,10000pt)(0.5\columnsep,10000pt)}[rgb]{1,0.8,1}|\\
455 % |\backgroundcolor|
456 % |{C[1](0.5\columnsep,10000pt)(10000pt,10000pt)}[rgb]{1,1,0.8}|
457 % \end{itemize}
458 % 
459 % \SpecialUsageIndex{\backgroundcolor}
460 % 
461 % The first two lines above is different from the previous declaration
462 % because inside edges of |c[0]| and |c[1]| regions are shifted toward
463 % outside of them and thus inside of unpainted |g| region so that the edges
464 % are contacted. On the other hand, the last two lines are for
465 % \emph{under-painting} of columns and has \emph{\bginfext} to make top,
466 % bottom and outside edges of |C| regions reaching to the corresponding
467 % paper edges. Since this under-painting is done with colors same as those
468 % of over-painting of |c| regions, you will have an impression that the
469 % paper is two-toned and \pwstuff{} are pasted on the paper\footnote{
470 % 
471 % This footnote is given outside \env{paracol} environment but its
472 % \bground{} is painted by light purple because it is merged with the
473 % footnote \ref{fn:bgpaint-inf2}.\label{fn:bgpaint-inf1}}.
474 % 
475 % \par\bigskip
476 % 
477 % \begin{figure}\nosv
478 % \def\arraystretch{0.8}
479 % \centerline{\begin{tabular}[b]{|c|}\hline
480 % \hbox to.9\textwidth{}\\
481 % \parbox{.8\textwidth}{
482 % This \texttt{f}(loat) region could be extended to both side edges
483 % and the top edge of the paper if its extension were
484 % \texttt{(10000pt,10000pt)(10000pt,-4pt)}.}\\
485 % \\\hline
486 % \end{tabular}}
487 % \caption{A Page-Wise Figure \emph{Imported} from Pre-Environment}
488 % \label{fig:bgpaint-inf}
489 % \end{figure}
490 % 
491 % \begin{paracol}{2}
492 % Though you cannot see, the right edge of this over-painted |c[0]| region
493 % is shifted right by 4\,|pt| to hide the small patch at the right bottom
494 % corner of the |p| region above by overlaying.
495 %
496 % \switchcolumn
497 % \begingroup\it
498 % As explained in the right column, this {\rm|c[1]|} region also has an
499 % invisible left edge shifted left by {\rm4\,|pt|}\footnote{
500 % 
501 % This (foot)|n|(ote) region could be extended to both side edges and the
502 % bottom edge of the paper if its extension were
503 % \texttt{(10000pt,-4pt)(10000pt,10000pt)}.\label{fn:bgpaint-inf2}}.
504 % \endgroup
505 %
506 % \switchcolumn*[\subsection*{This \texttt{s}(panning text) region could be
507 % extended to both side edges of the paper if its extension were
508 % \texttt{(10000pt,-4pt)}.}\par\medskip]
509 %
510 % The author does not have much to say now for this column chunk.
511 % \par\vfill
512 %
513 % Still nothing to say particular to the page break we will have shortly.
514 % \par\newpage
515 %
516 % This paragraph is just for keeping the \env{paracol} environment alive in
517 % this page.
518 % \switchcolumn
519 %
520 % \begingroup\it
521 % Little to say as well.
522 % \par\vfill
523 %
524 % Nothing to say as well.
525 % \par\newpage
526 %
527 % This paragraph is not necessary for keeping alive the environment but is
528 % given for consistent view.
529 % \endgroup
530 %
531 % \begin{figure*}\nosv
532 % \def\arraystretch{0.8}
533 % \centerline{\begin{tabular}[b]{|c|}\hline
534 % \hbox to.9\textwidth{}\\
535 % \parbox{.8\textwidth}{
536 % This figure is given in the \env{paracol} environment closed in the
537 % previous page but its background is not painted.}\\
538 % \\\hline
539 % \end{tabular}}
540 % \caption{A Page-Wise Figure \emph{Exported} to Post-Environment}
541 % \label{fig:bgpaint-inf2}
542 % \end{figure*}
543 % \end{paracol}
544 % \bigskip
545 %
546 % Note that overlay painting is inevitable for two-toned page painting, as
547 % far as you want to paint \bground{} of \pwstuff.
548 %
549 % The last issue of \bgpaint{} is about painting materials given outside
550 % \env{paracol}. As you have seen, \Preenv{} and \postenv{} are painted but
551 % it is done only when they reside in a page having a portion of a
552 % \env{paracol} environment (maybe) of course. Therefore, the next page is
553 % \emph{not} painted because the page does not have any parallel-columned
554 % stuff. Therefore, even if you wish to paint the whole of your document
555 % including pages without \env{paracol} stuff, you cannot do it just with
556 % \Paracol{} package, at least so far.
557 %
558 % On the other hand, some materials given outside \env{paracol} environments
559 % are painted as if they are given in the environment when they are
560 % \emph{imported} into the environment. One category has footnotes given in
561 % \preenv{} when \!\footnoteplacement!|{m}| is specified for merging, as
562 % exemplified by the footnote \ref{fn:bgpaint-inf1} in the previous page.
563 % Note that such a footnote is painted by the color for |n| region rather
564 % than |p| region even when there are no footnotes in the \env{paracol}
565 % environment. The other category has ordinary floats given by \env{figure}
566 % and/or \env{table}
567 % (i.e., neither \env{figure*} nor \env{table*}) environments outside
568 % \env{paracol} and then \emph{deferred} to a page having (a portion of)
569 % stuff produced by \env{paracol}. Since such a float, e.g.,
570 % Figure\Tie\ref{fig:bgpaint-inf} in this page, is considered as a page-wise
571 % float given in the \env{paracol} environment in this section, its
572 % background is painted by the color for the |f| region, rather than that
573 % for the |p| region which would be used if the float were is placed in the
574 % previous page. Note that such a deferred float import could occur not
575 % only from the page having \beginparacol{} but also from pages preceding
576 % it. For example, if you have three \env{figure} environments in a page
577 % $p-1$ just preceding the page $p$ in which you start a \env{paracol}
578 % environment, it could happen that first one is placed in $p-1$ without
579 % painting, the second is placed in $p$ and painted by the color for |p|,
580 % and the third is placed in $p+1$ and painted by the color for |f|.
581 %
582 % Finally some materials \emph{exported} from a \env{paracol} environment
583 % are painted as if they are in \postenv. In previous two subsections, we
584 % saw \Mgfnote{}s (e.g., \ref{fn:bgpaint1} in p.\Tie\pageref{fn:bgpaint1}
585 % and \ref{fn:bgpaint-me1} in p.\Tie\pageref{fn:bgpaint-me1}) are painted by
586 % the color of |p| rather than |n|. The other kind of exportation is of
587 % page-wise floats given in a \env{paracol} environment but deferred to the
588 % page next to the page having \Endparacol, or further. For example,
589 % Figure~\ref{fig:bgpaint-inf2} is given in the \env{paracol} environment
590 % above in this page, but its \bground{} is not painted because the next page
591 % in which the figure is placed does not have any parallel-columned
592 % stuff\footnote{
593 % 
594 % If it has, the background is painted by the color for |p|.}.
595 % 
596 % \newpage\vspace*{\fill}
597 % \centerline{(intentionally blanked page to show this page is \emph{not}
598 % painted)}
599 % \vfill
600 % \advance\skip\footins-4pt\relax
601 % \endinput