Properties

The Analog Plot has a wide assortment of properties in a variety of categories. The entire list is best viewed in the Interface Editor (F3), the Debug/CLI Wndow (F4), Code Editor or the Controls Viewer (F6). In many views, selecting and right-clicking a property will open its help.

A selection of properties will be discussed here. A property may be set through the Interface Editor or in MPJ code or sent via microcontroller code:
!controlName.property=value

A property value may be read in code with:

? [controlName.property]

See Interface Editor for more information on using the window below.

The Analog Plots have several categories of properties:

•Plot Control

•Plot Appearance

•Channel Configuration

•Control Settings

Plot Control

Plot Control properties, as the name implies, general deal with controlling the plot itself.

Many of these are handled by icons on the plot itself or via the plot's pop-up menu, but a few items of interest are discussed:

•manualPlotOnly (1 or 0). When enabled the plot will not automatically plot data as serial data is processed. Plotting must be performed using:
!controlName.plotCh 3, 50  // Plots value of 50 on channel 3 of the plot.
 

•refreshTime and refreshManual can be used to limit how much the plot is refreshed which may allow the software to run faster overall. If refreshTime is 0, the plot will refresh as new data is plotted or other events occur, such as clicking it, otherwise it will refresh at the given number of milliseconds.
!refreshTime=3000 // refresh every 3 seconds
!refreshManual   // refresh only with certain events, such as a mouse click or using !plot.refresh
 

•ShowAtYLimits (1 or 0): When enabled will show the plotted values that exceed the maximum or minimum Y-Axis values as flat lines to help indicate data is present but off-plot.
 

•dragZoom (1 or 0): When disabled, clicking a plot and dragging to zoom into an area will not be performed.
 

Plot Appearance

These deal with how the plot appears. Again, many are accessible via settings or the plot's pop-up menu.

Channel Configuration

This section configures the label, color and formula used in plotting data, and whether the channel is visible or not. All can be accessed via the pop-up menu, Settings window. See Configuring Channels.

Control Settings

This section controls some behaviors and the location of the Analog Plot Control.

Some properties of note:

•maxDataPoints and noChangeSkip reference the total points saved to memory for redrawing. See Data Points for more information.

•MaxDrawings and MaxConstDrawing refer to drawing instructions performed and how many will be kept in memory for redrawing. Please see Drawings for the Analog Plot Control.

•ResetAutoSnap - Take a snapshot of the plot only (not the interface) prior to an automatic reset when reaching the X Limit.The name is based on the plot title plus date and time.