LlStgsysConvert

Syntax:

INT LlStgsysConvert (HLLSTG hStg, LPCTSTR pszDstFilename, LPCTSTR pszFormat);

Task:

Converts a preview file to another format.

Parameter:

hStg: The handle returned by LlStgsysStorageOpen()

pszDstFilename: Name of the target file. It is also possible to use the placeholder %d (e.g. "page %d"). This is important e.g. for converting JPEGs, because without the placeholder only one page will result.

pszFormat: Target format. Valid values are:

"TIFF" (also "PICTURE_MULTITIFF")

"JPEG" (also "PICTURE_JPEG")

"PNG" (also "PICTURE_PNG")

"EMF"

"TTY"

"PDF"

"XPS"

"PRN"

"TXT"

"LL"

This parameter allows you to declare a semicolon-separated list with further export options. You will find the accepted values in the chapter "The Export Modules". Please note that not all options can be supported with this API. An example is the parameters "PDF;PDF.EncryptionFile=1".

Additional to the mentioned parameters above the following parameters can be used:

Value	Meaning
PageIndexRange	Analog to the print options dialog a range for pages can be set.
JobIndexRange	Analog to the print options dialog a range for the job can be set.
IssueIndexRange	Analog to the print options dialog a range for the issues can be set.

An example of this is the use of " PDF;Export.PageIndexRange=2-3".

With this, only pages 2 and 3 are converted to PDF.

The export to PRN creates a file that is specially prepared for the given printer (parameter "PRN.Device="). This file can be output on the printer by copying it directly. Therefore the printer name (device name) must be explicitly defined.

Return value:

<0: Errorcode
= 0: okay

Hints:

Example:

HLLSTG hStgOrg;

hStgOrg = LlStgsysStorageOpen("c:\\test\\label1.ll", "",
FALSE, TRUE);
LlStgsysStorageConvert(hStgOrg, "c:\\test\\label2.pdf", "PDF");
LlStgsysStorageClose(hStgOrg);