Image (Bitmap) Export Automation Options
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 Grapher 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 the number can vary 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 Grapher 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 the number can vary from device to device) |
| KeepAspect | 0 = No 1 = Yes |
1 | If set to 1, KeepAspect adjusts the aspect ratio (the width versus height) of the exported image to match the aspect ratio of the Grapher 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 Grapher 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 Grapher 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 Grapher plot. |
| KeepPixelSize |
0 = No 1 = Yes |
0 | 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. |
| 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 Grapher 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. For PDF (raster) export, compresses images in the PDF to reduce file size. |
| CompressImages |
0 = False 1 = True |
1 | For PDF Raster export only. Compresses images in the PDF to reduce file size. |
| FitPage |
0 = Use application page size 1 = Fit page around exported objects |
0 | For PDF Raster export only. Sets the size of the PDF to the application page size, if true. Otherwise PDF page size is set to the size of the exported objects. |
| 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 |
| BackgroundColor |
16777216 = no transparency 16777217 = background transparency 16777215 = white transparency 0 = black transparency less than 16777216 = custom color transparency |
16777216 |
Color value for transparency
for GIF export only. If the value is less than 16777216, the color is composed of red, green, and blue and is set to a custom color. The color value is calculated by: Red + Green*256 + Blue*65536 where Red, Green, and Blue are values between 0 and 255. |
| UseTransparency | 0 = No 1 = Yes |
0 | Use application background transparency for PNG export only. If set to 1, background is transparent. |
| FormatJ2K |
0 = JP2 container 1 = J2K container |
0 | Sets the Container Format for JPG-2000 export only. |