MoveImage

Transfers data within the frame buffer

int MoveImage (
        RECT *recp,
        int x,
        int y
)

Arguments

recp Pointer to source rectangle in the frame buffer
x, y Pointer to upper left-hand corner of the destination rectangle in the frame buffer

Return Value

The slot number of the GPU’s draw/command queue where the command resides is returned.

Explanation

The rectangular area in the frame buffer specified by recp is transferred to a rectangular area of the same size starting at location x,y in the frame buffer.

Notes

MoveImage() is a non-blocking function, therefore DrawSync() must be used to determine the completion of transfer. The transfer is not affected by clipping or offsetting that may be in effect for the drawing environment. The transfer area must be located within a drawable area: (0,0) - (1023,511). The contents of the source are unaffected by the transfer. If the source and destination areas are the same, the results are unpredictable.