GPR_$ADDITIVE_BLT GPR Calls GPR_$ADDITIVE_BLT
NAME
gpr_$additive_blt - blts a plane of a bitmap to all active planes of the
current bitmap.
FORMAT
gpr_$additive_blt (source_bitmap_desc, source_window, source_plane,
dest_origin, status)
DESCRIPTION
This routine transfers a single plane of any bitmap to all active planes
of the current bitmap. Both the source and destination bitmaps can be in
either display memory or main memory.
The source window origin is added to the coordinate origin for the source
bitmap, and the result is the actual origin of the source rectangle for
the BLT. Similarly, the destination origin is added to the coordinate
origin for the current bitmap, and the result is the actual origin of the
destination rectangle for the BLT.
Input Parameters
source_bitmap_desc
Descriptor of the source bitmap containing the source window to be
transferred, in gpr_$bitmap_desc_t format. This is a 4-byte
integer.
source_window
Rectangular section of the bitmap from which to transfer pixels, in
gpr_$window_t format. This data type is 8 bytes long.
source_plane
The identifier of the source plane to add, in gpr_$plane_t format.
This is a 2-byte integer. Valid values are in the range 0 through
hi_plane (where hi_plane is a parameter of gpr_$init).
dest_origin
Start position (top left coordinate position) of the destination
rectangle, in gpr_$position_t format. This data type is 4 bytes
long. Coordinate values must be within the limits of the current
bitmap, unless clipping is enabled.
Output Parameters
status
Completion status, in status_$t format.
NOTES
If the source bitmap is a Display Manager frame, the only allowed raster
op codes are 0, 5, A, and F. These are the raster operations in which
the source plays no role.
If a rectangle is transferred by a BLT to a display manager frame and the
frame is refreshed for any reason, the BLT is re-executed. Therefore, if
the information in the source bitmap has changed, the appearance of the
frame changes accordingly.