Uview, Mview

Synopsis

Define a 2D or 3D graphics window

V name

GDM.Uview, GDM.Mview

Input Ports

View.cameras

GDcamera_templ

View.light_info

GDlight_info

Output Ports

View

GDview_templ

View.picked_obj

GDobject_templ

Field_Output.buffers

GDview_buffers

Description

Uview and Mview define the information necessary to create a graphics window. Its contents are defined by the list of input cameras. Light information is required for 3D views. The Uview object contains its own user interface defined using the AVS/Express UI kit. The Mview object requires that the application provide a window parent for the window using a user interface implementation supplied by the user.

Uview and Mview contain:

PickCtrl - defines pick behavior

FieldOutput - defines output information and behavior

VirtPal - virtual palatte for display color mapping

View - view attributes and information

ViewUI - viewer window user interface and interaction user interface (Uview only)

View's parent window

The Uview object contains a ViewUI macro which contains the components that implement the user interface for the view. The parent window in this ViewUI macro is called ViewPanel.UI.panel. When this panel is instanced in an application, it walks up the object hierarchy looking for an appropriate panel in the user interface to attach itself to. If dropped into a SingleWindowApp, the Uview's panel will connect itself to SingleWindowApp.UI.Windows.IUI.panel. You can change this connection manually by changing the Uview's subobject ViewUI.ViewPanel.UI.panel.parent_ref to point to the parent window of your choice.


View
PickCtrl // - picking behavior
VirtPal // - virtual palette information
FieldOutput // - output buffer and z-buffer info
View // - view attributes
ViewUI // - (Uview only) window user interface
ViewPanel // - AUpanel contains ViewFrame
ViewFrame // - UIframe displays window border
ViewWindow // - UIrenderView contains view window
ViewEvents // - UImouseEvents mouse interaction
PickInteractor // - UIonePoint picking mouse interaction

Input Ports

View.cameras

List of cameras. Each camera defines the viewport and contains a list of objects (either 2D or 3D) to be displayed in the scene.

View.light_info

Connection to a GDlight_info struct containing the light information for the scene. This information is not required for 2D cameras

Output Port

View.Field_Output.buffers

Output framebuffer and Z buffer information. For more information about framebuffer/Z-buffer I/O, see GDview_buffers .

View.View

The view and all view attributes. This contains the UIrender_view object for the view and UI interactors for retrieving mouse events.

View.picked_obj

The view's picked object.

Example

see the implementation of Uscene

File

v/gdm.v

See also related modules

Uscene (Uscene, Uscene2D, Uscene3D, Mscene, Mscene2D, Mscene3D )