Legacy Document

Inside Macintosh: Imaging With QuickDraw /

Chapter 8 - Cursor Utilities / Cursor Utilities Reference

Data Structures /

Acur

Your application typically does not create Acur records, which are data structures of type Acur. Although you can create an Acur record, which specifies the 'CURS' resources to use in an animated cursor sequence, it is usually easier to create an animated cursor ('acur') resource, which is described on page 8-33.

When your application uses the InitCursorCtl procedure (described on page 8-20), the Resource Manager loads an animated cursor resource into memory as an Acur record, which in turn is used by the RotateCursor procedure or SpinCursor procedure (both described on page 8-30) when sequencing through 'CURS' resources.

An Acur resource is defined as follows:

TYPE acurPtr = ^Acur;
acurHandle = ^acurPtr;
Acur = 
   RECORD
      n:       Integer;    {number of cursors ("frames")}
      index:   Integer;    {reserved}
      frame1:  Integer;    {'CURS' resource ID for frame #1}
      fill1:   Integer;    {reserved}
      frame2:  Integer;    {'CURS' resource ID for frame #2}
      fill2:   Integer;    {reserved}
      frameN:  Integer;    {'CURS' resource ID for frame #N}
      fillN:   Integer;    {reserved}
   END;

Field Description

n

The number of frames in the animated cursor.

index

Used by basic QuickDraw to create the animation.

frame1

The resource ID of the cursor ('CURS') resource for the first frame sequence of the animation. The cursor resource is described on page 8-31.

fill1

Reserved.

frame2

The resource ID of the cursor resource for the next frame in the sequence of the animation.

fill2

Reserved.

frameN

The resource ID of the cursor resource for the last frame used in the sequence of the animation.

fillN

Reserved.