rectwr(3G)rectwr(3G)NAME
rectwr, lrectw - draws a rectangular array of pixels into the frame
buffer
FORTRAN 77 SPECIFICATION
subroutine rectwr(x1, y1, x2, y2, parray)
integer*4 x1, y1, x2, y2
integer*2 parray(*)
subroutine lrectw(x1, y1, x2, y2, parray)
integer*4 x1, y1, x2, y2
integer*4 parray(*)
PARAMETERS
x1 expects the lower-left x coordinate of the rectangular region.
y1 expects the lower-left y coordinate of the rectangular region.
x2 expects the upper-right x coordinate of the rectangular region.
y2 expects the upper-right y coordinate of the rectangular region.
parray expects the array which contains the values of the pixels to be
drawn. For RGBA values, pack the bits thusly: $AABBGGRR,
where:
AA contains the alpha value,
BB contains the blue value,
GG contains the green value, and
RR contains the red value.
RGBA component values range from 0 to $FF (255). The alpha
value will be ignored if blending is not active and the machine
has no alpha bitplanes.
DESCRIPTIONrectwr and lrectw draw pixels taken from the array parray into the
specified rectangular frame buffer region. The system usually draws
pixels left-to-right, then bottom-to-top. All coordinates are relative to
the lower-left corner of the window, not the screen or viewport.
Pixels are written to the currently active framebuffer, as specified by
drawmo. Thus, to write pixel values to the overlay bitplanes, for
example, simply set drawmo to OVERDR.
The number of pixels in parray is always (x2-x1+1) * (y2-y1+1). If the
zoom factors set by rectzo are both 1.0, the screen region x1 through x2,
y1 through y2, are filled. Other zoom factors result in filling past x2
and/or past y2 (x1,y1 is always the lower-left corner of the filled
region).
Page 1
rectwr(3G)rectwr(3G)rectwr draws an array of 16-bit words, and therefore should be used only
to write color index values. lrectw draws an array of 32-bit words.
Based on the current pixmod, lrectw can draw pixels of 1, 2, 4, 8, 12,
16, 24, or 32 bits each. Use it to write packed RGB or RGBA values,
color index values, or z values.
pixmod affects the operation of lrectw substantialy, and has no effect on
the operation of rectwr. By default, lrectw draws 32-bit pixels in the
format used by cpack. Different pixel sizes, framebuffer shifts, scan
patterns through the framebuffer, and strides through memory, can all be
specified using pixmod.
rectwr and lrectw leave the current character position unpredictable.
SEE ALSO
blendf, dither, lrectr, pixmod, rectco, rectzo
NOTES
These routines are available only in immediate mode.
On IRIS Indigo, Indy, and XL graphics the pixels written by rectwr and
lrectw will be dithered if dithering is enabled. To write undithered
pixels the dither command must be used to turn dithering off. On the
Indigo, if dithering is on, pixel images written, then read and written
again will cause successive dithering to be done each time the pixels are
written. On Indy and XL graphics, successive dithering will not occur.
On Indigo Entry graphics, when in color index mode with double-buffering
enabled, 8-bit values are clamped to 4 bits, rather than being masked.
BUGS
IRIS-4D Personal Iris requires that both |x2-x1| and |y2-y1| be less than
2048.
IRIS-4D VGX and VGXT require that both |x2-x1+1| and |y2-y1+1| be less
than 2048.
The size of the array passed to rectwr is limited to the size of the
screen.
Page 2
