PlotScanline |
Function
The PlotScanline function is an analysis tool that examines a line of an image and graphs the intensity of each channel per X position. It greatly helps to determine what a color correction function is doing. Although it can be attached to any image for analysis, it is often attached to a horizontal Ramp to observe the behavior of a color correction. Switch the Viewer to view the alpha channel (press A in the Viewer), and see the behavior of the alpha channel.
The following are some examples of using the PlotScanline function.
Example 1
A 256x256 8-bit black and white Ramp. Since we have a smooth gradation, with the center at .5, we see a straight line. Moving the center to .75 pushes the center to the right, making the entire image darker. This is reflected in the PlotScanline:
![]() |
![]() |
![]() |
Example 2
In this example, some color correction nodes are inserted and the values are adjusted. The PlotScanline indicates exactly what data gets clipped, crunched, compressed, or confused.
![]() |
![]() |
|
Parameters
|
Type
|
Defaults
|
Function
|
| width,height |
int
|
width, 512
|
The width and height of the PlotScanline. You probably want to set the width to 256 on an 8-bit image to get 1-to-1 correspondence. |
| line |
int
|
0
|
The Y-line of the image to be analyzed. On a horizontal ramp, this doesn't matter, since they are all identical. |
Synopsis
image PlotScanline( image, int width, int height, int line );
Script
image = PlotScanline(image, width, height, line);
Command Line
shake -plotscanline width height line
See Also
Histogram