Output parameters (PS) | Helix Documentation

setParameter()

IPSOutput supports several parameters that control how the PostScript is written. These can be set in code using setParameter() with two strings.

C++

IPSOutputPtr output = IPSOutput::create(jawsMako);
output->setParameter("TargetColorSpace", "DeviceCMYK");

IPSOutput output = IPSOutput.create(jawsMako);
output.setParameter("TargetColorSpace", "DeviceCMYK");

This method supports scenarios where it is necessary to set an output parameter at runtime, for example in a printer driver where the user is offered options from a menu.

The sample makoconverter allows you to experiment with these parameters by adding them to the command line, for example:

makoconverter MyInput.pdf MyOutput.ps TargetColorSpace=DeviceGray ConvertAllObjectsToTargetColorSpace=true

The following settings are supported.

Parameter	Possible values	Description
MonoImageDownsamplingResolution	`0 to 32768`	The desired output resolution, in dpi. Pass 0 to leave images unchanged, which is the default.
MonoImageDownsamplingThreshold	`0 to 32768`	The threshold above which images will be reduced to the desired resolution. A value of 0 means always downsample to the specified resolution.
MonoImageDownsamplingMethod	`Subsample` `Average` `Bicubic`	The method to use when downsampling. The default is subsample for monochrome images; using any other method will result in grayscale output.
GrayImageDownsamplingResolution	`0 to 32768`	The desired output resolution, in dpi. Pass 0 to leave images unchanged, which is the default.
GrayImageDownsamplingThreshold	`0 to 32768`	The threshold above which images will be reduced to the desired resolution. A value of 0 means always downsample to the specified resolution.
GrayImageDownsamplingMethod	`Subsample` `Average` `Bicubic`	The method to use when downsampling. The default is subsample for monochrome images; using any other method will result in grayscale output.
ColorImageDownsamplingResolution	`0 to 32768`	The desired output resolution, in dpi. Pass 0 to leave images unchanged, which is the default.
ColorImageDownsamplingThreshold	`0 to 32768`	The threshold in dpi above which images will be reduced to the desired resolution. A value of 0 means always downsample to the specified resolution.
ColorImageDownsamplingMethod	`Subsample` `Average` `Bicubic`	The method to use when downsampling. The default is bicubic for color and grayscale images.
ColorImageCompression	`Flate` `DCT` `LZW`	Set the desired image compression for color images that need to be reencoded. The default is DCT.
GrayImageCompression	`Flate` `DCT` `LZW`	Set the desired image compression for gray images that need to be reencoded. The default is DCT.
MonoImageCompression	`CCITT` `Flate`	Set the desired image compression for monochrome images that need to be reencoded. The default is CCITT.
JPEGQuality	`1 to 5`	Sets the JPEG quality to use when compressing images in DCT format. The default is 3 - medium quality.
TargetResolution	`0 to 32768`	The desired output resolution, in dpi. Pass 0 to leave images unchanged. The default is 600dpi.
TargetColorSpace	`DeviceRGB` `DeviceGray` `DeviceCMYK`	By default, the target color space is used if anything must be rendered or color-converted. The default behavior is to apply this only when required. Use ConvertAllObjectsToTargetColorSpace if converting everything is required. For PDF/A-1b output, an OutputIntents dictionary will be created for this color space. LAB color spaces may not be used as a destination color space for PDF/A. For PDF/X-1a output, only DeviceCMYK is supported; this setting is ignored.
TargetProfile	`Path to ICC profile`	Sets the target color space for the output using an ICC profile. By default, the target color space is used if anything must be rendered or color-converted. The default behavior is to apply this only when required. Use ConvertAllObjectsToTargetColorSpace if converting everything is required.
ConvertAllObjectsToTargetColorSpace	`true` `false`	Sets whether all content should be color converted to the target space set by TargetProfile. The default is true.
IgnoreDeviceGrayDuringColorConversion	`true` `false`	Set whether gray colors should be subject to color conversion. That is, colors using DeviceGray, sGray, or single-component ICC colorspaces. The default is true.
RenderedImageCompression	Flate LZW	The default is LZW.