WritePixelFast

Top  Previous  Next

Syntax

WritePixelFast(x as INT,y as INT,col as UINT,OPT buffer as POINTER)

Description

A highly optimized pixel setting function.

Parameters

x, y - Coordinates of pixel to set.

col - RGB color or color index to set pixel.

buffer - Optional. Can be one of BACKBUFFER (default), FRONTBUFFER or SPRITEBUFFER.

Return value

None

Remarks

This function REQUIRES a locked buffer to work with. WritePixelFast is a highly optimized hand coded machine language function will give the best performance in games when a large number of pixels need to be changed at once. Boundary checking is not done so you must be careful not to write outside of the confines of the buffer or your program will generate a fault.

See Also: WritePixel, WriteAlphaPixel

Example usage

LOCKBUFFER
    FOR y=0 to 599
        FOR x=0 to 799
            WritePixelFast(x,y,c)
        NEXT x
    NEXT y
UNLOCKBUFFER