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

GPTRCT - Transfer Rectangle

GPTRCT (tibid, torigin, size, sibid, sorigin)

Purpose

Use GPTRCT to transfer pixel data from an image board to another image board. 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)

Error Codes

215
SPECIFIED RESOURCES DO NOT EXIST ON THE SAME NUCLEUS
232
SPECIFIED IMAGE BOARD DOES NOT EXIST
236
RECTANGLE DEFINITION IS INVALID

Related Subroutines

None

RCP code

20134613 (X'0C004D09')


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