gpr_set_imaging_format() — Apollo Domain/OS SR10.4.1

GPR_$SET_IMAGING_FORMAT           GPR Calls            GPR_$SET_IMAGING_FORMAT


NAME
     gpr_$set_imaging_format - sets the imaging format of the color display.

FORMAT
     gpr_$set_imaging_format (format, status)

DESCRIPTION
     This routine sets the imaging format of the color display.

     Imaging formats support only limited GPR operations - displaying pixel
     data and changing the color map.  Other functions return error messages.

   Input Parameters
     format
          Color format in gpr_$imaging_format_t.  This is a two-byte integer.
          Not all of the possible values for gpr_$imaging_format_t can be used
          in this call.  Valid values for this call are:

          gpr_$interactive
               either two- or three-board

          gpr_$imaging_1024x1024x8
               two-board only

          gpr_$imaging_512x512x24
               three-board only

   Output Parameters
     status
          Completion status, in status_$t format.

SEE ALSO
     gpr_$inq_imaging_format.

NOTES
     To use gpr_$set_imaging_format, you must be in borrow display mode and be
     using a color node.

     1024x1024x8 imaging format is not supported on a three-board system
     because it offers no advantages over interactive formats.

     The only models that accept the gpr_$imaging formats are the DN550,
     DN560, DN600, and DN660.  It is unlikely that future models of Apollo
     nodes will support these imaging formats.
Museum
