Function Entry: VPORTS

← Prev | ↑ Chapter | Next → | Index | Symbols

Function Entry: VPORTS

Name

vports

Class

Function

Syntax

(vports)

Arguments and Values

None.

Description

Returns a list of viewport descriptors for the current viewport configuration. The shape of the result depends on the TILEMODE system variable: tiled viewports (VPORTS command) when TILEMODE is 1, floating viewports (MVIEW command) when TILEMODE is 0. When TILEMODE is off, viewport number 1 is always paper space.

Return Values

A list of viewport descriptors. Each descriptor is (viewport-id (lower-left) (upper-right)). With TILEMODE on, the corners are values in [0.0, 1.0] relative to the display screen. With TILEMODE off, the corners use paper-space coordinates. The current viewport's descriptor is always first in the list.

Side Effects

None.

Examples

  • A single viewport with TILEMODE on: ((1 (0.0 0.0) (1.0 1.0))).

  • Four equal tiled viewports: 

    ((5 (0.5 0.0) (1.0 0.5))
 (2 (0.5 0.5) (1.0 1.0))
 (3 (0.0 0.5) (0.5 1.0))
 (4 (0.0 0.0) (0.5 0.5)))

Availability

  • AutoCAD 2026: documented.
  • BricsCAD V26: presumed compatible.
  • Status: AutoCAD documented; BricsCAD presumed-both pending Phase 4 verification.