Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Fileappl_tplay()
Application Services Library
appl_trecord()                                                          AES

Syntax

WORD appl_trecord( mem, num )
VOIDP mem;
WORD num;

Function       appl_trecord() records AES events for later playback.

Opcode         15 (0x0F)

Availability   All AES versions.

Parameters     mem points to an array of num EVNTREC structures into which
               the AES will record events as indicated here:

               typedef struct pEvntrec
               {
                WORD ap_event;
                LONG ap_value;
               } EVNTREC;

               ap_event defines the required interpretation of ap_value
               as follows:

               Name         ap_event Event     ap_value

               APPEVNT_TIMER    0    Timer     Elapsed Time (in
                                               milliseconds)

               APPEVNT_BUTTON   1    Button    low word  = state
                                                           (1 = down)
                                               high word = # of clicks

               APPEVNT_MOUSE    2    Mouse     low word  = X pos
                                               high word = Y pos

               APPEVNT_KEYBOARD 3    Keyboard  bits 0-7:   ASCII code
                                               bits 8-15:  scan code
                                               bits 16-31: shift key
                                               state

Binding        intin[0] = num;

               addrin[0] = mem;

               return crys_if(0x0F);

Return Value   appl_trecord() returns the number of events actually
               recorded.

Caveats        This function does not work correctly on AES versions less
               than 1.40 without a patch program available from Atari
               Corp.

See Also       appl_tplay()

Group          Application Services Library