GPR_$SET_BITMAP_DIMENSIONS GPR Calls GPR_$SET_BITMAP_DIMENSIONS
NAME
gpr_$set_bitmap_dimensions - modifies the size and the number of planes
of a bitmap.
FORMAT
gpr_$set_bitmap_dimensions (bitmap_desc, size, hi_plane_id, status)
DESCRIPTION
This routine modifies the size and the number of planes of a bitmap.
A program can use this call to change the size and number of planes of a
bitmap after the bitmap has been created. This is useful if the program
wishes to restrict itself to an upper-left subset of the original bitmap
or to use hidden memory on a borrowed display.
Input Parameters
bitmap_desc
The descriptor of the bitmap, in gpr_$bitmap_desc_t format. This is
a 4-byte integer.
size New width and height of the bitmap, in gpr_$offset_t format. This
data type is 4 bytes long.
hi_plane_id
The new identifier of the bitmap's highest plane, in gpr_$plane_t
format. This is a 2-byte integer.
Output Parameters
status
Completion status, in status_$t format.
NOTES
In direct mode when you allocate a bitmap, you request a size. You may
get a smaller size if the Display Manager window is smaller than the size
you requested. These restrictions apply to resizing bitmaps. Any bitmap
can be shrunk from its original dimensions in x, y or the highest plane.
Once the bitmap has been shrunk, it can grow up to its requested size.
The maximum allowed sizes for x, y and the highest plane for the various
Domain displays are given in the following table.
_________________________________________________
| Monochromatic Displays |
|________________________________________________|
|Screen Size | max X | max Y | max high_plane_id |
|____________|_______|_______|___________________|
| | | | |
|1024 x 800 | 1024 | 1024 | 0 |
|800 x 1024 | 1024 | 1024 | 0 |
|1280 x 1024 | 2048 | 1024 | 0 |
|____________|_______|_______|___________________|
_______________________________________________________________
| Color Displays - Interactive Format |
|______________________________________________________________|
| Device | max X | max Y | max high_plane_id |
|__________________________|_______|_______|___________________|
| | | | |
|4-plane DN550/560/600/660 | 1024 | 2048 | 3 |
|8-plane DN550/560/600/660 | 1024 | 2048 | 7 |
|4-plane DN3000 | 1024 | 1024 | 3 |
|8-plane DN3000/3550/4000 | 1024 | 1024 | 7 |
|DN10000E | 1024 | 1024 | 7 |
|DN570 | 1024 | 1024 | 7 |
|DN580 | 1504 | 1024 | 7 |
|DN590 | 1504 | 1024 | 23 |
|DN3500F/4000F/4500F | 1504 | 1025 | 7 |
|DN3500A/3550A/4500A | 1280 | 1024 | 7 |
|DN3550B/4500B | 1280 | 1024 | 39 |
|Series 10000VS | 1504 | 1024 | 39/79 |
|__________________________|_______|_______|___________________|
The system uses certain areas of hidden display memory to store fill con-
stants, fonts, and cursor patterns. Suppose you use
gpr_$set_bitmap_dimensions to expand the bitmap to include parts of hid-
den display memory. If you then write over parts of hidden display
memory, you run the risk of overwriting the fill constants, fonts, or
cursor patterns.