Call Box Commands
Version 2.0 15 Jan-90


CALL CU the CURSOR/ICON commands

There are 6 commands that control cursors, and 2 commands the control icons. There are 2 system cursors, the primary cursor is the arrow cursor and the second is the wait cursor (wrist watch). You can load up to 16 more cursors making a total of 18 possible cursors in any given application. You can have 64 icons as well.

Cursor #0 is the arrow cursor and Cursor #1 is the wait cursor. Cursors 0 thru 15 are available for loading. There are no standard icons so icons 0-63 are available for loading. Cursors and icons can be created and edited using the CALL BOX Image Editor.

COMMAND FUNCTION DESCRIPTION
CALL CU,O CURSOR OFF: this makes the current cursor invisible.
CALL CU,1 CURSOR ON: this makes the current cursor visible.
CALL CU,2 ARROW: this makes the current cursor the system arrow cursor.
CALL CU,3 WAIT: this makes the current cursor the system wait cursor.
CALL CU,4,N SET CURSOR: this sets the current cursor to the user defined cursor (0-15).
CALL CU,5,N,"pathname" LOAD CURSOR: this will load a cursor from disk as cursor I.D. 0-15.
CALL CU,6,N,M,X,Y PLOT ICON: this plots an icon (0-63) at coordinates X and Y in mode M.
CALL CU,7,N,"pathname" LOAD ICON: this loads an icon from disk as icon I.D. 0-63.

N
User cursor or icon i.b. number. There are 16 possible I.D. numbers for cursors (0-15) and 64 for icons (0-63).

"pathname"
ProDOS pathname for the cursor or icon file to load.

X
Horizontal icon plotting position.

V
Vertical icon plotting position.

M
Icon plotting mode.(see Figure 2.2)

Figure 2.2
Figure 2.2 Icon mode flags

Cursors and Icons have similar structures (see Figure 2.3) but are handled by the IIgs toolbox differently. Cursors have several special considerations that need to be taken care of for them to work properly. The Image Editor chapter in the Call Box Editors manual outlines these peculiarities.

Figure 2.3
Figure 2.3 Icon and Cursor structures