diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx')
-rw-r--r-- | Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx | 72 |
1 files changed, 37 insertions, 35 deletions
diff --git a/Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx b/Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx index d2449c5cb94..5cf76d9b972 100644 --- a/Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx +++ b/Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx @@ -1,5 +1,5 @@ % \iffalse meta-comment -% +% %% File: l3drivers.dtx Copyright(C) 2011 The LaTeX3 Project %% %% It may be distributed and/or modified under the conditions of the @@ -36,7 +36,7 @@ % %<*driver> \RequirePackage{l3names} -\GetIdInfo$Id: l3drivers.dtx 2717 2011-09-03 13:40:31Z joseph $ +\GetIdInfo$Id: l3drivers.dtx 2776 2011-09-07 18:33:19Z joseph $ {L3 Experimental drivers} %</driver> %<*driver> @@ -46,13 +46,13 @@ \end{document} %</driver> % \fi -% +% % \title{^^A % The \textsf{l3drivers} package\\ Drivers^^A % \thanks{This file describes v\ExplFileVersion, % last revised \ExplFileDate.}^^A % } -% +% % \author{^^A % The \LaTeX3 Project\thanks % {^^A @@ -67,7 +67,7 @@ % \maketitle % % \begin{documentation} -% +% % \TeX{} relies on drivers in order to carry out a number of tasks, such % as using colour, including graphics and setting up hyper-links. The nature % of the code required depends on the exact driver in use. Currently, @@ -80,16 +80,17 @@ % \pdfTeX{} or \LuaTeX{} in DVI mode. % \item \texttt{xdvipdfmx}: The driver used by \XeTeX{}. % \end{itemize} -% +% % The code here is all very low-level, and should not in general be used % outside of the kernel. It is also important to note that many of the % functions here are closely tied to the immediate level \enquote{up}: % several variable values must be in the correct locations for the driver % code to function. -% +% % \section{Box rotation and scaling} -% -% \begin{function}{\driver_box_rotate_begin:, \driver_box_rotate_end:} +% +% \begin{function}[added = 2011-09-01] +% {\driver_box_rotate_begin:, \driver_box_rotate_end:} % \begin{syntax} % \cs{driver_box_rotate_begin:} % \cs{box_use:N} \cs{l_box_tmp_box} @@ -103,8 +104,9 @@ % and end markers will be stored in \cs{l_box_tmp_box}: this fact is % required by some drivers to obtain the correct output. % \end{function} -% -% \begin{function}{\driver_box_scale_begin:, \driver_box_scale_end:} +% +% \begin{function}[added = 2011-09-02] +% {\driver_box_scale_begin:, \driver_box_scale_end:} % \begin{syntax} % \cs{driver_box_scale_begin:} % \meta{box material} @@ -118,32 +120,32 @@ % supported and so the higher-level code must convert the absolute sizes % to scale factors. % \end{function} -% +% % \section{Colour support} -% -% \begin{function}{\driver_color_ensure_current:} +% +% \begin{function}[added = 2011-09-03]{\driver_color_ensure_current:} % \begin{syntax} % \cs{driver_color_ensure_current:} % \end{syntax} % Ensures that the colour used to typeset material is that which was % set when the material was placed in a box. This function is therefore % required inside any \enquote{colour safe} box to ensure that the box may -% be inserted in a location where the foreground colour has been altered, +% be inserted in a location where the foreground colour has been altered, % while preserving the colour used in the box. % \end{function} -% +% % \end{documentation} % % \begin{implementation} % % \section{\pkg{l3drivers} Implementation} -% +% % \begin{macrocode} %<*initex> % \end{macrocode} -% +% % \subsection{Settings for direct PDF output} -% +% % If the driver loaded is \texttt{pdfmode} then direct PDF output is required. % (This may of course alter: it might be that the driver is picked based on the % value of \cs{pdfmode_pdfoutput:D}.) @@ -168,7 +170,7 @@ \pdftex_pdfobjcompresslevel:D = 2 \scan_stop: %</pdfmode> % \end{macrocode} -% +% % \subsection{Box rotation and scaling} % % \begin{variable}{\l_driver_box_matrix_tl} @@ -179,7 +181,7 @@ %</pdfmode> % \end{macrocode} % \end{variable} -% +% % \begin{variable}{\l_driver_tmp_fp} % Needed for a safe sign inversion in PDF mode. % \begin{macrocode} @@ -188,7 +190,7 @@ %</pdfmode> % \end{macrocode} % \end{variable} -% +% % \begin{macro}{\driver_box_rotate_begin:, \driver_box_rotate_end:} % Systems which require only the rotation angle have simple drivers. % On the other hand, in PDF mode the affine transformation matrix is @@ -210,10 +212,10 @@ %</dvips> %<*pdfmode> \fp_set_eq:NN \l_driver_tmp_fp \l_box_sin_fp - \fp_neg:N \l_driver_tmp_fp + \fp_neg:N \l_driver_tmp_fp \tl_set:Nx \l_driver_box_matrix_tl - { - \fp_use:N \l_box_cos_fp \c_space_tl + { + \fp_use:N \l_box_cos_fp \c_space_tl \fp_use:N \l_box_sin_fp \c_space_tl \fp_use:N \l_driver_tmp_fp \c_space_tl \fp_use:N \l_box_cos_fp @@ -242,10 +244,10 @@ %</xdvipdfmx> % \end{macrocode} % \end{macro} -% +% % \begin{macro}{\driver_box_scale_begin:, \driver_box_scale_end:} % Scaling is not dissimilar to rotation, but the calculations are somewhat -% less complex. +% less complex. % \begin{macrocode} \cs_new_protected_nopar:Npn \driver_box_scale_begin: { @@ -262,8 +264,8 @@ %</dvips> %<*pdfmode> \tl_set:Nx \l_driver_box_matrix_tl - { - \fp_use:N \l_box_scale_x_fp \c_space_tl + { + \fp_use:N \l_box_scale_x_fp \c_space_tl 0 ~ 0 ~ \fp_use:N \l_box_scale_y_fp } @@ -293,7 +295,7 @@ 1~\fp_use:N \l_box_scale_y_fp \c_space_tl div~ scale~neg~exch~neg~exch~ translate - } + } } %</dvips> %<*pdfmode> @@ -304,9 +306,9 @@ %</xdvipdfmx> % \end{macrocode} % \end{macro} -% +% % \subsection{Colour support} -% +% % \begin{variable}{\l_driver_current_color_tl} % The current colour is needed by all of the engines, but the way this % is stored varies. @@ -333,13 +335,13 @@ %</pdfmode> % \end{macrocode} % \end{variable} -% +% % \begin{macro}{\driver_color_group_begin:, \driver_color_group_end:} % \begin{macrocode} % \end{macrocode} % \end{macro} -% +% % \begin{macro}{\driver_color_ensure_current:} % \begin{macro}[aux]{\driver_color_reset:} % Setting the current colour depends on the nature of the colour stack @@ -374,4 +376,4 @@ % % \end{implementation} % -% \PrintIndex
\ No newline at end of file +% \PrintIndex |