Since the Export Options dialog is not displayed when the program is driven from an automation script, an options string can be specified in the script. The string consists of comma-separated parameters, which specify the behavior of the various export options. A typical example would be:
"Defaults=1,Width=640,Height=480,ColorDepth=4"
This would set all export options to their default values, then set the bitmap width to 640 pixels, the bitmap height to 480 pixels and the color depth to 4 (i.e., 256 colors).
Note: A script writer is allowed to change the size of a bitmap, even if it has associated georeference parameters. New (but possibly not minimal RMS) georeference parameters will be automatically calculated and saved. Avoid using the "Width=", "Height=", "HDPI=" or "VDPI=" automation options if you do not want associated georeference parameters recalculated.
|
Option |
Action |
Default |
Description |
|
Width |
N |
|
Sets the width of the exported image in pixels. Either a Width or an HDPI option may be specified, but not both. |
|
Height |
N |
|
Sets the height of the exported image in pixels. Either a Height or a VDPI option may be specified, but not both |
|
HDPI |
N |
96 |
Sets the number of horizontal pixels in the exported image that corresponds to a distance one horizontal inch on the MapViewer plot. 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). |
|
VDPI |
N |
96 |
Sets the number of vertical pixels in the exported image that corresponds to a distance of one vertical inch on the MapViewer plot. 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) |
|
KeepAspect |
0 = No 1 = Yes |
1 |
If set to 1, KeepAspect ajusts the aspect ratio (the width versus height) of the exported image to match the aspect ratio of the MapViewer plot that is being exported. If an option is given to set the Width or HDPI of an image, KeepAspect automatically assigns the appropriate Height or VDPI to maintain the same aspect ratio as the MapViewer plot. Likewise, if an option is given to set the Height or VDPI of an image, KeepAspect automatically assigns the appropriate Width or HDPI to maintain the same aspect ratio of the MapViewer plot. Note that the KeepAspect option is ignored if both the Width and Height options or the HDPI and VDPI options are specified. If set to 0, the aspect ratio of the exported image is determined solely by the Width and Height or HDPI and VDPI options. The size is not adjusted to match the aspect ratio of the MapViewer plot. |
|
KeepPixelSize |
0 = No 1 = Yes |
|
Locks the pixel dimension width and height. Changes to the VDPI and HDPI will only affect the document size when this is set to 1. |
|
ColorDepth |
-32 = 32-bit grayscale -16 = 16-bit grayscale -8 = 8-bit grayscale -4 = 4-bit grayscale -1 = Monochrome 1 = 1-bit color indexed 4 = 4-bit color indexed 8 = 8-bit color indexed 24 = 24-bit true color 32 = 32-bit true color with alpha |
24 for most formats 8 if the format doesn't support 24-bit true color |
Specifies the color depth (or pixel format) of the exported image. The greater the color depth, the more faithfully the image will represent the colors assigned to objects in your document. Note that not all color depths are supported by all export filters. In cases where the requested format is not supported by a particular export filter, the export procedure will automatically select an alternate format that is compatible with the export filter. |
|
ColorReductionMethod |
1 = Ordered Dither 2 = Diffuse Dither 3 = Popularity 4 = MedianCut555 5 = MedianCut888 |
5 |
In cases where an indexed ColorDepth has been selected for the exported image, the ColorReductionMethod option selects which algorithm is used to reduce the 16 million possible colors in the MapViewer plot down to the actual number of colors available in the image's color table. |
|
Quality |
N |
100 |
For JPG and JPG2 export only. Set compression quality 0 - 100. A value of 100 is highest quality. |
|
Compress |
0 = No compression 1 = Packbits 2 = Deflate |
0 |
For TIF export only. Set the compression type of an exported TIF file. |
|
Format |
0 = Monolithic (one strip) 1 = One row per strip 2 = 16 rows per strip 3 = 64 rows per strip 4 = 64x64-pixel tiles 5 = 256x256-pixel tiles |
3 |
For TIF export only. Choose from a variety of strip and tile output formats when exporting TIF files. The option In one strip containing the entire image is the least efficient option but has the highest degree of compatibly with other software. |
|
SaveRefInfoAsInternal |
0 = No 1 = Yes |
0 |
Save spatial references to internal format (if possible) |
|
SaveRefInfoAsBlueMarbleRSF |
0 = No 1 = Yes |
0 |
Save spatial references as Blue Marble .RSF file |
|
SaveRefInfoAsESRIWorld |
0 = No 1 = Yes |
0 |
Save spatial references as ESRI World file |
|
SaveRefInfoAsGSIREF |
0 = No 1 = Yes |
0 |
Save spatial references as Golden Software Reference (version 1) file |
|
SaveRefInfoAsGSIREF2 |
0 = No 1 = Yes |
0 |
Save spatial references as Golden Software Reference (version 2) file |
|
FormatJ2K |
0 = JP2 container 1 = J2K container |
0 |
Sets the Container Format for JPG-2000 export only. |
See Also