GPR_$SET_RASTER_OP                GPR Calls                 GPR_$SET_RASTER_OP


NAME
     gpr_$set_raster_op - specifies a raster operation.

FORMAT
     gpr_$set_raster_op (plane_id, raster_op, status)

DESCRIPTION
     This routine specifies a raster operation for the primitives established
     with gpr_$raster_op_prim_set.

     Use gpr_$inq_raster_ops to retrieve the current raster operation for the
     primitives which are specified by gpr_$raster_op_prim_set.

   Input Parameters
     plane_id
          Identifier of the bitmap plane involved in the raster operation, in
          gpr_$plane_t format.  This is a 2-byte integer.  Valid values are
          zero through the identifier of the bitmap's highest plane.

     raster_op
          Raster operation code, in gpr_$raster_op_t format.  This is a 2-byte
          integer.  Possible values are zero through fifteen.

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

SEE ALSO
     gpr_$raster_op_prim_set, gpr_$set_raster_op_mask.

NOTES
     This call has been replaced by gpr_$set_raster_op_mask.

     The default raster operation for all primitives is 3.

     The following is a list of the op codes and logical functions of the six-
     teen raster operations and a truth table of the raster operations.

     Op Code   Logical Function

     0         Assign zero to all new destination values.
     1         Assign source AND destination to new destination.
     2         Assign source AND complement of destination to new destination.
     3         Assign all source values to new destination.
     4         Assign complement of source AND destination to new destination.
     5         Assign all destination values to new destination.
     6         Assign source EXCLUSIVE OR destination to new destination.
     7         Assign source OR destination to new destination.
     8         Assign complement of source AND complement of destination to
               new destination.
     9         Assign source EQUIVALENCE destination to new destination.
     10        Assign complement of destination to new destination.
     11        Assign source OR complement of destination to new destination.
     12        Assign complement of source to new destination.
     13        Assign complement of source OR destination to new destination.
     14        Assign complement of source OR complement of destination to
               new destination.
     15        Assign 1 to all new destination values.

      ____________________________________________________________________
     |                    |                                               |
     | SOURCE DESTINATION | RESULTANT BIT VALUES FOR THE FOLLOWING OP CODES:
     | BIT    BIT         |                                               |
     | VALUE  VALUE       | 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15         |
     |____________________|_______________________________________________|
     |                    |                                               |
     |   0     0          | 0 0 0 0 0 0 0 0 1 1  1  1  1  1  1  1         |
     |   0     1          | 0 0 0 0 1 1 1 1 0 0  0  0  1  1  1  1         |
     |   1     0          | 0 0 1 1 0 0 1 1 0 0  1  1  0  0  1  1         |
     |   1     1          | 0 1 0 1 0 1 0 1 0 1  0  1  0  1  0  1         |
     |____________________|_______________________________________________|