[latex3-commits] [git/LaTeX3-latex3-latex3] pdf_destination: add pdf_destination commands to l3pdf (6341ccc2c)

[Ulrike Fischer]

Repository : https://github.com/latex3/latex3
On branch  : pdf_destination
Link       : https://github.com/latex3/latex3/commit/6341ccc2c2966784e07b745bd61cad9383577a03

>---------------------------------------------------------------

commit 6341ccc2c2966784e07b745bd61cad9383577a03
Author: Ulrike Fischer <fischer at troubleshooting-tex.de>
Date:   Sun Jan 3 22:54:13 2021 +0100

    add pdf_destination commands to l3pdf


>---------------------------------------------------------------

6341ccc2c2966784e07b745bd61cad9383577a03
 l3experimental/CHANGELOG.md    |  3 +++
 l3experimental/l3pdf/l3pdf.dtx | 35 +++++++++++++++++++++++++++++++++++
 2 files changed, 38 insertions(+)

diff --git a/l3experimental/CHANGELOG.md b/l3experimental/CHANGELOG.md
index ddb78d83f..a3352198c 100644
--- a/l3experimental/CHANGELOG.md
+++ b/l3experimental/CHANGELOG.md
@@ -7,6 +7,9 @@ this project uses date-based 'snapshot' version identifiers.
 
 ## [Unreleased]
 
+### Added
+- `\pdf_destination:nn` and `\pdf_destination_box:nn` added to l3pdf
+
 ## [2020-10-27]
 
 ### Changed
diff --git a/l3experimental/l3pdf/l3pdf.dtx b/l3experimental/l3pdf/l3pdf.dtx
index cbd66f9a8..722ac154c 100644
--- a/l3experimental/l3pdf/l3pdf.dtx
+++ b/l3experimental/l3pdf/l3pdf.dtx
@@ -174,6 +174,27 @@
 %   This function may only be used up to the point where the PDF file is
 %   initialised.
 % \end{function}
+% \subsection{Destinations}
+% % \begin{function}[added = 2021-01-03]
+%   {\pdf_destination:nn}
+%   \begin{syntax}
+%     \cs{pdf_destination:nn} \Arg{name} \Arg{type or integer}
+%   \end{syntax}
+%   This creates a destination. \Arg{type or Integer} can be one of |fit|, |fith|,
+%   |fitv|, |fitb|, |fitbh|, |fitbv|, |fitr|, |xyz|
+%   or an integer representing a  scale factor in percent.
+%   The backend code defines |fitr| so that it will with pdflatex and
+%   lualatex use the coordinates of the surrounding box,
+%   with dvips and dvipdfmx it falls back to |fit|.
+% \end{function}
+% \begin{function}[added = 2020-01-03]
+%   {\pdf_destination_box:nn}
+%   \begin{syntax}
+%     \cs{pdf_destination_box:nn} \Arg{name} \Arg{content}
+%   \end{syntax}
+%   This stores the content in a hbox, outputs the box and
+%   creates a destination with |FitR| type encompassing this box.
+% \end{function}
 %
 % \end{documentation}
 %
@@ -347,6 +368,20 @@
 %    \end{macrocode}
 % \end{macro}
 %
+% \subsection{Destinations}
+% \begin{macro}{\pdf_destination:nn,\pdf_destination_box:nn}
+%    \begin{macrocode}
+\cs_new_protected:Npn \pdf_destination:nn #1 #2
+  {
+    \@@_backend_destination:nn {#1}{#2}
+  }
+
+\cs_new_protected:Npn \pdf_destination_box:nn #1 #2
+ {
+   \@@_backend_destination_box:nn { #1 }{ #2 }
+ }
+%    \end{macrocode}
+% \end{macro}
 %    \begin{macrocode}
 %</package>
 %    \end{macrocode}