ImageEnhancement node tag definitions

A formal description of all available tags in the XML job ticket ImageEnhancement 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. A better explanation of the various enhancement settings can be found in the Image Enhancement settings. The slider values in the user-interface have a range of -5.0 to 5.0, in the XML specification you will see that the range is -10.0 to 10.0. The values in the user-interface are multiplied by 2 in the XML. A setting of 1.0 in the user-interface ends up in the XML as 2.0.

Settings represent target levels, enhancement is dynamic and based on image analysis. A 0.0 value means that it is on Pixometry’s default level. It does NOT mean that no enhancement is applied. To not use the sharpening filter at all for example, set the “ApplySharpening” tag to “false”.

ApplySharpening (type:boolean, range:true/false, default:channel value)If true, sharpening will be applied according to the “SharpeningLevel” tag.

SharpeningLevel (type:float, range:-10.0 to 10.0, default:channel value)

Target level of sharpness.

AdjustBrightness (type:boolean, range:true/false, default:channel value)

If true, brightness will be corrected according to the “BrightnessLevel” tag.

BrightnessLevel (type:float, range:-10.0 to 10.0, default:channel value)

Target level of brightness.

ApplyContrast (type:boolean, range:true/false, default:channel value)

If true, contrast will be adjusted according to the “ContrastLevel” tag.

ContrastLevel (type:float, range:-10.0 to 10.0, default:channel value)

Target level of contrast.

AdjustSaturation (type:boolean, range:true/false, default:channel value)

If true, saturation will be corrected according to the “SaturationLevel” tag.

SaturationLevel (type:float, range:-10.0 to 10.0, default:channel value)

Target level of saturation.

SetBlackWhitePoint (type:boolean, range:true/false, default:channel value)

if true, black and white point will be set.

SelectBlackWhitePoint (type:integer, range:0,1,2, default:channel value)

0=setting both the black point and the white point

1=setting only the black point

2=setting only the white point

WhitePointClip (type:float, range:0-100 (percentage), default:channel value)

Typically in the range of 0.1 to 0.5. Clip percentage of white pixels in determining the white point.

BlackPointClip (type:float, range:0-100 (percentage), default:channel value)

Typically in the range of 0.1 to 0.5. Clip percentage of black pixels in determining the black point.

SetWhitePointLimit (type:integer, range:0-255, default:channel value)

Set a maximum value for the white point (255 is 100% white). 255 is the normal value.

SetBlackPointLimit (type:integer, range:0-255, default:channel value)

Set a minimum value for the black point (0 is 100% black). 0 is the normal value.

SetWhitePointPercentage (type:integer, range:0-100 (percentage), default:channel value)

Perform X% of the correction that follows from setting the white point. 100% is default.

SetBlackPointPercentage (type:integer, range:0-100 (percentage), default:channel value)

Perform X% of the correction that follows from setting the black point. 100% is default.

ApplyNoiseFiltering (type:boolean, range:true/false, default:channel value)

If true, noise filtering will be applied according to the “NoiseLevel” tag.

NoiseLevel (type:float, range:-10.0 to 10.0, default:channel value)

Target level of noise filtering. The higher the number the stronger the noise filter applies.

AdjustColorBalance (type:boolean, range:true/false, default:channel value)

If true, color casts will be detected and corrected.

ApplyLocalContrast (type:boolean, range:true/false, default:channel value)

If true, shadow areas are opened up

LocalContrastLevel (type:float, range:-10.0 to 10.0, default:channel value)

How strong local contrast applies.

ApplyLocalContrastHL (type:boolean, range:true/false, default:channel value)

If true, details in mid-tones and highlights are enhanced.

LocalContrastHLLevel (type:float, range:-10.0 to 10.0, default:channel value)

How strong local contrast for highlights applies.

ApplyRedEyeRemoval (type:boolean, range:true/false, default:channel value)

if true, red eye detection and correction is applied.

ApplyRedEyeOnlyWhenFlashUsed (type:boolean, range:true/false, default:channel value)

if true, red eye detection and correction is applied only if, according to EXIF metadata, a flash was used during capture.

RedEyeRemovalStrength (type:float, range:-10.0 to 10.0, default:channel value)

Strength with which the red eye correction is applied.

ApplySkintone (type:boolean, range:true/false, default:channel value)

if true, skin tone correction will be applied.

ApplySkintoneSaturation (type:boolean, range:true/false, default:channel value)

if true, skin tone saturation correction will be applied.

ApplySkintoneBrightness (type:boolean, range:true/false, default:channel value)

if true, skin tone brightness correction will be applied.

SkintoneHue (type:float, range:-10.0 to 10.0, default:channel value)

<0 = more red in skin tones

>0 = more yellow in skin tones

SkintoneStrength (type:float, range:-10.0 to 10.0, default:channel value)

Strength with which the skin tone correction applies

SkinSaturationLevel (type:float, range:-10.0 to 10.0, default:channel value)

Target level of skin tone saturation

SkinBrightnessLevel (type:float, range:-10.0 to 10.0, default:channel value)

Target level of skin tone brightness

ApplyGreentone (type:boolean, range:true/false, default:channel value)

if true, green tone correction will be applied, to enhance natural green colors (vegetation).

ApplyGreentoneSaturation (type:boolean, range:true/false, default:channel value)

if true, green tone saturation correction will be applied.

ApplyGreentoneBrightness (type:boolean, range:true/false, default:channel value)

if true, green tone brightness correction will be applied.

GreentoneHue (type:float, range:-10.0 to 10.0, default:channel value)

<0 = more yellow in green tones

>0 = more blue in green tones

GreentoneStrength (type:float, range:-10.0 to 10.0, default:channel value)

Strength with which the green tone correction applies

GreenSaturationLevel (type:float, range:-10.0 to 10.0, default:channel value)

Target level of green tone saturation

GreenBrightnessLevel (type:float, range:-10.0 to 10.0, default:channel value)

Target level of green tone brightness

ApplyBluetone (type:boolean, range:true/false, default:channel value)

if true, blue tone correction will be applied, to enhance natural blue colors (skies and water).

ApplyBluetoneSaturation (type:boolean, range:true/false, default:channel value)

if true, blue tone saturation correction will be applied.

ApplyBluetoneBrightness (type:boolean, range:true/false, default:channel value)

if true, blue tone brightness correction will be applied.

BluetoneHue (type:float, range:-10.0 to 10.0, default:channel value)

<0 = more green in blue tones

>0 = more purple in blue tones

BluetoneStrength (type:float, range:-10.0 to 10.0, default:channel value)

Strength with which the blue tone correction applies

BlueSaturationLevel (type:float, range:-10.0 to 10.0, default:channel value)

Target level of blue tone saturation

BlueBrightnessLevel (type:float, range:-10.0 to 10.0, default:channel value)

Target level of blue tone brightness

ApplyNoiseFilterLuminosityMode (type:boolean, range:true/false, default:channel value)

If true, the image will be converted to LAB color space and noise filter will be applied on the luminance channel only.

ContrastLuminosityMode (type:boolean, range:true/false, default:channel value)

If true, the image will be converted to LAB color space and contrast curve will be applied on the luminance channel only.

BrightnessMidTonesOnly (type:boolean, range:true/false, default:channel value)

If false, a gamma curve will be used to apply brightness corrections. A gamma curve applies stronger in dark areas.

if true, a curve will be used with the focus more on mid tones.

ApplyColorFilter (type:boolean, range:true/false, default:channel value)

If true, a color filter will be applied, with similar effect as if a color filter would have been placed on the camera lens. However, there are additional options for the color of the filter, the strength of the filter and to exclude certain areas from the filter. See other ColorFilter options.

ColorFilterStrength (type:float, range:-10.0 to 10.0, default:channel value)

The strength or density of the color filter.

ColorFilterKeepSkin (type:boolean, range:true/false, default:channel value)

Exclude skin tones from the color filter. Skin tones will not be affected.

ColorFilterKeepNeutrals  (type:boolean, range:true/false, default:channel value)

Exclude neutral tones (whites and greys) from the color filter. Neutral tones will not be affected.

ColorFilterRGB (type: string, range:, default: channel value)

RGB value for the color filter.

ColorFilterKeepBlue (type:boolean, range:true/false, default:channel value)

Exclude blue sky from the color filter. Blue sky will not be affected.

SuppressBanding (type:boolean, range:true/false, default:channel value)

Reduce banding effects in blue skies. Banding can result from strong (jpg) compression.

ExcludeSkinFromLocalContrastHighlights (type:boolean, range:true/false, default:channel value)

Exclude skin tones from the effect of the local contrast for highlights function. For softer skin tones in portraits.

SuppressCheckerboarding (type:boolean, range:true/false, default:channel value)

JPG artefacts reduction.