Skip to content

Pixel Analyzer

Brief Description

Analyze pixels in the image and computes statistics such as the minimum, maximum and mean intensities over the whole image or a user-defined region. Statistics are computed per image channel as keyframes on parameters in the RGBA, HSVL and Luminance sub-groups. This is useful to further edit the keyframes or link the parameters to other parameters.

When "Auto Analyze" is checked, the statistics are computed automatically during playback or when scrubbing the timeline. In this mode, if "Override Keyframes" is checked, Autograph will always recompute keyframes. Instead, if unchecked, only missing keyframes will be computed.

When "Auto Analyze" is unchecked, Analysis has to be manually launched by clicking on the "Analyze Frame" or "Analyze Layer Range" buttons.

The Analysis Region can be manually edited by selecting the line and editing the rectangle in the viewport

Controls

Parameter / Script Name Type Default Function
Enabled / enabled Boolean On
Analysis Region Mode / roiMode Choice Whole Image The region used to track the pixels. Selecting Analaysis Region and defining a smaller rectangle may improve performances
- Analysis Region
- Whole Image
Analysis Region / analysisRegion -500, -500, 500, 500
Enable RGBA Stats / enableRGB Boolean On When checked RGBA statistics will be computed when analysing
RGBA / rgbaStats Category -
RGBA Min / rgbaMin Color 0, 0, 0, 0 Minimum value
RGBA Max / rgbaMax Color 0, 0, 0, 0 Maximum value
RGBA Mean / rgbaMean Color 0, 0, 0, 0 Mean value
Enable RGBA Advanced Stats / rgbaEnableExtra Boolean Off When checked, the Standard Deviation, Kurtosis and Skewness are also analysed
RGBA S.dev. / rgbaSdev Color 0, 0, 0, 0 Standard deviation: quantifies the variability of the data
RGBA Kurtosis / rgbaKurtosis Color 0, 0, 0, 0 Whether the shape of the data distribution matches the Gaussian distribution: a value of 0 means it is a gaussian distribution. A flat distribution has a negative value, whereas a peaked distribution has a positive kurtosis
RGBA Skewness / rgbaSkewness Color 0, 0, 0, 0 How symmetrical the distribution is: A value of 0 indicates a symmetrical distribution, an asymmetrical distribution with a tail to the left has a negative skew and a distribution with a tail to the right has a positive skew
Enable HSVL Stats / enableHSV Boolean Off When checked HSVL statistics will be computed when analysing
HSVL / hsvlStats Category -
HSVL Min / hsvlMin Color 0, 0, 0, 0 Minimum value
HSVL Max / hsvlMax Color 0, 0, 0, 0 Maximum value
HSVL Mean / hsvlMean Color 0, 0, 0, 0 Mean value
Enable HSVL Advanced Stats / hsvlEnableExtra Boolean Off When checked, the Standard Deviation, Kurtosis and Skewness are also analysed
HSVL S.dev. / hsvlSdev Color 0, 0, 0, 0 Standard deviation: quantifies the variability of the data
HSVL Kurtosis / hsvlKurtosis Color 0, 0, 0, 0 Whether the shape of the data distribution matches the Gaussian distribution: a value of 0 means it is a gaussian distribution. A flat distribution has a negative value, whereas a peaked distribution has a positive kurtosis
HSVL Skewness / hsvlSkewness Color 0, 0, 0, 0 How symmetrical the distribution is: A value of 0 indicates a symmetrical distribution, an asymmetrical distribution with a tail to the left has a negative skew and a distribution with a tail to the right has a positive skew
Enable Luminance Stats / enableLuminance Boolean Off When checked Luminance statistics will be computed when analysing
Luminance / lumaStats Category -
Luminance Mode / lumaFormula Choice Rec. 709 Luminance formula used when mode is not None
- Rec. 709
- Rec. 2020
- ACES ap-0
- ACES ap-1
- CCIR 601
- Average: Average of intensities
- Max: Maximum of intensities
Min. Luminance Pixel / minLuminancePixelColor Float 0 RGB values of the pixel with the minimum luminance
Min. Luminance Position / minLuminancePixelPos Float 2D 0, 0 Position of the pixel with the minimum luminance
Max. Luminance Pixel / maxLuminancePixelColor Float 0 RGB values of the pixel with the maximum luminance
Max. Luminance Position / minLuminancePixelPos 2 Float 2D 0, 0 Position of the pixel with the maximum luminance
Auto Analyze / enableAutoAnalysis Boolean On When checked, analysis will be performed on the fly when during playback or scrubbing the timeline. When unchecked, analysis has to be started manually with the Analyze Frame or Analyze Layer Range buttons
Override Keyframes / autoAnalysisOverride Boolean Off Only relevant for auto analysis: When checked, analysis will always override existing keyframes, whereas if uncheked, only non existing keyframes will be computed
Analyze Frame / analyzeFrameButton Button Off
Analyze Layer Range / analyzeRangeButton Button Off
Light/Shadow Colorspace / input_colorspace Choice Project Display Space Colorspace in which the pixel color values are expressed in the baked keyframes
- Project Working Space: The color is assumed to be expressed in the project working space
- Project Display Space: The color is assumed to be expressed in the project display space