Syntax
[C/C++:]
void gDrawCellArray(float x1, float y1, float x2, float y2, int npixx, int npixy, int isx, int isy, int idx, int idy, int pixbuf[]);
[F90:]
subroutine gDrawCellArray(x1, y1, x2, y2, npixx, npixy, isx, isy, idx, idy, pixbuf)
real, intent(in) :: x1,y1,x2,y2
integer, intent(in) :: npixx,npixy,isx,isy,idx,idy,pixbuf(*)
Arguments
x1,y1
Bottom-left corner of image in current units
x2,y2
Top-right corner of image in current units
npixx,npixy
Dimension of image data array
isx,isy
The start X position and Y position of a sub-array
idx,idy
The X and Y dimensions of a sub-array
pixbuf
The array containing image colour information
Description
The routine gDrawCellArray() draws a scaled image to fit the transformed corner points which are specified in current drawing units. The final image is drawn in a rectangle with edges parallel to the drawing area as represented by the transformed points.
Image data is passed through a pointer to an integer array
pixbuf dimensioned (
npixx,
npixy). Where the whole of this array is to be displayed, the user should set
isx and
isy to 1 and
idx and
idy to be the same as
npixx and
npixy. Alternatively a portion of the array can be displayed (still at the anchor position
ix,
iy) by setting the values of
isx and
isy to the offsets from the start of the
pixbuf and
idx,
idy to the dimensions of the sub-array.
The image data may consist of packed or unpacked colour indices or in the case of true colour devices, 24bit true colour RGB values.
See Also
gDrawCellArray UsagegDefinePixelPackinggSetColourInfo
