usage: r_setsweep opflg eflag ltime Varb Color Times Flg v0 vysc vy0 I0 Idel Npts ymn ymx t0 wgt
or: r_setsweep opflg eflag ltime 0 Varb Times Flg IParams FParams

R_SETSWEEP is called for each variable to be displayed by subsequent R_SWEEP commands.

Arguments to R_SETSWEEP have the folling meanings:

• VARB - The name of the variable to be displayed
  
• TIMES - Array of sampled time stamps, or single sampling interval value DT. All times are in 20us ticks. If DT is specified you should probably also specify T0.
  
• FLG - Display options (see below)

In the older version of R_SETSWEEP, the fourth argument is VARB and the display parameters are specified explicitly as:

• COLOR - 24-bit RGB color value to use
  
• V0 - data offset value (default=0)
• YSC - data scale factor (default=1)
• Y0 - display pixel offset (default=0 pixels)
• I0 - offset to first data value in wsiz units (default=0)
• IDEL - step from one data value to next (default=1)
• NPTS - max # pts in datavarb (default=until current ptr)
• YMN - low y pixel values clipped to ymn (rel. sweep rect)
• YMX - if ymx, y pixel values clipped to ymx (relative to sweep rect)
• T0 - timestamp of first value in VARB if TIMES is DT.
• WGT - percent of previous value to average with new value

In the newer version of R_SETSWEEP, the fourth argument is 0. The display arguments are then specified using
the IPARAMS array, with values:

• COLOR - 24-bit RGB color value to use
  
• V0 - data offset value (default=0)
• Y0 - display pixel offset (default=0 pixels)
• YMN - low y pixel values clipped to ymn (rel. sweep rect)
• YMX - if ymx!=0, y pixel values clipped to ymx (relative to sweep rect)
• NPTS - max # pts in datavarb (default=until current ptr)
• I0 - offset to first data value in wsiz units (default=0)
• IDEL - step from one data value to next (default=1)
• WGT - percent of previous value to average with new value
• DT - time difference between values (?)
• T0 - timestamp of first value in VARB.

and the FPARAMS array, with values:

• yscale

Note 1: The data value, V0, YSC, and Y0 parameters are converted to vertical display offset as:

y = (VARB - V0) * YSC + Y0 

Note 2: To autoscale the display, R_SETSWEEP should specify YMAX and YMIN explicitly, and set V0, VYSC, and VY0 to 0. Calling R_SWEEP with the AUTOSCALE flag option will adjust V0, VYSC, and VY0 so that typical display values fall within 80% of YMIN-YMAX.

By default, R_SWEEP will display the entire variable with a continuous line. The FLG argument can be used to select alternative display options. Recognized FLAG values are:

1-15 - tick flag (tickflag * 2 - 1 pixels)
(if no tick flag, make continuous curve)
  20o - real-time wait flag: only display portion of varb already filled
  40o - state flag: only horizontal and vertical lines
 100o - YMAX is relative to YMIN
 200o - data varb value is percentage of YMAX-YMIN
 400o - do not allow auto-scaling of this data varb
1000o - change settings (can be used repeatedly after initial call,
        only specified variables will be changed). 
        Note: VARB and TIMES array cannot be changed. 
2000o - change settings are relative (add offsets, multiply scale factors)
4000o - VARB is index number of VARB to change (i.e., VARB=1 means change
        settings for 1st variable called with R_SETSWEEP.

See Also:
CIGAL Home, CIGAL Manual, RealTime List, Manual Help