Action
Start an animated spinner.
Syntax
CmdSpinner x, y, style, range
Remarks
x |
The X coordinate of top left of spinner |
y |
The Y coordinate of top left of spinner |
style |
The style of spinner. Valid range is from 0 to 3 |
range |
The scaling coefficient of spinner. 0 means no scaling |
The spinner is an animated overlay that shows the user that some task is continuing. To trigger the spinner, create a display list and then use CMD_SPINNER. The co-processor engine overlays the spinner on the current display list, swaps the display list to make it
visible, then continuously animates until it receives CMD_STOP. REG_MACRO_0 and REG_MACRO_1 registers are utilized to perform the animation kind of effect. The frequency of points movement is with respect to the display frame rate configured.
Typically for 480x272 display panels the display rate is ~60fps.
For style 0 and 60fps the point repeats the sequence within 2 seconds.
For style 1 and 60fps the point repeats the sequence within 1.25 seconds.
For style 2 and 60fps the clock hand repeats the sequence within 2 seconds.
For style 3 and 60fps the moving dots repeat the sequence within 1 second.
Note that only one of CmdSketch, CmdScreenSaver or CmdSpinner can be active at one time.
Example
' Pseudocode
' Create a display list, then start the spinner
Clear_B 1,1,1
CmdText 80, 30, 27, OPT_CENTER, "Please wait..."
CmdSpinner 80, 60, 0, 0
' Spinner style 0, a circle of dots
CmdSpinner 80, 60, 0, 0
' Style 1, a line of dots
CmdSpinner 80, 60, 1, 0
' Style 2, a rotating clock hand
CmdSpinner 80, 60, 2, 0
' Style 3, two orbiting dots
CmdSpinner 80, 60, 3, 0
' Half screen, scale 1
CmdSpinner 80, 60, 0, 1
' Full screen, scale 2
CmdSpinner 80, 60, 0, 2
