diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/l3experimental/l3draw/l3draw.dtx')
-rw-r--r-- | Master/texmf-dist/source/latex/l3experimental/l3draw/l3draw.dtx | 81 |
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} |