Modify Size or Position of a Viewport

This Subprogram modifies the Size or Position of the specified Viewport.

Short Name Calling Sequence

STATUS = UIMOVP(VPRTID,XLOW,XHIGH,YLOW,YHIGH)

Long Name Calling Sequence

STATUS = UI_MODIFY_VIEWPORT(...)

Input Arguments

VPRTID (Integer) Viewport ID XLOW (Real) Viewport Low X XHIGH (Real) Viewport High X YLOW (Real) Viewport Low Y YHIGH (Real) Viewport High Y

Output Arguments

None

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_VIEWPORT ) Illegal Viewport ID UIILVP )

UI__ILLEGAL_LIMITS ) Illegal Viewport Limits UIILLI )

Note:

1. The specified Viewport must have been previously defined via a call to UI_DEFINE_VIEWPORT.
2. Whether the Text or Graphics Viewport corresponding to the specified Viewport ID is modified depends on the currently setup Viewport Mode.
3. Viewport Coordinates should be specified in the appropriate units (Rows and Columns or Graphics Units).
4. This Subprogram does not affect the definition of the currently setup Viewport which remains as defined by the last call to UI_DEFINE_VIEWPORT or IU_USE_VIEWPORT.
5. The Viewport Mode is defaulted to Text on initialisation of UIPACK. It may be changed by calling UI_VIEWPORT_MODE and may be determined by calling UI_INQUIRE_VIEWPORT_MODE.
6. Error UI__ILLEGAL_LIMITS will be reported if the Viewport Limits are unphysical (XLOW greater than XHIGH etc.)