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.