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 Surfer 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 Surfer 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 Surfer 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 Surfer 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 Surfer 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 Surfer plot.

KeepPixelSize

0 = No

1 = Yes

 

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 Surfer 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.

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.

CoordSystemEncodingOGC

0 = False

1 = True

1

For PDF Raster export only. Write the GeoPDF coordinate system information with the OGC Best Practices encoding.

CoordSystemEncodingAdobe

0 = False

1 = True

1

For PDF Raster export only. Write the GeoPDF coordinate system information with the Adobe Addendum encoding.

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 (0) is the least efficient option but has the highest degree of compatibility with other software.

FormatJ2K

0 = JP2 container

1 = J2K container

0

Sets the Container Format for JPG-2000 export only.

BackgroundColor

1677216 = 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 GIF transparent color is composed of red, green, and blue and is set to a custom color. The BackgroundColor 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.

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

SaveRefInfoAsESRIprj

0 = No

1 = Yes

0

Save spatial references as Esri .prj 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

SaveRefInfoAsAUXXML

0 = No

1 = Yes

0

Save spatial references as Esri AUX.XML file

SaveRefInfoAsTAB

0 = No

1 = Yes

0

Save spatial references as MapInfo TAB file

See Also

Bitmap Export Options Dialog

Export Options String