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

GPVMP2 - Set View Mapping 2

GPVMP2 (wsid, view, window, viewpt)

Purpose

Use GPVMP2 to set the requested window and viewport values (forx and y) to the specified values for the given view.

Other viewing parameters are automatically set with the GPVMP2 subroutine and are calculated as follows:

  • The z extents for the viewport are set to the z extents of the NPC range.

  • The projection type is set to parallel.

  • The projection reference point is placed on a line perpendicular to the center of the specified window. The z value of the projection reference point is set to one half of the maximum of the Umax-Umin and Vmax-Vmin.

  • The view plane distance is set to zero.

  • The far clipping plane is set to the negative of one-half the maximum of Umax-Umin and Vmax-Vmin.

  • The near clipping plane is set to one-half of the maximum of Umax-Umin and Vmax-Vmin.

    • All current view mapping values are set to the requested values when the workstation is updated.

    Parameters

    wsid -- specified by user, fullword integer

    Workstation identifier.

    view -- specified by user, fullword integer

    Index of view table entry to be modified (>=1)

    window -- specified by user, 4 short floating-point numbers (VC)

    Window limits (Umin, Umax, Vmin, Vmax)

    viewpt -- specified by user, 4 short floating-point numbers (NPC)

    Viewport limits (Xmin, Xmax, Ymin, Ymax)

    Error Codes

    25
    SPECIFIED WORKSTATION DOES NOT EXIST
    44
    INVALID WINDOW DEFINITION
    59
    VIEW INDEX VALUE < ZERO
    323
    VIEW INDEX EXCEEDS VIEW TABLE CAPACITY
    330
    INVALID VIEWPORT
    518
    VIEW ZERO CANNOT BE MODIFIED

    Related Subroutines

    GPXVR
    Set Extended View Representation

    RCP code

    201330178 (X'0C000E02')

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