components for displaying,editing, and interacting with graphical data
GDM.Uviewer, GDM.Uviewer2D, GDM.Uviewer3D
Output Ports
The Uviewer components define all of the necessary components for the display portion of a graphics application. This consists of a default graphics window that displays the default list of objects (defined by the Scene.Top.child_objs input port) and a collection of user interface editors that the user can use to control the display of these objects.
An application should only have a single Uviewer but you can add additional graphics windows to the Uviewer either using the view editor panel found in the Editors->View->Create page or by directly adding Uscene and Uview objects to the Uviewer using the Network Editor.
Each Uviewer contains a Scene, a Scene_Selector, and a Scene_Editor. The Scene defines a top-level object (Top), a Camera that defines a viewport onto those objects, and a View window to display those objects in (see Uscene for more information). The Scene_Selector allows the user to select a current Scene for editing purposes (see GDview_selector for more information). The Scene_Editor defines the interactors that allow mouse interaction with the object, toolbar icons such as reset, normalize and center, and a set of editor panels that are installed into the Editors menu panel of an application (see Uscene_editor for more information)
The Uviewer modules only differ in the type of Scene that they define. The Uviewer2D component uses a Uscene2D, the Uviewer3D uses a Uscene3D and the Uviewer uses a Uscene. The Uscene2D is like a Uscene3D but has the camera type set to 2D and may have a different default renderer. The Uscene2D and Uscene3D have a single Top object and a single Camera. The Uscene displays 2D and 3D objects in the same window. It has two Top objects: Top for 3D objects and Top2D for 2D objects and two Cameras, Camera for 3D objects and Camera2D for 2D objects.
Uviewer // - scene and scene editing
Scene // - collection of components for a window
Top // - object's display parent
Top2D // - (Uviewer only) 2D objs display parent
Lights // - light information for window
Camera // - camera information for window
Camera2D // - (Uviewer only) 2D camera for window
View // - View, colormap, picking, output and
// window display for view
Scene_Selector // - Selects the current view
input_views // - List of input views
current_view // - Currently selected view
Scene_Editor // - collection of editors
in_view // - currently edited view
View_Editor // - editor for view attributes
Track_Editor // - defines mouse transformation behavior
Light_Editor // - editor for light attributes
Camera_Editor // - editor for camera attributes
Object_Editor // - editor for object attributes
Graph_Editor // - editor for graphing attributes
One or more objects to be rendered. For Uviewer and Uviewer3D, these objects are renderered in 3D. For Uviewer2D these objects are rendered in 2D.
Scene.Top2D.child_objs (Uviewer only)
One or more objects to be rendered in 2D. These objects are rendered on top of the 3D objects connected to Scene.Top.child_objs
Outputs a connection to the currently selected view. This will change as you click in each view window to point to the selected view. If you want to connect to a particular view, export a port for the object: Uviewer.Scene.View.View and connect to that.
Scene_Editors.View_Editor.GDobj_sel.cur_obj
This is a connection to the current object. This is the object that the object editors are using. In the default configuration, this is the same as the picked_obj below.
This is a connection to the object most recently selected by the user through the pick operation. This operation is initiated in the Uviewer component with the <ctrl>-left mouse button.