push_vdc_matrix(3G)

NAME

push_vdc_matrix − push vdc-to-device units transformation matrix onto top of matrix stack.

SYNOPSIS

C Syntax:

void push_vdc_matrix(fildes);
int fildes;

FORTRAN77 Syntax:

subroutine push_vdc_matrix(fildes)
integer*4 fildes

Pascal Syntax:

procedure push_vdc_matrix(fildes:integer);

DESCRIPTION

Input Parameters

fildes Integer file descriptor returned by gopen when an I/O path to a graphics device is opened.

Discussion

A copy of the current vdc-to-device units transformation matrix is pushed onto the top of the matrix stack and becomes the current transformation matrix. If vdc_extent, set_p1_p2, mapping_mode, or vdc_justification changes, the internal Starbase vdc-to-device units transformation matrix changes, but not any vdc matrices that were pushed using push_vdc_matrix.

This routine should be used carefully (especially when a device has been opened in MODEL_XFORM mode), because only modelling matrices are normally pushed on the matrix stack. If the vdc-to-device matrix is pushed on the stack in MODEL_XFORM mode, lighting calculations for subsequent output primitives may be invalid. For lighting calculations in vdc coordinates, use flush_matrices.

Museum

Related Articles