Programming Interface

You can find a description of all options used in the picture export module in this chapter. The options can be modified/read using the methods LlXSetPara­meter(..."<Exportername>"...) and LlXGet­Parameter(..."<Exportername>"...). <Exportername> can be "PICTURE_JPEG", "PICTURE_BMP", "PICTURE_EMF", "PICTURE_TIFF", "PICTURE_MULTITIFF" or "PICTURE_PNG" depending on the graphic format.

Resolution: Defines the resolution in dpi for the transformation of the coordinates and the generation of pictures. Default: 96 dpi, screen resolution.

Picture.JPEGQuality: Specifies the quality and the corresponding compression factor of the generated JPEG graphic. The value lies between 0 and 100, with 100 representing the highest quality (and therefore the least compression). Takes effect only when the source graphic is not the JPEG format, as encoding of JPEG to JPEG would result in a quality loss. Default: 75

Picture.BitsPerPixel: Defines the color depth of the generated picture. Please note that the picture files will quickly get very large with higher color depths. Not all picture formats can display all color depths.

Value

Meaning

1

Black & White

4

16 Colors

8

256 Colors

24

24bit True Color

Default

JPEG, PNG: 24, Other: 8

 

Picture.CropFile: Removes dispensable white frame. Supported export formats: PNG, JPEG and TIFF. This option is not supported when used in services (e.g. IIS) as GDI+ is not available there.

Value

Meaning       

0

Image will not be cropped

1

Image will be cropped

Default

0

 

Picture.CropFrameWidth: Defines the border of a cropped file in pixel.

Export.File: File name containing "%d" as format identifier. The files for the pages will be named by replacing the placeholder by the page number. If you do not set this option, you will get a simple page numbering for the result files. If this option is empty, a file selection dialog will always be displayed.

Export.Path: Path where the exported files should be saved.

Export.Quiet: Use this option to configure the possibility of exporting without user interaction.

Value

Meaning

0

With user interaction (dialogs)

1

No dialogs or message boxes will be displayed (only if Export.Path was specified).

Default

0

 

Export.ShowResult: Specifies whether the export result will be displayed automatically. The program that displays the result will be determined by the registered file extension.

Value

Meaning

0

Result will not be displayed automatically

1

Calls ShellExecute() with the first generated graphic file.

Default

0

 

Export.ShowResultAvailable: Enables you to hide the respective checkbox in the dialog.

Value

Meaning

0

Checkbox will be hidden

1

Checkbox will be available

Default

1

 

TIFF.CompressionType: Specifies the compression type for the TIFF export. Please note that not all viewers support compression. For CCITTRLE, CCITT3 and CCITT4 Picture.BitsPerPixel must be set to 1 or to 24 for JPEG.

Value

Meaning

None

No compression

CCITTRLE

CCITT Modified Huffmann RLE

CCITT3

CCITT Group 3 Fax encoding

CCITT4

CCITT Group 4 Fax encoding

JPEG

JPEG DCT compression

ZIP

ZIP compression

LZW

LZW compression

Default

None

 

TIFF.CompressionQuality: Specifies the compression quality for the TIFF export. Default: 75