image functions - continued

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

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

(startX,startY:endX,endY) are pixel offsets into the image.  The left and/or upper portions of an image is skipped if startX and/or startY is non-zero.  If endX is reached, or imageGrid is exhausted before the grid-box x limit is reached, the final pixel is repeated to the grid-box x limit.  If endY is reached, or imageGrid is exhausted before the grid-box y limit is reached, the final row of pixels is repeated to the grid-box y limit.  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.

XgrDrawImageExtend() is a relatively fast operation.

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

XgrDrawImageExtendScaled() 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.  If endX is reached, or imageGrid is exhausted before the grid-box x limit is reached, the final pixel is repeated to the grid-box x limit.  If endY is reached, or imageGrid is exhausted before the grid-box y limit is reached, the final row of pixels is repeated to the grid-box y limit.  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.

XgrDrawImageExtendScaled() interprets image data as scaled coordinates, therefore it will zoom (enlarge and compress) images of drawings, icons, and video images.

XgrDrawImageExtendScaled() is a slow operation.