GDmodes_edit
Synopsis
define an editor for the Graphics Display Kit modes
GDmodes_edit_notify_templ
group _GDmodes_edit_notify_templ
{
enum _points { choices = {"Inherit", "None", "Pixel", "Line Directed",
"Arrow Directed", "Cone Directed", "Cross Tangent"}; };
enum _lines { choices = {"Inherit", "None", "Regular", "Tube", "Arrow",
"Ribbon"}; };
enum _surf { choices = {"Inherit", "None", "No Lighting", "Flat", "Gouraud",
"Background"}; };
enum _volume { choices = {"Inherit", "None", "BTF Texture", "Ray Tracer"}; };
enum _bounds { choices = {"Inherit", "None", "Bounds"}; };
enum _normals { choices = {"Inherit", "None", "Vertex"}; };
int _colors;
};
GDmodes_edit_templ
GDmodes_edit_notify_templ _GDmodes_edit_templ
int+IPort2 _shell_vis;
int reset;
GDmodes_templ+IPort2 &modes;
method+notify_inst+notify_val upd_func = "GDmodes_edit_update";
};
GDmodes_edit
GDmodes_edit_templ GDmodes_edit;
Description
These templates define an editor for the Graphics Display Kit light modes. GDmodes_edit_notify_templ and GDmodes_edit_templ define the elements that cause the modes editor's method to execute. GDmodes_edit is the version you instance.
As an alternative to using GDmodes_edit and having to define your own user interface for the editor, you can use ModesEditor, an application component. ModesEditor contains GDmodes_edit and defines a user interface.
Input
shell_vis
The parameter controls whether the editor is active: 0 means inactive; 1 means active.
shell_vis is only checked modes (see below) has changed. In this case, if shell_vis is not set to 1, the editor does not update. This inhibits updates to the editor's other subobjects -- which are normally attached to UI widgets -- when the user interface is not visible. The editor always executes when the values of the other parameters change. This means modes is always updated even if the user interface is not visible.
Typically you connect shell_vis to the same UIcmd object that the user selects to display the editor's user interface:
modes
The modes object controlled by the modes editor. modes is a connection to an object that matches type GDmodes_templ.
Parameters
points
This parameter controls how points are rendered:
Value
|
Meaning
|
Symbolic constant
|
0
|
Inherit the parent object's mode
|
GD_POINTS_INHERIT
|
1
|
Do not render points
|
GD_NO_POINTS
|
2
|
Render points
|
GD_POINTS
|
3
|
Render lines in direction of the normal vector
|
GD_POINTS_DIRECTED
|
lines
This paremeter controls how lines are rendered:
Value
|
Meaning
|
Symbolic constant
|
0
|
Inherit the parent object's mode
|
GD_LINES_INHERIT
|
1
|
Do not render lines
|
GD_NO_LINES
|
2
|
Render lines
|
GD_LINES
|
surf
This parameter controls how surfaces are rendered:
Value
|
Meaning
|
Symbolic constant
|
0
|
Inherit the parent object's mode
|
GD_SURF_INHERIT
|
1
|
Do not render surfaces
|
GD_NO_SURF
|
2
|
Render using no lighting
|
GD_SURF_NOLIGHT
|
3
|
Render using flat shading
|
GD_SURF_FLAT
|
4
|
Render using Gouraud shading
|
GD_SURF_GOURAUD
|
5
|
Render using the background color (thus hiding the surface and items behind it)
|
GD_SURF_BACKGROUND
|
volume
This parameter controls how volumes are rendered:
Value
|
Meaning
|
Symbolic constant
|
0
|
Inherit the parent object's mode
|
GD_VOLUME_INHERIT
|
1
|
Do not render volumes
|
GD_NO_VOLUME
|
2
|
Render using the back-to-front method
|
GD_VOLUME_BTF
|
3
|
Render using a ray tracing method
|
GD_VOLUME_RAY
|
bounds
This parameter controls how bounds are rendered:
Value
|
Meaning
|
Symbolic constant
|
0
|
Inherit the parent object's mode
|
GD_BOUNDS_INHERIT
|
1
|
Do not render bounds
|
GD_NO_BOUNDS
|
2
|
Render bounds
|
GD_BOUNDS
|
normals
The parameter controls the usage of normals. Unsupported at the current time.
colors
The parameter controls the usage of colors. Unsupported at the current time.
reset
This parameter when set causes the properties attached to the editor to be reset to their default values.
Example
Libraries.Graphics_Display.Editors.UI_Editors.ModesEditor
File
v/gd.v
See also related modules