Previous Next Up Title Contents Index Functions Index Top Library

COPY TARGET REGION

PXCOPY_TARGET_REGION


CALL SEQUENCE

void pxcopy_target_region(
)

TYPES

typedef struct {
	Pxregion_type	region_type;	/* type of region	*/
	union {
		Pint		view_id;	/* view identifier	*/
		Plimit	rect;	/* window limit (NPC or DC)	*/
	} region;
} Pxregion_src;

typedef struct {
	Pxregion_type	region_type;	/* type of region	*/
	union {
		Pint		view_id;	/* view identifier	*/
		Ppoint	point;	/* lower left point destination (NPC or DC)	*/
	} region;
} Pxregion_dst;

PHIGS STATE

(PHOP,WSOP,*,*)

EFFECT

The region defined by src_region from the specified source target src_target is copied to the specified destination target dst_target at the dst_region position. The content of the source target is not altered.

A source region can be defined by giving a view index, or a rectangle in NPC or DC.

If a view index is given, the rectangle used is the viewport limit of the view.

If the destination target is the display target, visual effect is immediate. The display surface is set to the source target.

ERRORS

3
Ignoring function, function requires state (PHOP, WSOP,*,*)
115
Ignoring function, the specified view index is less than one
150
Ignoring function, setting this view table entry would exceed the maximum number of entries allowed in the workstation view table.
3001
Ignoring function, the first target does not exist
3002
Ignoring function, the second target does not exist

SEE ALSO

Set rendering target, see pxset_rendering_target

Set display target, see pxset_display_target

Clear target, see pxclear_target

Swap targets, see pxswap_targets

Save target region, see pxsave_target_region

Restore target region, see pxrestore_target_region


Previous Next Up Title Contents Index Functions Index Top Library