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.dtx81
1 files changed, 49 insertions, 32 deletions
diff --git a/Master/texmf-dist/source/latex/l3experimental/l3draw/l3draw.dtx b/Master/texmf-dist/source/latex/l3experimental/l3draw/l3draw.dtx
index 7cefc6d837d..618860c7279 100644
--- a/Master/texmf-dist/source/latex/l3experimental/l3draw/l3draw.dtx
+++ b/Master/texmf-dist/source/latex/l3experimental/l3draw/l3draw.dtx
@@ -109,7 +109,7 @@
% }^^A
% }
%
-% \date{Released 2018/03/05}
+% \date{Released 2018-04-30}
%
% \maketitle
%
@@ -165,6 +165,14 @@
% drawing using |\int_step_function:nnnn| or similar. On the other hand,
% text should not be included directly in drawings, but should rather be
% inserted using the appropriate \pkg{l3draw} command.
+%
+% The drawing environment sets the following standard behaviors
+% \begin{itemize}
+% \item Non-zero rule for fill overlaps
+% \item Butt caps for lines
+% \item Mitering for line joins with a miter factor of $10$
+% \item Solid line strokes
+% \end{itemize}
% \end{function}
%
% Within a drawing, there are different ways of referring to a position.
@@ -218,7 +226,7 @@
% of every drawing (\cs{draw_begin:}).
% \end{variable}
%
-% \begin{function}{\draw_linewidth:n, \draw_inner_linewidth:n}
+% \begin{function}{\draw_linewidth:n}
% \begin{syntax}
% \cs{draw_linewidth:n} \Arg{width}
% \end{syntax}
@@ -226,6 +234,44 @@
% \meta{fp expr}).
% \end{function}
%
+% \begin{function}{\draw_dash_pattern:nn}
+% \begin{syntax}
+% \cs{draw_dash_pattern:nn} \Arg{pattern} \Arg{phase}
+% \end{syntax}
+% Specifies a dash pattern. The \meta{pattern} itself is a comma-separated
+% list of entries which represent the \enquote{on} and \enquote{off}
+% parts of the line. These are all \meta{fp expr} and repeat as required.
+% Thus the \meta{pattern} may be of arbitrary length. The \meta{phase}
+% specifies where during the first \enquote{on} line the pattern should
+% start.
+% \begin{demo}
+% \draw_begin:
+% \draw_dash_pattern:nn
+% { 0.5cm , 0.5cm , 0.1cm , 0.2cm }
+% { 0cm }
+% \draw_path_moveto:n { 0cm , 0cm }
+% \draw_path_lineto:n { 2cm , 0cm }
+% \draw_path_use_clear:n { stroke }
+% \draw_dash_pattern:nn
+% { 0.5cm , 0.5cm , 0.1cm , 0.2cm }
+% { 0.1cm }
+% \draw_path_moveto:n { 0cm , 1mm }
+% \draw_path_lineto:n { 2cm , 1mm }
+% \draw_path_use_clear:n { stroke }
+% \draw_dash_pattern:nn
+% { 0.5cm , 0.5cm , 0.1cm , 0.2cm }
+% { 0.2cm }
+% \draw_path_moveto:n { 0cm , 2mm }
+% \draw_path_lineto:n { 2cm , 2mm }
+% \draw_path_use_clear:n { stroke }
+% \draw_end:
+% \end{demo}
+% Setting an empty pattern will produce a solid line.
+%
+% Note the \meta{pattern} interface here is different from that in \pkg{pgf}:
+% the list is comma-separated not given in brace groups.
+% \end{function}
+%
% \begin{function}{\draw_nonzero_rule:, \draw_evenodd_rule:}
% \begin{syntax}
% \cs{draw_nonzero_rule:}
@@ -355,14 +401,6 @@
%
% \subsubsection{Basic point functions}
%
-% \begin{function}[EXP]{\draw_point:nn}
-% \begin{syntax}
-% \cs{draw_point:nn} \Arg{x} \Arg{y}
-% \end{syntax}
-% Gives the co-ordinates of the point at \meta{x} and \meta{y}, both of
-% which are \meta{fp expr}.
-% \end{function}
-%
% \begin{function}[EXP]{\draw_point_polar:nn, \draw_point_polar:nnn}
% \begin{syntax}
% \cs{draw_point_polar:nn} \Arg{angle} \Arg{radius}
@@ -377,27 +415,6 @@
% whilst in \pkg{pgf} they use the same function and a keyword.
% \end{function}
%
-% \begin{function}[EXP]{\draw_point_add:nn}
-% \begin{syntax}
-% \cs{draw_point_add:nn} \Arg{point1} \Arg{point2}
-% \end{syntax}
-% Adds \meta{point1} to \meta{point2}.
-% \end{function}
-%
-% \begin{function}[EXP]{\draw_point_diff:nn}
-% \begin{syntax}
-% \cs{draw_point_diff:nn} \Arg{point1} \Arg{point2}
-% \end{syntax}
-% Subtracts \meta{point1} from \meta{point2}.
-% \end{function}
-%
-% \begin{function}[EXP]{\draw_point_scale:nn}
-% \begin{syntax}
-% \cs{draw_point_scale:nn} \Arg{scale} \Arg{point}
-% \end{syntax}
-% Scales the \meta{point} by the \meta{scale} (an \meta{fp expr}).
-% \end{function}
-%
% \begin{function}[EXP]{\draw_point_unit_vector:n}
% \begin{syntax}
% \cs{draw_point_unit_vector:n} \Arg{point}
@@ -1089,7 +1106,7 @@
%
% \begin{macrocode}
%<*package>
-\ProvidesExplPackage{l3draw}{2018/03/05}{}
+\ProvidesExplPackage{l3draw}{2018-04-30}{}
{L3 Experimental core drawing support}
%</package>
% \end{macrocode}