Unit 'agraphics' Package
[Overview][Constants][Types][Procedures and functions][Variables][Index] [#os4units]

BltClear

Clear a block of memory words to zero.

Declaration

Source position: agraphics.pas line 2343

procedure BltClear(

  MemBlock: PByte;

  ByteCount: LongWord;

  Flags: LongWord

);

Arguments

MemBlock

  

pointer to local memory to be cleared memBlock is assumed to be even.

ByteCount

  

if bit 1 is set to 1: bytecount contains an even number of bytes to clear if bit 1 is set to 0: low 16 bits are taken as number of bytes per row and upper 16 bits are taken as number of rows.

Flags

  

set bit 0 to force function to wait until the blit is done. set bit 1 to use row/bytesperrow.

Description

For memory that is local and blitter accessible, the most efficient way to clear a range of memory locations is to use the system's most efficient data mover, the blitter. This command accepts the starting location and count and clears that block to zeros.

THIS FUNCTION IS DEPRECATED


Documentation generated on: 2021-07-30