SS.AAGBf_Set_Status

Reserves an additional graphics buffer.

Entry Conditions

A
path number

B
SS.AAGBf ($80)

Exit Conditions

X
buffer address

Y
buffer number (1-2)

Error Output

CC
carry set on error

B
error code

Additional Information

• SS.AAGBf allocates an additional 8K graphics buffer. The first buffer (Buffer 0) must be allocated by using the DISPLAY GRAPHICS command. To use the DISPLAY GRAPHICS command, send control code $0F to the standard terminal driver. SS.AABGf can allocate up to two additional buffers (Buffers 1 and 2), one at a time.
• After calling SS.AAGBf, Register X contains the address of the new buffer. Register Y contains the buffer number.
• To deallocate all graphics buffers, use the END GRAPHICS control code.
• When SS.AAGBf allocates a buffer, it also maps the buffer into the application's address space. Each buffer uses 8K of the available memory in the application's address space. Also, if SS.DStat is called, Buffer 0 is also mapped into the application's address space. Allocation of all three buffers reduces the application's free memory by 24K.
• The support module for this call is VDGINT.