GPR_$SET_RASTER_OP_MASK           GPR Calls            GPR_$SET_RASTER_OP_MASK


NAME
     gpr_$set_raster_op_mask - sets raster operations on several planes.

FORMAT
     gpr_$set_raster_op_mask (pl_mask, rop, status)

DESCRIPTION
     This routine sets raster operations on several planes.

     The raster operations established with this call affect only the primi-
     tives currently specified with gpr_$raster_op_prim_set.

   Input Parameters
     pl_mask
          Establishes the plane mask, in gpr_$mask_32 format.  This is a set
          with up to 32 elements.  It is a 4-byte integer.

     rop  Establishes the raster operation, 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 gpr_$inq_raster_ops.

NOTES
     Refer to the Usage section under gpr_$inq_raster_ops for further informa-
     tion.

     This call replaces gpr_$set_raster_op, which could only set raster opera-
     tions on only one plane at a time.

     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         |
     |____________________|_______________________________________________|