The Viewport Editor

The viewport object is used to position plots on the page. There is no limit to the number of viewports that can be created on the page.

The resources of the viewport object are grouped into three bundles - core, ratios and 3D workbox.

See the viewport object for a full description of the viewport's resources.

The Core Bundle

Priority

By default viewports have a priority of 0 and are rendered in the order they were created. If the priority is modified then viewports are rendered in the order specified by the priority beginning with the lowest number. The priority can be any integer from -127 to 128.

1st Diagonal Point and 2nd Diagonal Point

The location of the viewport in relation to the page. By default the position is specified in percentages of the page width and height.

Background Color

The background color of the viewport. Default: None

Frame Width

The width of viewport frame. Default: 0.0

Frame Color

The color of viewport frame. Default:black.

The Ratios Bundle

X Ratio, Y Ratio and Z Ratio

These resources are used to control the size of each side of the viewport in relation to the other sides.

  • The Z ratio is only used for 3D plots

  • If you have a 2D contour map of the UK with x ranging from -8 to 2 and y ranging from 49 to 61. Then you would make sure that 1 unit of x is equal to 1 unit of y by setting Y ratio to be 61-49=12 and X ratio to be 2-(-8)=10.

The 3D Workbox Bundle

This bundle is only used if the viewport contains a 3D plot or a 2D plot projected on a plane.

Projection Type

There are two methods for plotting a 3D workbox - "perspective" (default) and "oblique". With perspective the 3D workbox is viewed as from a point in space. With oblique the workbox  has no perspective - used by waterfall plots.

Angle in XY Plane, Tilt Angle and Elevation Plane

The viewing angle of a 3D workbox when drawn in perspective.

  • The angle in the XY plane is the angle the workbox has been rotated about the Z axis.

  • The elevation plane is the the viewing angle above the XY plane.

  • The tilt angle is the amount the viewport has been rotated about a line joining the viewing point to the centre of the viewport.

Focus Height and Distance Factor

 

Oblique Angle and Relative Depth

Used to control the oblique projection.

 

Return to Gsharp Reference Manual.