summaryrefslogtreecommitdiff
path: root/doc/context/sources/general/manuals/luatex/luatex-libraries.tex
diff options
context:
space:
mode:
Diffstat (limited to 'doc/context/sources/general/manuals/luatex/luatex-libraries.tex')
-rw-r--r--doc/context/sources/general/manuals/luatex/luatex-libraries.tex56
1 files changed, 21 insertions, 35 deletions
diff --git a/doc/context/sources/general/manuals/luatex/luatex-libraries.tex b/doc/context/sources/general/manuals/luatex/luatex-libraries.tex
index ec401c282..be4052637 100644
--- a/doc/context/sources/general/manuals/luatex/luatex-libraries.tex
+++ b/doc/context/sources/general/manuals/luatex/luatex-libraries.tex
@@ -176,15 +176,16 @@ Like \type {find_font_file}, but for subfont definition files.
\subsubsection{\type {find_pk_file}}
-Like \type {find_font_file}, but for pk bitmap files. The argument \type
-{asked_name} is a bit special in this case. Its form is
+Like \type {find_font_file}, but for pk bitmap files. This callback takes two
+arguments: \type {name} and \type {dpi}. In your callback you can decide to
+look for:
\starttyping
<base res>dpi/<fontname>.<actual res>pk
\stoptyping
-So you may be asked for \type {600dpi/manfnt.720pk}. It is up to you to find a
-\quote {reasonable} bitmap file to go with that specification.
+but other strategies are possible. It is up to you to find a \quote {reasonable}
+bitmap file to go with that specification.
\subsubsection{\type {find_data_file}}
@@ -2668,6 +2669,13 @@ Once the image is scanned, all the values in the \type {<image>} except \type
{width}, \type {height} and \type {depth}, become frozen, and you cannot change
them any more.
+You can use \type {pdf.setignoreunknownimages(1)} (or at the \TEX\ end the \type
+{\pdfvariable} \type {ignoreunknownimages}) to get around a quit when no known
+image type is found (based on name or preamble). Beware: this will not catch
+invalid images and we cannot guarantee side effects. A zero dimension image is
+still included when requested. No special flags are set. A proper workflow will
+not rely in such a catch but make sure that images are valid.
+
\subsection{\type {img.keys}}
\startfunctioncall
@@ -4379,7 +4387,13 @@ the maximum is~9.
\subsection{\type {pdf.setdecimaldigits} and \type {pdf.getdecimaldigits}}
-These two functions set the accuracy of floats written to the \PDF file.
+These two functions set the accuracy of floats written to the \PDF file. You can
+set any value but the backend will not go below 3 and above 6.
+
+\subsection{\type {pdf.setpkresolution} and \type {pdf.getpkresolution}}
+
+These setter takes two arguments: the resolution and an optional zero or one that
+indicates if this is a fixed one. The getter returns these two values.
\subsection{\type {pdf.lastobj}, \type {pdf.lastlink}, \type {pdf.lastannot},
and \type {pdf.retval}}
@@ -4401,7 +4415,7 @@ pdf.setorigin(tex.sp("1in"),tex.sp("1in"))
The counterpart of this function returns two values.
\subsection{\type {pdf.setlinkmargin}, \type {pdf.getlinkmargin} \type
-{pdf.setdestmargin}, \type {pdf.getdestmargin}} \type {pdf.setthreadmargin},
+{pdf.setdestmargin}, \type {pdf.getdestmargin} \type {pdf.setthreadmargin},
\type {pdf.getthreadmargin} \type {pdf.setxformmargin}, \type
{pdf.getxformmargin}}
@@ -4978,34 +4992,6 @@ tex.year
\stoptyping
\stoptwocolumns
-% tex.pdfadjustspacing
-% tex.pdfcompresslevel
-% tex.pdfdecimaldigits
-% tex.pdfgamma
-% tex.pdfgentounicode
-% tex.pdfimageapplygamma
-% tex.pdfimagegamma
-% tex.pdfimagehicolor
-% tex.pdfimageresolution
-% tex.pdfinclusionerrorlevel
-% tex.pdfminorversion
-% tex.pdfobjcompresslevel
-% tex.pdfoutput
-% tex.pdfpagebox
-% tex.pdfpkresolution
-% tex.pdfprotrudechars
-% tex.pdftracingfonts
-% tex.pdfuniqueresname
-
-% tex.pdfdestmargin
-% tex.pdflinkmargin
-% tex.pdfthreadmargin
-% tex.pdfxformmargin
-% tex.pdfhorigin
-% tex.pdfvorigin
-
-% tex.pdfpxdimen
-
Read|-|only:
\startthreecolumns
@@ -6385,7 +6371,7 @@ in the input.
The creator function can be used as follows:
\starttyping
-local t = token("relax")
+local t = token.create("relax")
\stoptyping
This gives back a token object that has the properties of the \type {\relax}