Get Mapped PDF

Command line:
tlapi ‑cPDFPMAP [‑snShow] [‑PsProfile] ‑isMapFile ‑osPdfFile sPart
Library call:
nStatus = TLmap2pdfEx (sPart, sMapFile, (char *) NULL, nType, sProfile, sOpts, sPdfFile, nShow)
Library call:
nStatus = TLmap2pdf (sPart, sMapFile, (char *) NULL, nType, sPdfFile, nShow)

Function

Create a PDF version of selected pages from a partition.

[Warning] Warning

Any errors or warnings when creating a PDF are written to a log file in the same directory as the output file. The log file has the same name as the output file but with extension “.log” replacing the extension (if any) of the output file. Any existing file with this name will be silently removed.

[Note] Note

The TLmap2pdf library call is deprecated and may not be supported in future versions of the API.

Arguments

sPart

The path of the partition from which the PDF is to be generated.

sMapFile

The full pathname of the page map file. Each page listed in the map file is included in the resulting PDF file. See the Get Page Map entry for a description of the page map format.

nType

Not used. Always pass zero for this argument.

sProfile

The name of the profile that determines options for creating the PDF. Pass NULL for this argument to use the default profile.

sOpts

A string specifying processing options as described in Get PDF.

These options override those specified by the profile. Pass NULL if you do not wish to set any options.

sPdfFile

The full pathname of the output PDF file. If the file already exists, it will be replaced. If the file does not exist, it will be created.

nShow

The Windows showmode for the typesetting progress display. By default, the typesetting dialog will be displayed.

The only useful values are SW_NORMAL (1) and SW_MINIMIZE (6). The latter causes the progress window to run minimised. There is no way to prevent the creation of a window.

This parameter is ignored on Unix.

For additional command line arguments see “Common Flag Arguments”.

[Note] Note

Hyperlinks and bookmarks are disabled for the PDF, since it may not contain all pages in the partition. A meta data variable can be used to enable bookmarks.

Examples

Command line:

tlapi ‑cPDFPMAP ‑iC:\pages.map ‑oC:\mydoc.pdf manuals/topix/vol1

Library call:

status = TLmap2pdfEx("manuals/topix/vol1", "C:\pages.map", (char *) NULL, 0L,
                 NULL, NULL, "C:\\mydoc.pdf", SW_HIDE);