Graphics
The Graphics properties contains three sections that define how images are processed before they are inserted. Please note that all properties are case-sensitive:
•Color determines image downsampling and conversion options for True Color images.
•Indexed determines image downsampling and conversion options for indexed images with palettes:
•MonoAndDrawings determines downsampling and conversion options for monochrome images and black & white drawings:
Color
This property determines image downsampling and conversion options for True Color images:
•The Downsample subsection defines when and how images are downsampled.
•The Convert subsection defines color reduction parameters.
Color.Downsample
This subsection determines when and how images are downsampled:
NAME
|
VALUES
|
DEFINITION |
Method |
0 (None) 1 (Linear) 2 (Bilinear) 3 (Bicubic)
|
Specifies the downsampling method. If the value of this property is 0 (None) then color images will not be downsampled.
Default value: 0 (None)
|
IfAbove |
All values from 51-2400 |
If the original DPI of the image is equal to or above the value specified for this property then images are downsampled to the DPI specified for the To property.
Default value: 128
|
To |
All values from 50-2399 |
The size to which color images are downsampled.
Default value: 96
|
Color.Convert
This subsection determines conversion options for color images:
NAME
|
VALUES
|
DEFINITION |
Method |
0 (None) 1 (ToGrayscale) 2 (ToMonochrome) 3 (ToBlackAndWhite)
|
Specifies how color images are converted. If the value of this property is 0 (None) then color images will not be converted.
Default value: 0 (None)
|
Dither |
Enables/disables dithering during conversion. This is relevant for only the ToMonochrome and ToBlackAndWhite values.
Default value: True
|
Indexed
This section determines image downsampling and conversion options for indexed images with palettes:
•The Downsample subsection defines when and how images are downsampled.
•The Convert subsection specifies color reduction and conversion options for indexed images.
Indexed.Downsample
This subsection defines downsampling options:
NAME
|
VALUES
|
DEFINITION |
Method |
0 (None) 1 (Linear) 2 (Bilinear) 3 (Bicubic)
|
Specifies the downsampling method. If this property is set to 0 (None) then indexed images will not be downsampled.
Default value: 0 (None)
|
IfAbove
|
All values from 51-2400 |
If the original DPI of the image is equal to or above the value specified for this property then images are downsampled to the DPI specified for the To property.
Default value: 128
|
To
|
All values from 50-2399
|
The size to which indexed images are downsampled.
Default value: 96
|
Indexed.Convert
This subsection determines conversion options for indexed images:
NAME
|
VALUES
|
DEFINITION |
Method |
0 (None) 1 (ToGrayscale) 2 (ToMonochrome) 3 (ToBlackAndWhite)
|
Specifies the conversion method. If this property is set to 0 (None) then indexed images will not be converted.
Default value: 0 (None)
|
Dither
|
Specifies whether or not images are dithered during conversion. It is relevant to only the ToMonochrome and ToBlackAndWhite values.
Default value: True
|
MonoAndDrawings
This section determines downsampling and conversion options for monochrome images and black & white drawings:
•The Downsample subsection determines when and how images are downsampled.
•The Convert subsection determines conversion options for monochrome/black & white images.
MonoAndDrawings.Downsample
This subsection defines downsampling options:
NAME
|
VALUES
|
DEFINITION |
Method
|
0 (None) 1 (Linear) 2 (Bilinear) 3 (Bicubic)
|
Specifies the downsampling method. If the value of this property is 0 (None) then monochrome images and black & white drawings will not be downsampled.
Default value: 0 (None)
|
IfAbove
|
All values from 51-2400
|
If the original DPI of the image is equal to or above the value specified for this property then images will be downsampled to the DPI specified for the To property.
Default value: 128
|
To
|
All values from 50-2399 |
The size to which monochrome images and black & white images are downsampled.
Default value: 96
|
MonoAndDrawings.Convert
This subsection determines conversion options for monochrome images and black & white drawings.
NAME
|
VALUES
|
DEFINITION |
Method
|
0 (None) 1 (ToGrayscale) 2 (ToMonochrome) 3 (ToBlackAndWhite)
|
Defines how mono images and line art are converted. If the value is set to 0 (None) then no conversions will take place.
Default value: 0 (None) |
Threshold
|
All values from 1-255 |
Defines the level behind which line art colors are treated as black. The grayscale level of line art color is used as a comparison.
Default value: 128
|