[latex3-commits] [l3svn] 02/02: Basic set up for page colour

[noreply at latex-project.org]

This is an automated email from the git hooks/post-receive script.

joseph pushed a commit to branch master
in repository l3svn.

commit e97e9a011a580f8ea771acf789947a0f97fd7c8f
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Tue Oct 24 14:16:37 2017 +0100

    Basic set up for page colour
    
    The driver level still needs to be sorted: that is complex as it
    interacts with the output routine. Probably the 2e approach will be very
    different from the L3 one.
---
 l3trial/l3color-extras/l3color-extras.dtx |   46 +++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/l3trial/l3color-extras/l3color-extras.dtx b/l3trial/l3color-extras/l3color-extras.dtx
index 69ec3b6..161e6c9 100644
--- a/l3trial/l3color-extras/l3color-extras.dtx
+++ b/l3trial/l3color-extras/l3color-extras.dtx
@@ -215,6 +215,23 @@
 %   and similar are not influenced by this setting.
 % \end{variable}
 %
+% \begin{function}{\color_page:n}
+%   \begin{syntax}
+%     \cs{color_page:n} \Arg{color expression}
+%   \end{syntax}
+%   Parses the \meta{color expression} and then activates the resulting
+%   color specification for the page background.
+% \end{function}
+%
+% \begin{function}{\color_page_clear:}
+%   \begin{syntax}
+%     \cs{color_page:}
+%   \end{syntax}
+%   Deactivates any coloring of the current page. Note that this is different
+%   from selecting a (typically) white color for the page: clearing the page
+%   color means that no ink is selected at all.
+% \end{function}
+%
 % \section{Spot colors}
 % \label{l3color:sec:spot}
 %
@@ -777,6 +794,35 @@
 %    \end{macrocode}
 % \end{variable}
 %
+% \subsection{Page color}
+%
+% \begin{variable}{\l_@@_page_tl}
+%   Space to track the page color. Notice that page color is a global property
+%   but that is tracked at the level of specials: from the point of view of
+%   \pkg{expl3} code there is no need to hold this information.
+%    \begin{macrocode}
+\tl_new:N \l_@@_page_tl
+%    \end{macrocode}
+% \end{variable}
+%
+% \begin{macro}{\color_page:n}
+% \begin{macro}{\color_page_clear:}
+%   Set and clear the page color: mainly a job for the driver level.
+%    \begin{macrocode}
+\cs_new_protected:Npn \color_page:n #1
+  {
+    \@@_parse:nN {#1} \l_@@_page_tl
+    \@@_finalise:N \l_@@_page_tl
+    \__driver_color_page:V \l_@@_page_tl
+  }
+\cs_new_protected:Npn \color_page_clear:
+  {
+    \__driver_color_page:n { }
+  }
+%    \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
 % \subsection{Diagnostics}
 %
 % \begin{macro}{\color_show:n}

-- 
To stop receiving notification emails like this one, please contact
the administrator of this repository.