summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/l3experimental/l3draw/l3draw.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/l3experimental/l3draw/l3draw.dtx')
-rw-r--r--Master/texmf-dist/source/latex/l3experimental/l3draw/l3draw.dtx54
1 files changed, 45 insertions, 9 deletions
diff --git a/Master/texmf-dist/source/latex/l3experimental/l3draw/l3draw.dtx b/Master/texmf-dist/source/latex/l3experimental/l3draw/l3draw.dtx
index 90e9b27e28b..73ed6390dcd 100644
--- a/Master/texmf-dist/source/latex/l3experimental/l3draw/l3draw.dtx
+++ b/Master/texmf-dist/source/latex/l3experimental/l3draw/l3draw.dtx
@@ -111,7 +111,7 @@
% }^^A
% }
%
-% \date{Released 2019-01-28}
+% \date{Released 2019-03-05}
%
% \maketitle
%
@@ -941,7 +941,7 @@
% \end{demo}
% \begin{demo}
% \draw_begin:
-% \draw_transform_matrix:nnnn { 2 } { 0 } { 1 } { 2 }
+% \draw_transform_matrix_absolute:nnnn { 2 } { 0 } { 1 } { 2 }
% \draw_path_moveto:n { 0cm , 0cm }
% \draw_path_lineto:n { 0cm , 1cm }
% \draw_path_use_clear:n { stroke }
@@ -991,23 +991,24 @@
% is transparent to the drawing code so is not tracked.
%
% \begin{function}
-% {\draw_transform_matrix:nnnn, \draw_transform_matrix_concat:nnnn}
+% {\draw_transform_matrix:nnnn, \draw_transform_matrix_absolute:nnnn}
% \begin{syntax}
% \cs{draw_transform_matrix:nnnn}
% \Arg{a} \Arg{b} \Arg{c} \Arg{d}
% \end{syntax}
% Applies the transformation matrix $[ \meta{a} \meta{b} \meta{c} \meta{d}]$.
-% The basic version over-writes the current matrix, the |concat| version
-% concatenates.
+% The basic applies the transformation in addition to those active; the
+% |absolute| version overwrites any active transformation.
% This assignment is local.
% \end{function}
%
-% \begin{function}{\draw_transform_shift:n, \draw_transform_shift_concat:n}
+% \begin{function}{\draw_transform_shift:n, \draw_transform_shift_absolute:n}
% \begin{syntax}
% \cs{draw_transform_shift:n} \Arg{vector}
% \end{syntax}
-% Applies the transformation \meta{vector} to points. The basic version
-% over-writes the current vector, the |concat| version concatenates.
+% Applies the transformation \meta{vector} to points.
+% The basic applies the vector in addition to those active; the
+% |absolute| version overwrites any active vector.
% This assignment is local.
% \end{function}
%
@@ -1091,6 +1092,41 @@
% This assignment is local.
% \end{function}
%
+% \subsection{Layers}
+%
+% Drawing layers may be used to alter the way in which elements are stacked
+% on top of one another. In particular, they are useful when the nature of
+% an element depends on another, but where it needs to be behind it's
+% \enquote{parent}. A classic example is a filled background: this needs to
+% know the size of the material it is behind.
+%
+% All drawings feature a layer called |main|. This layer should always be
+% present, and is the one which \enquote{non-layered} content is added to.
+%
+% \begin{function}{\draw_layer_new:n}
+% \begin{syntax}
+% \cs{draw_layer_new:n} \Arg{layer}
+% \end{syntax}
+% Creates a new \meta{layer} which can then be used in drawing. The layer
+% |main| is pre-defined.
+% \end{function}
+%
+% \begin{function}{\draw_layer_begin:n, \draw_layer_end:}
+% \begin{syntax}
+% \cs{draw_layer_begin:n} \Arg{layer}
+% ...
+% \cs{draw_layer_end:}
+% \end{syntax}
+% Begin and end collection of material for the \meta{layer}, which should
+% previously have been created (and which cannot be |main|). Material
+% collected for the layer is available globally within the current drawing.
+% \end{function}
+%
+% \begin{variable}{\l_draw_layers_clist}
+% The list of active layers: may be given anywhere before \cs{draw_end:}.
+% The |main| layer should always be included.
+% \end{variable}
+%
% \end{documentation}
%
% \begin{implementation}
@@ -1107,7 +1143,7 @@
%
% \begin{macrocode}
%<*package>
-\ProvidesExplPackage{l3draw}{2019-01-28}{}
+\ProvidesExplPackage{l3draw}{2019-03-05}{}
{L3 Experimental core drawing support}
%</package>
% \end{macrocode}