DefaultPickCtrl

Synopsis

define the Graphics Display Kit pick control information

GDpick_ctrl_templ

group+OPort  GDpick_ctrl_templ
{
int +IPort2 x;
int +IPort2  y;
int+IPort2 event;
int  mode;
int on_start;
};

GDpick_ctrl

GDpick_ctrl_templ  GDpick_ctrl
{
ptr+nonotify+nosave  local_ptr;
};

DefaultPickCtrl

GDpick_ctrl  DefaultPickCtrl
{
x = 0;
y = 0;
};

Description

These templates define the Graphics Display Kit's pick control information. GDpick_ctrl_templ defines the elements that cause pick control's methods to execute. GDpick_ctrl defines an instanceable version without default values. DefaultPickCtrl defines an instanceable version with default values.

The pick control information is connected to a Graphics Display Kit view. The view adds a callback (that is, the view pick routine) that is invoked when the pick control information changes, typically, when the XY position at which to pick is changed.

Input Ports

x
y

The screen space position at the time of the event. The XY positions typically come from either a UIonePoint or a UItwoPoint interactor.

event

Whether a pick event has occurred: 0 means no; non-zero means yes. The event typically comes from a UIonePoint or a UItwoPoint interactor.

Parameters

mode

This parameter controls the picking mode. The only supported mode is to pick the front-most primitive.

on_start

This parameter controls when picking is done if the pick control information is attached to a UItwoPoint. A UItwoPoint generates XY positions on the start gesture, the run gesture, and the end gesture. A value of 0 in the on_start parameter means to pick all gestures. A value of 1 means to generate a pick only on the start gesture.

This control can be used to allow the EditMesh module to perform its processing with one sequence. That is, the start gesture performs the pick and the highlight, the run gesture(s) perform the edit, and the end gesture confirms the edit.

Example

Libraries.Graphics_Display.Views.View3D

File

v/gdif.v