User Guide

  • 2020.4
  • 12/10/2020
  • Public Content

Graphics Frame Analyzer Tab: Pixel History

Pixel History
tab displays a zoomed-in view of the Render Target View and a list of ergs affecting the selected pixel. Initially this tab is blank. To populate the tab, select a pixel in the Render Target Viewer pane. After that you can select pixels right under this tab. When you click on a pixel in the
Pixel History
tab, the image is re-centered on the selected pixel. For example, in the screenshot below, the gray crosshair is centered on the selected pixel at (401, 126).
Clicking on a pixel in the
Pixel History
tab updates the crosshair in the Render Target View. For example, if you select pixel (396, 122) in the
Pixel History
tab, then the crosshair in the Render Target View moves to (396, 122).
Pixel History
tab’s image is locked in place and you cannot pan or zoom it in/out.
Pixel History
tab contains the following elements:
Pixel History Thumbnail List
This item contains small images that are ergs affecting the pixel.
On the right of each image, there are rows of text providing the following information:
  • erg number
  • erg type (clear, DrawIndexedPrimitive, etc.)
  • the number of times the call touched the pixel A pixel is “touched” by a call if the following tests passed: Z-test, Alfa test, Stencil test, and Scissor test.
  • if the pixel was rejected prior to touching the pixel, the reason for the rejection (for example, "Pixel was Z-rejected") A pixel is “rejected” if at least one of the following tests failed: Z-test, Alfa test, Stencil test, and Scissor test.
  • the final color of the selected pixel
 To select a certain erg, or to add an erg to the selection set, right-click on any thumbnail, and select the appropriate context menu option.
Pixel History Render Target View
This view shows the render target with two crosshairs overlaid to indicate the pixel location. The center of each crosshair uses a square to highlight the pixel. A red crosshair shows the current mouse position and tooltip shows the current coordinates within the image. A gray crosshair shows the previously selected pixel’s position. See the image above.
Select Ergs Button
Click this button to select the ergs that have affected the selected pixel.
Refresh Button
Click this button to re-calculate the pixel history for pixels selected in the
Render Target View
to reflect the current tool state. This button is active only after you modify something in the scene (for example, use an item in the
Tab or set an override mode).
Pixel Information Field
This item shows the pixel coordinates, the erg range, and the number of times the call touched the pixel.
Image Information Bar
Image Information Bar
  • the image format
  • the image resolution
  • the color of the pixel under the cursor
  • the pixel history coordinates entered by a user (X, Y coordinates)
Enter (X, Y) coordinates in the editable fields and click
to get the pixel history for that location.
Histogram Pane
This pane contains the histogram of the frame buffer image. To open the histogram, pull the slider from the right of the image to the left, or double-click it.
The histogram enables you:
  • to visualize the color data within the frame buffer
  • to set the highlight and shadow clamping points for viewing the buffer; use the
    sliders at the bottom of the histogram
  • to increase the dynamic range of the buffer you are viewing, so you can better see the data inside 
Histogram Color Channel Selection Drop-down List
This drop-down list enables you to configure the channels viewed for the selected frame buffer. These are the available options:
  • RGB
    mode - ignores the alpha channel if one is present
  • RGBA
    mode - weights the color values by the alpha channel; if all the alpha values of the image are 0, then no color information will be visible and so the image will appear white
  • Red
    Blue Color Channels
    - shows the image information in red/green/blue color
  • Grayscale
    –a grayscale conversion of the RGB data that was present in the buffer
  • Alpha Channel
    - a grayscale conversion of only the alpha data of the buffer
Selecting ergs and changing highlighting colors lead to the image and histogram changes.
Auto Clamp Button
Click this button to automatically adjust the
sliders of the current histogram so that they clamp the view of the buffer to the lowest and highest data points in its histogram.
See Also

Product and Performance Information


Performance varies by use, configuration and other factors. Learn more at