Technical data

296 Agilent Infiniium 9000 Series Oscilloscopes Programmer's Reference
16 Display Commands
:DISPlay:CGRade
Command :DISPlay:CGRade {{ON | 1} | {OFF | 0}}
The :DISPlay:CGRade command sets the color grade persistence on or off.
When in the color grade persistence mode, all waveforms are mapped into
a database and shown with different colors representing varying number
of hits in a pixel. "Connected dots" display mode (:DISPlay:CONNect) is
disabled when the color grade persistence is on.
The oscilloscope has three features that use a specific database. This
database uses a different memory area than the waveform record for each
channel. The three features that use the database are:
• Histograms.
• Mask testing.
• Color grade persistence.
When any one of these three features is turned on, the oscilloscope starts
building the database. The database is the size of the graticule area and
varies in size. Behind each pixel is a 53- bit counter. Each counter is
incremented each time a pixel is hit by data from a channel or function.
The maximum count (saturation) for each counter is 9,007,199,254,740,991.
You can check for counter saturation by using the DISPlay:CGRade:LEVels?
query.
The color grade persistence uses colors to represent the number of hits on
various areas of the display. The default color- grade state is off.
Example This example sets the color grade persistence on.
myScope.WriteString ":DISPlay:CGRade ON"
Query :DISPlay:CGRade?
The DISPlay:CGRade query returns the current color- grade state.
Returned Format
[:DISPlay:CGRade] {1 | 0}<NL>
Example This example returns the current color grade state.
Dim strCgrade As String ' Dimension variable.
myScope.WriteString ":DISPlay:CGRade?"
strCgrade = myScope.ReadString
Debug.Print strCgrade
See Also • ":DISPlay:CGRade:LEVels?" on page 297
• ":DISPlay:CGRade:SCHeme" on page 299