summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/luatex/base/luatex-backend.tex
diff options
context:
space:
mode:
authorLuigi Scarso <luigi.scarso@gmail.com>2017-03-31 13:27:09 +0000
committerLuigi Scarso <luigi.scarso@gmail.com>2017-03-31 13:27:09 +0000
commita4a4aad8f0f09d5c1a58209ceee4cb611a6e9970 (patch)
tree6654d545f4e942d7950b41eba3c9aa06923c9b36 /Master/texmf-dist/doc/luatex/base/luatex-backend.tex
parent20572a0a2532c4923cabed2a1ca7a07cd1334d9c (diff)
luatex 1.0.4 and metapost 2.0rc1
git-svn-id: svn://tug.org/texlive/trunk@43654 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/luatex/base/luatex-backend.tex')
-rw-r--r--Master/texmf-dist/doc/luatex/base/luatex-backend.tex40
1 files changed, 36 insertions, 4 deletions
diff --git a/Master/texmf-dist/doc/luatex/base/luatex-backend.tex b/Master/texmf-dist/doc/luatex/base/luatex-backend.tex
index 5189ed01d8e..40b64721188 100644
--- a/Master/texmf-dist/doc/luatex/base/luatex-backend.tex
+++ b/Master/texmf-dist/doc/luatex/base/luatex-backend.tex
@@ -52,6 +52,11 @@ The version is frozen in the binary but you can set the minor version. What mino
version you set depends on what \PDF\ features you use. This is out of control
of \LUATEX.
+\subsection{\type {getcreationdate}}
+
+This function returns a string with the date in the format that ends up in the
+\PDF\ file, in this case it's: {\tttf \cldcontext{pdf.getcreationdate()}}.
+
\subsection{\type {[set|get]inclusionerrorlevel}, \type {[set|get]ignoreunknownimages}}
These variable control how error in included image are treated. They are modeled
@@ -76,6 +81,15 @@ the maximum is~9.
These two functions set the level of compression. The minimum value is~0,
the maximum is~9.
+\subsection{\type {[set|get]gentounicode}}
+
+This flag enables tounicode generation (like in \PDFTEX).
+
+\subsection{\type {[set|get]omitcidset}}
+
+This flag disables inclusion of a so called CIDSet which can be handy when aiming
+at some of the many \PDF\ substandards.
+
\subsection{\type {[set|get]decimaldigits}}
These two functions set the accuracy of floats written to the \PDF file. You can
@@ -112,6 +126,11 @@ pdf.setorigin(tex.sp("1in"),tex.sp("1in"))
The counterpart of this function returns two values.
+\subsection{\type {[set|get]imageresolution}}
+
+These two functions relate to the imageresolution that is used when the image
+itself doesn't provide a non|-|zero x or y resolution.
+
\subsection {\type {[set|get][link|dest|thread|xform]margin}}
These functions can be used to set and retrieve the margins that are added to the
@@ -297,6 +316,15 @@ are the same as for the similar backend extension primitive.
pdf.newcolorstack("0 g","page",true) -- page|direct|origin
\stopfunctioncall
+\subsection {\type {setfontattributes}}
+
+This function will force some additional code into the font resource. It can for
+instance be used to add a custom \type {ToUnicode} vector to a bitmap file.
+
+\startfunctioncall
+pdf.setfontattributes(<number> font id, <string> pdf code)
+\stopfunctioncall
+
\section {The \type {pdfscanner} library}
The \type {pdfscanner} library allows interpretation of \PDF\ content streams and
@@ -923,20 +951,24 @@ arguments:
\NC \type {stream} \NC this is a (in low level \LUA\ speak) light userdata
object, i.e.\ a pointer to a sequence of bytes \NC \NR
\NC \type {length} \NC this is the length of the stream in bytes \NC \NR
-\NC \type {name} \NC this is a unique identifier that us used for hashing the
- stream, so that mulltiple doesn't use more memory \NC \NR
+\NC \type {name} \NC this is a unique identifier that is used for hashing the
+ stream, so that multiple doesn't use more memory \NC \NR
\stoptabulate
Instead of a light userdata stream you can also pass a \LUA\ string, in which
case the given length is (at most) the string length.
-The returned object can be used in the \type {img} library instead of a filename.
+The function returns a \type{epdf} object and a string. The string can be used in
+the \type {img} library instead of a filename. You need to prevent garbage
+collection of the object when you use it as image (for instance by storing it
+somewhere).
+
Both the memory stream and it's use in the image library is experimental and can
change. In case you wonder where this can be used: when you use the swiglib
library for \type {graphicmagick}, it can return such a userdata object. This
permits conversion in memory and passing the result directly to the backend. This
might save some runtime in one|-|pass workflows. This feature is currently not
-meant for production.
+meant for production and we might come up with a better implementation.
\stopchapter