image functions
XgrCopyImage ( grid, imageGrid )
XgrDrawImage ( grid, imageGrid, startX, startY, endX, endY, dx, dy )
XgrDrawImageExtend ( grid, imageGrid, startX, startY, endX, endY, dx, dy )
XgrDrawImageExtendScaled ( grid, imageGrid, startX, startY, endX, endY, dx, dy )
XgrDrawImageScaled ( grid, imageGrid, startX, startY, endX, endY, dx, dy )
XgrGetImage ( grid, @image[] )
XgrGetImageArrayInfo (@image[], @bitsPerPixel, @width, @height )
XgrLoadImage ( fileName$, @image[] )
XgrRefreshGrid ( grid )
XgrSaveImage ( fileName$, @image[] )
XgrSetImage ( grid, @image[] )

XgrCopyImage  ( grid, imageGrid )

XgrCopyImage() transfers the image in imageGrid into a displayable grid, starting with the upper-left corner of grid and imageGrid . The contents of imageGrid is not altered. Drawing outside grid is not performed, which clips imageGrid if it is larger than grid.

XgrCopyImage() is a relatively fast operation.

XgrDrawImage  ( grid, imageGrid, startX, startY, endX, endY, dx, dy )

XgrDrawImage() draws imageGrid in grid at dx, dy.

(startX,startY:endX,endY) are pixel offsets into the image. The left and/or upper portion of an image is skipped if startX and/or startY is non-zero. The right and/or lower portion of an image is not drawn if endX and/or endY is reached before the image data is exhausted.  If endX and/or endY is zero, endX and/or endY are set to the x and/or y limits of the image.

Drawing is not performed outside the grid-box.

XgrDrawImage() is a relatively fast operation.