[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPTWPO - Two Operand Pixel Operation

GPTWPO (tibid, torigin, size, sibid, sorigin, op, opparm)

Purpose

Use GPTWPO to transfer pixel data from an image board to another image board through a pixel by pixel operation. The operation performed to the pixel data is specified by an operation type and accompanied operation dependent parameters.

Both source and target image boards must reside on the same nucleus. The specified target rectangle need not be inside of the target image board; however, the specified source rectangle must be inside of the source image board. When the target rectangle exceeds the target image board boundaries, pixel data outside the boundaries is discarded. If source and target storage have different bit depth, source pixels are adjusted to the target bit length by removing most significant bits or adding 0-bit to the most significant part.

Parameters

tibid -- specified by user, fullword integer

Target image board identifier

torigin -- specified by user, two fullword integers

Target rectangle origin (x, y) (>=0)

size -- specified by user, two fullword integers

Rectangle size (SX, SY) (>=1)

sibid -- specified by user, fullword integer

Source image board identifier

sorigin -- specified by user, two fullword integers

Source rectangle origin (x, y) (>=0)

op -- specified by user, fullword integer

Operation type (1=REFLECTION )

opparm -- specified by user, array of fullword quantities

Operation dependent parameters

The following operation is defined and requires operation dependent parameters.

1 (REFLECTION )

Pixels in the source rectangle are placed into the target rectangle in the reverse order. This operation requires a fullword integer specifying an axis about which the pixels are reflected as follows:

  • 1: reflect about x-axis (reverse y-direction)

  • 2: reflect about y-axis (reverse x-direction)

    • Error Codes

    215
    SPECIFIED RESOURCES DO NOT EXIST ON THE SAME NUCLEUS
    232
    SPECIFIED IMAGE BOARD DOES NOT EXIST
    236
    RECTANGLE DEFINITION IS INVALID
    238
    SPECIFIED TWO OPERAND OPERATION IS NOT SUPPORTED

    Related Subroutines

    None

    RCP code

    201346314 (X'0C004D0A')

    [ Previous | Next | Contents | Glossary | Home | Search ]