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