diff options
author | Karl Berry <karl@freefriends.org> | 2019-05-03 22:30:06 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2019-05-03 22:30:06 +0000 |
commit | 6c87d764952f4d6eb0d273c68f6033a0b5536fdb (patch) | |
tree | 548aa554eae6bc4f978cd66f64ab45874a3d3bd5 /Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx | |
parent | 5139fa11fc380bdb1d620afffda047044c55ef7a (diff) |
l3 (3may19)
git-svn-id: svn://tug.org/texlive/trunk@50972 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx')
-rw-r--r-- | Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx | 81 |
1 files changed, 76 insertions, 5 deletions
diff --git a/Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx b/Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx index 687f8c93dd8..04a731183ae 100644 --- a/Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx +++ b/Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx @@ -43,7 +43,7 @@ % }^^A % } % -% \date{Released 2019-04-21} +% \date{Released 2019-05-03} % % \maketitle % @@ -439,7 +439,7 @@ % % \begin{function}{\driver_draw_box_use:Nnnnn} % \begin{syntax} -% \cs{driver_draw_box:Nnnnnnn} \meta{box} +% \cs{driver_draw_box_use:Nnnnn} \meta{box} % \Arg{a} \Arg{b} \Arg{c} \Arg{d} \Arg{x} \Arg{y} % \end{syntax} % Inserts the \meta{box} as an hbox with the box reference point placed @@ -447,8 +447,9 @@ % to the box, allowing it to be in synchronisation with any scaling, rotation % or skewing applying more generally. Note that \TeX{} material should not % be inserted directly into a drawing as it would not be in the correct -% location. Also note that as for other drawing elements the box here -% has no size from a \TeX{} perspective. +% location. Also note that this function must be used inside a box of zero +% size, shifted appropriately for the correct result; a low-level engine +% error may result if this is not the case. % \end{function} % % \subsection{Coordinate system transformations} @@ -492,6 +493,9 @@ % \cs{driver_pdf_link_begin_user:nnw} \Arg{attributes} \Arg{action} % \Arg{content} % \cs{driver_pdf_link_end:} +% \cs{driver_pdf_link_begin_goto:nnw} \Arg{attributes} \Arg{target} +% \Arg{content} +% \cs{driver_pdf_link_end:} % \end{syntax} % Creates a link of the \meta{type} |goto| or |user| with the given % \meta{attributes}, points toward the \meta{action} and surround the @@ -514,7 +518,74 @@ % Sets the length of the margin between content and the border of a link. % Different back-ends treat the scoping of this value in different ways: % \pdfTeX{} and \LuaTeX{} treat it as scoped by \TeX{}, whilst with -% \texttt{dvips} the scope is managed at the PostScript level. +% \texttt{dvips} the scope is managed at the PostScript level. For +% \texttt{(x)dvipdfmx}, this setting applies to \emph{all} annotations +% (\emph{i.e.}~it is global), and thus it may be necessary to set to +% \texttt{0pt} to avoid breaking for example animations. +% \end{function} +% +% \begin{function}[added = 2019-04-26]{\driver_pdf_destination:nn} +% \begin{syntax} +% \cs{driver_pdf_destination:nn} \Arg{name} \Arg{action} +% \end{syntax} +% Creates a destination (anchor) called \meta{name}; when a jump is made +% by a link to the destination, one of the following actions may take +% place +% \begin{itemize} +% \item \texttt{xyz} Move the view such that the target point is at the +% top-left of the viewer screen +% \item \texttt{\meta{scale}} As for \texttt{xyz}, but also sets the +% viewer \meta{scale} +% \item \texttt{fit} Display the page containing the destination and fit +% the entire page within the viewer window +% \item \texttt{fitb} Display the page containing the destination and fit +% the bounding box of the page within the viewer window +% \item \texttt{fitbh} Move to the destination page such that the +% anchor point is at the top of the viewer screen, and scale +% such that the bounding box fills the viewer width +% \item \texttt{fitbv} Move to the destination page such that the +% anchor point is at the left of the viewer screen, and scale +% such that the bounding box fills the viewer height +% \item \texttt{fith} Move to the destination page such that the +% anchor point is at the top of the viewer screen, and scale +% such that the page fills the viewer width +% \item \texttt{fitv} Move to the destination page such that the +% anchor point is at the left of the viewer screen, and scale +% such that the page fills the viewer height +% \end{itemize} +% A \meta{scale} of zero is equivalent to \texttt{xyz}. +% \end{function} +% +% \begin{function}[added = 2019-04-28]{\driver_pdf_destination_rectangle:nn} +% \begin{syntax} +% \cs{driver_pdf_destination_rectangle:nn} \Arg{name} \Arg{content} +% \end{syntax} +% Creates a destination (anchor) called \meta{name}; when a jump is made +% by a link to the destination, the viewer will set the zoom such that all +% of the \meta{content} is visible taking up the full width or height of the +% viewer area. +% \end{function} +% +% \subsection{PDF Catalogue entries} +% +% \begin{function}[added = 2019-04-28]{\driver_pdf_catalog_gput:nn} +% \begin{syntax} +% \cs{driver_pdf_catalog_gput:nn} \Arg{key} \Arg{value} +% \end{syntax} +% Adds the key--value pair to the PDF catalog. The \meta{key} should +% be given \emph{without} the leading |/|. The \meta{value} should be +% a \enquote{raw} PDF dictionary entry, including the |(|/|)| pair for +% a string, a leading |/| for a boolean, \emph{etc.} +% \end{function} +% +% \begin{function}[added = 2019-04-28]{\driver_pdf_info_gput:nn} +% \begin{syntax} +% \cs{driver_pdf_info_gput:nn} \Arg{key} \Arg{value} +% \end{syntax} +% Adds the key--value pair to the PDF information. The \meta{key} should +% be given \emph{without} the leading |/|. The \meta{value} should be +% a \enquote{raw} PDF dictionary entry, including the |(|/|)| pair for +% a string or leading |/| for a boolean. % \end{function} % % \subsection{PDF Objects} |