|
| |
The drawing instructions allow drawing shapes and working with
image and sound files. Drawing may be performed on main plot, plotting
objects, and the plot background. Colors may be the values 0-15, or
defined by the color macro value.
 |
Drawing Instructions must be preceded with one of the following symbols:
~ Temporary, not saved. Acts even when plotting is off.
@ Constant - not cleared on reset. Acts even when plotting is off.
^ Saved as data point for saves, redraws, playing. Plotting must be on.
! Saved as data point for saves, redraws, playing for use with
graphics and images only. Restricts the shape or
image to within the plot grid. Plotting must be on.
|
| Drawing on the Main Plot:
To draw on the main plot, an instruction such as the following is used:
X, Y coordinates may be relative (no suffix), absolute (A) , offset (F), percent
(P), or or timed (T0-T9 and L0-L9) accordingly. Y may also use D0 - D9 to place text in line with the digital plots.
X coordinates may also be date time.
'Draws a temporary filled red box using coordinates
relative to the plot scales.
~FREC 10,20,30,40,(RED)
'Draws a filled cicle at the absolute coordinates of 50 and 50 (middle
of plot).
^FCIR 50A,50A,5,(YELLOW)
'Place an image in the plot area as a constant drawing.
@IMGP 10a,10a,20a,20a,comp\led_red_0.jpg
|
| Drawing on Plotting Objects.
Drawing may be performed on plotting objects in the same fashion as the main
plot, but the structure is a little different.
~POBJ obj_name.Draw=FCIR 50,50,5,(GREEN)
|
| Drawing on the StampPlot background.
The StampPlot background may also be used for images and drawing. The
background only uses absolute coordinates of 0,0 (lower left) to 100,100
(upper-right).
!PPER 50,50
@POBJ oBack.Draw=IMGP 80,0,100,20,comp\LED_Red_1.jpg
|
Graphics
Drawing Control
Paged Drawing
Miscellaneous
Color Macro Values
Graphics:
ACHN channel number (1-9), value, color
Plot Analog Channel
Plots a line using one of 9 analog channels. Data is saved as a LINE command using time referenced X-coordinates. The preferred method for multiple analog plots is to comma-separate the analog data.
@ACHN 1,200,(BLUE) |
CIRC center x,center y,radius,color
Draws an unfilled circle.
@CIRC 50a, 50a, 5, (RED) |
DARC center x,center y,radius, start angle, end angle,color
Draws an arc.
@DARC 20,20,5a, 45,135,(YELLOW) |
DPIE center x,center y,radius, start angle, end angle, color
Draws an unfilled pie.
@DPIE 50a, 60, 5a, 90,180,(GREEN) |
DPNT x,y,color
Plots a single point
@DPNT T0, 20, (RED) |
FCIR x,y, radius, color
Draws a filled circle
@FCIR 60, 125, 5, (BROWN) |
FPIE x,y,radius, start angle, end angle, color
Draws a filled pie. Angles are in degrees. Angles starting with 0 tend to produce errors in the image. Try to avoid when possible.
@FPIE 50a, 60, 4a, 100,170,(BLACK) |
FREC x1,y1,x2,y2,color
Draws a filled rectangle.
@FREC 80a,20a,120,120,(D_BLUE) |
IWAV wavename .wav
Immediately Play WAV file, DO interrupt in-progress.
(root directory is s-plot media)
~IWAV boing.wav |
IMGP x1,y1,x2,y2,imagename
Plots an image on the screen at coordinates provided. (root directory is
StampPlot\Media)
~IMGP 0a,0a,30a,40a,\comp\meter.jpg |
IMGO x1,y1,x2,y2,imagename
Plots an image on the screen at coordinates provided. logically ORing the colors with current colors. (root directory is s-plot media)
~IMGO 50p,0a,80p,50a,\wood\cedar\rect.jpg |
IMGA x1,y1,x2,y2,imagename
Plots an image on the screen at coordinates provided. logically ANDing the colors with current colors.(root directory is s-plot media)
~IMGA 50p,0a,80p,50a,\wood\cedar\rect.jpg |
LINE x1,y1,x2,y2,color
Draws a line
@LINE 50a,0a,50a,100a,(RED) |
RECT x1,y1,x2,y2,color
Draws an unfilled rectangle. Angles starting with 0 tend to produce errors in the image. Try to avoid when possible.
@RECT L0,80a,T0,90a,(VIOLET) |
TEXT x,y, size, color, text
Writes text starting at given point. Size is in relation to scale value size (1 = same)
@TEXT 20a,15a,1.5,(D_GREEN),StampPlot!
Note:
\n can be used in the instruction for a line feed
\t can be used in the text for a tab
@TEXT 20a,15a,1.5,10,StampPlot!\nMakes plotting easy! |
PWAV wavename .wav (root directory is s-plot\media)
Play WAV file, don't interrupt in-progress
wavs.(root directory is s-plot media)
~PWAV boing.wav |
Drawing Controls:
| FGRD |
Fresh Grid
Clears the current data on plot. Redraws grid, scale, constant images. Drawing instructions will NOT saved data to be redrawn. This command is useful to redraw a grid if the spans or other conditions change, and it is desired to be able to have the new grid show the change when playing back data. NOTE: Do not use
@FGRD or the plot will lock up as it continually tries to re-grid.
^FGRD |
| FONT font name |
Sets the drawing font to any legal system font name.
~FONT Arial |
| DWTH value |
Draw Width
Sets the drawing width of drawn graphic objects (1 is default).
@DWTH 5 |
| AWTH value |
Sets the width of the analog traces.
~AWTH 5 |
| DMOD value 0-16 |
Draw Mode
Hmmmm, what to say about DMOD... Draw mode is a number from 0 to 16 defining how a newly drawn image pens will combine with previous colors on the plot. They can produce some great effects, but without getting into a lengthy discussion, 13 is default. 3 is quite interesting. Test out various modes!
^DMOD 3
|
| SETX x-coordinate |
Sets the beginning coordinate for offset drawing. The value of X may be relative, absolute or timed.
^SETX T0
|
| SETY y-coordinate |
Sets the beginning coordinate for offset drawing. The value of y may be relative, absolute or timed.
^SETY 20a
|
| ENDX value |
Combined with SETX and SETY to form boundaries for percent plotting
^ENDX 30a |
| ENDY value |
Combined with SETX and SETY to form boundaries for percent plotting
^ENDY 30a |
| COOR StartX,StartY,EndX,endY |
COOR may be used in place of setX, etc.
Used for defining a rectangular region on the plot for percent coordinate mode drawing.
@COOR 0a,10a,20,40a |
Paged Drawing:
| CPY0 |
Copy page 0 to page 1
Copies the image of page 0 to page 1 as background image (picture).
Can only be cleared with CPG1
^CPY0 |
| CPY1 |
Copy page 1 to page 0
Copies the image of page 1 to page 0 as background image (picture).
Can only be cleared with CLP0.
^CPG1 |
| CPG0 |
Clears a copied image from page 0
^CPG0 |
| CPG1 |
Clears a copied image from page 1
^CPG1 |
| DPG0 |
Draw on page 0
Sets the plot to draw on Page 0 (default)
^DPG0 |
| DPG1 |
Draw on page 1
Sets the plot to draw on Page 1.
^DPG1 |
| VPG0 |
View Page 0
View page 0 of plotted data
^VPG0 |
| VPG1 |
View Page 1
View Page 1 of plotted data
^VPG1 |
Miscellaneous:
| PAUS seconds |
Sets a pause in playing back the plot -- Takes effect only during playback. Good for animated & timed drawings.
^PAUS 2
|
Command Instructions which may be used as drawing instructions with saved data for
playback.
(see commands instructions for syntax and use):
This list, when used as command instructions (!) will cause the plot to redraw. When used as drawing commands (!,@,^) they will not cause a redraw (refresh). Saved data cannot be redrawn within drawing data (recursive calls). To refresh the plot WITHOUT redrawing past data, use FGRD. This will redraw the grid and any @ data but not ^ data.
SPAN AMAX AMIN PMOD TMAX AMUL DISP
COLR CLRC GRID SQRD
This list does not require any redrawing to take place.
CLMM CMMR USRS STAT SHFT TITL BELL
| Color Macro Values:
These macro values may be used when specifying colors:
(BLACK)
(D_BLUE)
(D_GREEN)
(BROWN)
(TEAL)
(PURPLE)
(OLIVE)
(GREY)
(D_GREY)
(BLUE)
(GREEN)
(AQUA)
(RED)
(MAGENTA)
(YELLOW)
(WHITE)
|
|
