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 Ports

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:

shell_vis => UICmd.do;

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