Assign Viewport ID

This Subprogram may be used to assign or allocate a free Viewport ID. This assignment will be unique within a particular program such that programmers each coding a program module to be later blended together may ensure that they avoid clashes with conflicting Viewports etc.

Short Name Calling Sequence

STATUS = UIASVP(VPRTID,NVPRTS)

Long Name Calling Sequence

STATUS = UI_ASSIGN_VIEWPORT(...)

Input Arguments

NVPRTS (Integer) No. of IDs to assign

Output Arguments

VPRTID (Integer) Viewport ID

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__NO_FREE_VIEWPORTS ) No Free Viewports UINOVP ) available

Note:

1. Viewport IDs lie in the range 0-255, where several are already assigned by UIPACK.
2. The NVPRTS Argument is optional and, if omitted, defaults to 1.