GPR_$ALLOCATE_BITMAP_NC           GPR Calls            GPR_$ALLOCATE_BITMAP_NC


NAME
     gpr_$allocate_bitmap_nc - allocates a bitmap in main memory without
     clearing the pixels.

FORMAT
     gpr_$allocate_bitmap_nc (size, hi_plane_id, attrib_block_desc,
                              bitmap_desc, status)

DESCRIPTION
     This routine allocates a bitmap in main memory without setting all the
     pixels in the bitmap to zero, and returns a bitmap descriptor.
     gpr_$allocate_bitmap sets all pixels in the bitmap to zero; this routine
     does not.  As a result, gpr_$allocate_bitmap_nc executes faster, but the
     initial contents of the bitmap are unpredictable.

   Input Parameters
     size Bitmap width and height, in gpr_$offset_t format.  This data type is
          4 bytes long.  The maximum size for a main-memory bitmap is 8192 x
          8192.

     hi_plane_id
          Identifier of the highest plane which the bitmap will use, in
          gpr_$rgb_plane_t format.  This is a 2-byte integer.  Valid values
          are 0 - 31.

     attrib_block_desc
          Descriptor of the attribute block which the bitmap will use, in
          gpr_$attribute_desc_t format.  This is a 4-byte integer.

   Output Parameters
     bitmap_desc
          Descriptor of the allocated bitmap, in gpr_$bitmap_desc_t format.
          This is a 4-byte integer.

     status
          Completion status, in status_$t format.

SEE ALSO
     gpr_$set_bitmap, gpr_$deallocate_bitmap.

NOTES
     Use gpr_$set_bitmap to establish an allocated bitmap as the current bit-
     map.

     Use gpr_$deallocate_bitmap to deallocate a bitmap.  A program cannot use
     a bitmap after it is deallocated.