new ImageSettings()
An object that stores downsampling/recompression settings for color and grayscale images.
Members
-
<static> CompressionMode
-
Type:
- number
Properties:
Name Type Description e_retainnumber e_flatenumber e_jpegnumber e_jpeg2000number e_nonenumber -
<static> DownsampleMode
-
Type:
- number
Properties:
Name Type Description e_offnumber e_defaultnumber
Methods
-
forceChanges(force)
-
Sets whether image changes that grow the PDF file should be kept. This is off by default.
Parameters:
Name Type Description forceboolean if true all image changes will be kept. Returns:
this object, for call chaining -
forceRecompression(force)
-
Sets whether recompression to the specified compression method, should be forced when the image is not downsampled. By default the compression method for these images will not be changed.
Parameters:
Name Type Description forceboolean if true the compression method for all Returns:
this object, for call chaining -
setCompressionMode(mode)
-
Sets the output compression mode for this type of image The default value is e_retain
Parameters:
Name Type Description modenumber the compression mode to set PDFNet.Optimizer.ImageSettings.CompressionMode = { e_retain : 0, e_flate : 1, e_jpeg : 2, e_jpeg2000 : 3, e_none : 4 }Returns:
this object, for call chaining -
setDownsampleMode(mode)
-
Sets the downsample mode for this type of image The default value is e_default which will allow downsampling of images
Parameters:
Name Type Description modenumber the compression mode to set PDFNet.Optimizer.ImageSettings.DownsampleMode = { e_off : 0, e_default : 1 }Returns:
this object, for call chaining -
setImageDPI(maximum, resampling)
-
Sets the maximum and resampling dpi for images. By default these are set to 225 and 150 respectively.
Parameters:
Name Type Description maximumnumber the highest dpi of an image before it will be resampled resamplingnumber the image dpi to resample to if an image is encountered over the maximum dpi Returns:
this object, for call chaining -
setQuality(quality)
-
Sets the quality for lossy compression modes. from 1 to 10 where 10 is lossless (if possible) the default value is 5
Parameters:
Name Type Description qualitynumber the quality for lossy compression modes. Returns:
this object, for call chaining