Encapsulated PostScript File Format .EPS Export Automation Options

 

When the program is driven from an automation script, an options string can be specified in the script that acts as the export options dialogs do in the program. The string consists of comma-separated parameters, which specify the behavior of the various export options.

 

Parameter

Type

Description

Filter

string

BMP

ColorDepth

 -32, -16, -8, 1, 4, 8, 24, 32

Specifies the color depth to use.

 

ColorDepth=-32 -- 32 bit greyscale output

ColorDepth=-16 -- 16 bit greyscale output

ColorDepth=-8  -- 8 bit greyscale output

ColorDepth=1 -- 1 bit color indexed output

ColorDepth=4   -- 4 bit color indexed output

ColorDepth=8   -- 8 bit color indexed output

ColorDepth=24  -- 24 bit true color output

ColorDepth=32  -- 32 bit true color with alpha output

ColorReductionMethod

1, 2, 3, 4, 5

Specifies the color reduction method to use.

 

ColorReductionMethod=1 -- Use the Ordered Dither color reduction method

ColorReductionMethod=2 -- Use the Diffused Dither color reduction method

ColorReductionMethod=3 -- Use the Popularity color reduction method

ColorReductionMethod=4 -- Use the MedianCut555 color reduction method

ColorReductionMethod=5 -- Use the MedianCut888 color reduction method

HDPI

integer

Sets the number of horizontal pixels in the exported image that corresponds to a distance one horizontal inch.  Either a Width or an HDPI option may be specified, but not both.  The default HDPI is the resolution of the display device driver on your computer (this is 96 dots per inch on many Windows display devices, but number can very from device to device).

Height

integer

Sets the height of the exported image in pixels.  Either a Height or a VDPI option may be specified, but not both

KeepAspect

0 or 1

If this is set to 1, for any of the settings Height, Width, HDPI or VDPI you only need to set one option and Voxler will automatically calculate the other parameters in line with the aspect ratio of the input image.

KeepAspect=0 -- Do not retain the aspect ratio

KeepAspect=1 -- Do retain the aspect ratio

KeepPixelSize

0 or 1

Locks the pixel dimension width and height. Changes to the VDPI and HDPI will affect the document size, but not the pixel size, when this is set to 1. Changes to the VDPI and HDPI will affect the pixel dimensions, but not the document size, when this is set to 0. Note that the KeepPixelSize option is ignored if the either the Width or Height option is specified.

ModuleID

integer

Numeric ID of the module to be exported.

 

0=entire viewer window

2=default

PreviewColor

0, 1

Tells Voxler whether to use a color or grey scale preview.

PreviewColor=0 -- Use grey scale preview

PreviewColor=1 -- Use color preview

PreviewSize

0, 1, 2, 3, 4

Tells Voxler whether to use 64l, 512k or a percentage of total size for preview

PreviewSize=0 -- use 64k

PreviewSize=1 -- use 512k

PreviewSize=2 -- use 25% of total

PreviewSize=3 -- use 50% of total

PreviewSize=4 -- use 100% of total

PreviewType

0, 1, 2

Tells Voxler what kind of preview to embed.

PreviewType=0 -- No preview

PreviewType=1 -- EPSI preview

PreviewType=2 -- TIFF preview

VDPI

integer

Sets the number of vertical pixels in the exported image that corresponds to a distance of one vertical inch.  Either a Height or a VDPI option may be specified, but not both.  The default VDPI is the resolution of the display device driver on your computer (this is 96 dots per inch on many Windows display devices, but number can very from device to device)

Width

integer

Sets the width of the exported image in pixels.  Either a Width or an HDPI option may be specified, but not both.

 

 

Example

This example shows how to export an EPS file with the various options.

 

CommandApi.Construct("Export")

CommandApi.Option("GuiEnabled", "False")

CommandApi.Option("ClearOptions", "False")

CommandApi.Option("Filter", "eps")

CommandApi.Option("Options", "ColorDepth=24; ColorReductionMethod=5; HDPI=96; Height=903; KeepAspect=1; VDPI=96; Width=716")

CommandApi.Option("Options", "PreviewColor=1; PreviewSize=1; PreviewType=2")

CommandApi.Option("Path", "C:/Path/To/Export/file.eps")

CommandApi.Option("PersistOptions", "True")

CommandApi.Option("ModuleId", "0")

CommandApi.Do()

 

Used by: Export

 

 

See Also

Automation Model