fillmem-l.rst

FILLMEM_L

Syntax	FILLMEM_L start_address, how_many, value
Location	DJToolkit 1.16

Fill memory with a long (32 bit) value.

EXAMPLE

The screen memory is 32 kilobytes long. To fill it all black, try this:

1000 FILLMEM_B SCREEN_BASE(#0), 32 * 1024, 0

or this:

1010 FILLMEM_W SCREEN_BASE(#0), 16 * 1024, 0

or this:

1020 FILLMEM_L SCREEN_BASE(#0), 8 * 1024, 0

and the screen will change to all black. Note how the second parameter is halved each time? This is because there are half as many words as bytes and half as many longs as words.

The fastest is FILLMEM_L and the slowest is fillmem-b. When you use fillmem-w or FILLMEM_L you must make sure that the start_address is even or you will get a bad parameter error. fillmem-b does not care about its start_address being even or not.

fillmem-b truncates the value to the lowest 8 bits, fillmem-w to the lowest 16 bits and FILLMEM_L uses the lowest 32 bits of the value. Note that some values may be treated as negatives when peek'd back from memory. This is due to the QL treating words and long words as signed numbers.

CROSS-REFERENCE

fillmem-b, fillmem-w.