A formal description of all available tags in the XML job ticket Size node. If the default value for a tag is “channel value”, this means that if the tag is not in the jobticket, the value is taken from the channel that processes the jobticket. If the tag is in the jobticket, the value of it overwrites the channel setting.
Even if the user-interface is set to using millimetres, internally Pixometry works with Inches. Therefore in the jobticket you can only specify inches.
CropActive (type:boolean, range:true/false, default:false)
If true, cropping will be done based on the crop related tags CropUnits, CropX, CropY, CropWidth and CropHeight.
SoftCropActive (type:boolean, range:true/false, default:false)
If true, the crop coordinates are only used for image analyses. Only the the area within the crop coordinates gets analysed and the black & white point will be within this frame. The complete image gets processed and the complete image will be returned. CropActive and SoftCropActive can both be true.
CropUnits (type:String, range:pixels,percentage, default:percentage)
Specifies the units of the tags: CropX, CropY, CropWidth and CropHeight. Percentage means a percentage of the total width/height of the original image.
CropX (type:integer/float, range:0-100 (percentage) or 0 – max-image-width-in-pixels, default:0)
Startposition of the crop frame from the left of the image.
CropY (type:integer/float, range:0-100 (percentage) or 0 – max-image-height-in-pixels, default:0)
Startposition of the crop frame from the top of the image.
CropWidth (type:integer/float, range:0-100 (percentage) or 0 – max-image-width-in-pixels, default:0)
The width of the crop frame
CropHeight (type:integer/float, range:0-100 (percentage) or 0 – max-image-height-in-pixels, default:0)
The height of the crop frame
DPIActive (type:boolean, range:true/false, default:channel value)
If true, the DPI value will be set according to the DPI tag.
ResizeFactorActive (type:boolean, range:true/false, default: channel value)
If true, resampling will be done based on ResizeFactor
ResizeFactor (type:float, range: >0, default: n/a)
The number of pixels in width and height will be multiplied by this factor.
DPI (type:integer, range:1-10000, default:channel value)
The DPI value that will be set in the image header.
ResampleActive (type:boolean, range:true/false, default:channel value)
If true, images may be resampled based on the other tags in the Size node. Read also “to resample or not to resample”
imageDpiX (type:integer, range:1-10000, default:N/A)
This tag in combination with imageDpiY and several other tags allow for disproportional scaling:
<entry key=”DPIActive” value=”true”/>
<entry key=”ResampleActive” value=”true”/>
<entry key=”DPI” value=”200″/>
<entry key=”imageDpiX” value=”350″/>
<entry key=”imageDpiY” value=”500″/>
The resizefactor for X is “DPI” / “imageDpiX”
The resizefactor for Y is “DPI” / “imageDpiY”
imageDpiY (type:integer, range:1-10000, default:N/A)
See description of tag imageDpiX
SetAlwaysDPI (type:boolean, range:true/false, default:channel value)
Set the DPI value in the header of the image even if the tag “OnlyUpSample” or “OnlyDownSample” prevents resampling of the image.
OnlyUpSample (type:boolean, range:true/false, default:channel value)
Only resample the image according to the size settings if it leads to a larger number of pixels. If it would lead to a reduced number of pixels, resampling is not done.
OnlyDownSample (type:boolean, range:true/false, default:channel value)
Only resample the image according to the size settings if it leads to a reduced number of pixels. If it would lead to a larger number of pixels, resampling is not done.
HighQualityResample (type:boolean, range:true/false, default:true)
Leads to higher quality resampling at the cost of slightly longer processing times.
WidthInchesActive (type:boolean, range:true/false, default:false)
Set the width of the image according to the value of the WidthInches tag.
Of the following size tags, only one may be true: WidthInchesActive, WidthPixelsActive, HeightInchesActive, HeightPixelsActive, FitInBoxActive, LongestSizeInchesActive, LongestSizePixelsActive, ShortestSizeInchesActive, ShortestSizePixelsActive, FillBoxActive.
WidthInches (type:float, range:>0, default:channel value)
Set the width of the image in inches.
WidthPixelsActive (type:boolean, range:true/false, default:false)
Set the width in pixels of the image according to the value of the WidthPixels tag.
Of the following size tags, only one may be true: WidthInchesActive, WidthPixelsActive, HeightInchesActive, HeightPixelsActive, FitInBoxActive, LongestSizeInchesActive, LongestSizePixelsActive, ShortestSizeInchesActive, ShortestSizePixelsActive, FillBoxActive.
WidthPixels (type:float, range:>0, default:channel value)
Set the width of the image in pixels.
HeightInchesActive (type:boolean, range:true/false, default:false)
Set the height of the image according to the value of the HeightInches tag.
Of the following size tags, only one may be true: WidthInchesActive, WidthPixelsActive, HeightInchesActive, HeightPixelsActive, FitInBoxActive, LongestSizeInchesActive, LongestSizePixelsActive, ShortestSizeInchesActive, ShortestSizePixelsActive, FillBoxActive.
HeightInches (type:float, range:>0, default:channel value)
Set the height of the image in inches.
HeightPixelsActive (type:boolean, range:true/false, default:false)
Set the height in pixels of the image according to the value of the HeightPixels tag.
Of the following size tags, only one may be true: WidthInchesActive, WidthPixelsActive, HeightInchesActive, HeightPixelsActive, FitInBoxActive, LongestSizeInchesActive, LongestSizePixelsActive, ShortestSizeInchesActive, ShortestSizePixelsActive, FillBoxActive.
HeightPixels (type:float, range:>0, default:channel value)
Set the height of the image in pixels.
FitInBoxActive (type:boolean, range:true/false, default:channel setting)
If true, resampling will be done so that the resulting image fits inside the FitInBoxWidth and FitInBoxHeight values. Since resampling is done proportionally, the image does not necessarily “fill the box” completely.
Of the following size tags, only one may be true: WidthInchesActive, WidthPixelsActive, HeightInchesActive, HeightPixelsActive, FitInBoxActive, LongestSizeInchesActive, LongestSizePixelsActive, ShortestSizeInchesActive, ShortestSizePixelsActive, FillBoxActive.
FitInBoxWidth (type:integer, range:>0, default:channel value)
Width in pixels, see FitInBoxActive
FitInBoxHeight (type:integer, range:>0, default:channel value)
Height in pixels, see FitInBoxActive
FillBoxActive (type:boolean, range:true/false, default:channel setting)
If true, resampling will be done so that the resulting image size is FillBoxWidth * FillBoxHeight values. Since resampling is done proportionally, the image might be cropped to fill the box completely. If the width and height ratio of the image is not equal to the width and height ratio of the specified box size, parts of the image will be cropped off, either at the top and bottom or at the left and right side of the image.
Of the following size tags, only one may be true: WidthInchesActive, WidthPixelsActive, HeightInchesActive, HeightPixelsActive, FitInBoxActive, LongestSizeInchesActive, LongestSizePixelsActive, ShortestSizeInchesActive, ShortestSizePixelsActive, FillBoxActive.
FillBoxWidth (type:integer, range:>0, default:channel value)
Width in pixels, see FillBoxActive
FillBoxHeight (type:integer, range:>0, default:channel value)
Height in pixels, see FillBoxActive
LongestSizeInchesActive (type:boolean, range:true/false, default:channel value)
Set the longest side of an image to a certain size in inches. The longest side is the width on a landscape image and height on a portrait image. The other side will be scaled proportionally.
Of the following size tags, only one may be true: WidthInchesActive, WidthPixelsActive, HeightInchesActive, HeightPixelsActive, FitInBoxActive, LongestSizeInchesActive, LongestSizePixelsActive, ShortestSizeInchesActive, ShortestSizePixelsActive, FillBoxActive.
LongestSizeInches (type:float, range:>0, default:channel value)
Size in inches, see LongestSizeInchesActive
LongestSizePixelsActive (type:boolean, range:true/false, default:channel value)
Set the longest side of an image to a certain size in pixels. The longest side is the width on a landscape image and height on a portrait image. The other side will be scaled proportionally.
Of the following size tags, only one may be true: WidthInchesActive, WidthPixelsActive, HeightInchesActive, HeightPixelsActive, FitInBoxActive, LongestSizeInchesActive, LongestSizePixelsActive, ShortestSizeInchesActive, ShortestSizePixelsActive, FillBoxActive.
LongestSizePixels (type:integer, range:>0, default:channel value)
Size in pixels, see LongestSizePixelsActive
ShortestSizeInchesActive (type:boolean, range:true/false, default:channel value)
Set the shortest side of an image to a certain size in inches. The shortest side is the width on a portrait image and height on a landscape image. The other side will be scaled proportionally.
Of the following size tags, only one may be true: WidthInchesActive, WidthPixelsActive, HeightInchesActive, HeightPixelsActive, FitInBoxActive, LongestSizeInchesActive, LongestSizePixelsActive, ShortestSizeInchesActive, ShortestSizePixelsActive, FillBoxActive.
ShortestSizeInches (type:float, range:>0, default:channel value)
Size in inches, see ShortestSizeInchesActive
ShortestSizePixelsActive (type:boolean, range:true/false, default:channel value)
Set the shortest side of an image to a certain size in pixels. The shortest side is the width on a portrait image and height on a landscape image. The other side will be scaled proportionally.
Of the following size tags, only one may be true: WidthInchesActive, WidthPixelsActive, HeightInchesActive, HeightPixelsActive, FitInBoxActive, LongestSizeInchesActive, LongestSizePixelsActive, ShortestSizeInchesActive, ShortestSizePixelsActive, FillBoxActive.
ShortestSizePixels (type:integer, range:>0, default:channel value)
Size in pixels, see ShortestSizePixelsActive
OrientationBasedOnExif (type:boolean, range:true/false, default:channel value)
If true, image will be rotated based on the exif metadata (camera info). The exif metadata will be adjusted accordingly.
MaxFileSizeInputActive (type:boolean, range:true/false, default:channel value)
Set a maximum size in mb, for files to be processed. If the file size of the original file exceeds this, the file will not be processed and moved to the channels’ folder for unprocessed images (FolderForUnprocessedImages in the Workflow node tag definitions). The reason might be to avoid longer processing times for larger files, and maybe even memory issues with extreme file sizes.
MaxFileSizeInput (type:integer, range:>0, default:channel value)
Maximum size for files to be processed in mb.
MaxImageSizeInputActive (type:boolean, range:true/false, default:channel value)
Set a maximum size in millions of pixels, for images to be processed. If the file size of the original image exceeds this, the image will not be processed and moved to the channels’ folder for unprocessed images (FolderForUnprocessedImages in the Workflow node tag definitions). The reason might be to avoid quality issues or longer processing times for larger images, and maybe even memory issues with extreme file sizes.
MaxImageSizeInput (type:integer, range:>0, default:channel value)
Maximum size for images to be processed in millions of pixels.
MinPdfImagePixelSizeActive (type:boolean, range:true/false, default:channel value)
Use a minimum size in number of pixels for images inside PDF files for them to be processed. Color conversion will be done on those images, but no enhancement.
MinPdfImagePixelSize (type:integer, range:>0, default:channel value)
Size in number of pixels, see MinPdfImagePixelSizeActive.