Name

C Prototype

/*** Standard widget functions ***/

int dw_3d_create (Frame parent);
void dw_3d_destroy (int id);
void dw_3d_hide (int id);
void dw_3d_redraw (int id);
void dw_3d_reset (int id);
void dw_3d_setlabel(int id, char *label);
void dw_3d_show (int id);

/*** Functions specific to the 3D widget ***/

int dy_3d_invoke(int id, dt_Handle conf);

Description

The calling program simply supplies a conformation to the widget which then handles all user interaction. The widget uses the conformation supplied (not a copy), so the calling program must not deallocate the conformation (or its underlying molecule) until the widget is cleared (via dw_3d_reset() or invoked with another conformation. By design, the operation of the widget is hidden from the main program. The XView widget provides a variety of rotation and depth cueing options which are selectable by the user.

Any number of trackball widgets can exist concurrently, with each instance displaying a single conformation.

dw_3d_create(Frame parent) => int

Create a 3D widget as a child of XView Frame parent. The widget is initially empty and is not visible. A positive widget id is returned on success; 0 is returned on error.

dw_3d_destroy(int id) => void

Destroy the given 3D widget.

dw_3d_hide(int id) => void

Unconditionally hide the given 3D widget.

dw_3d_invoke(int id, dt_Handle conformation) => int

Invoke 3D widget id with given conformation.

dw_3d_redraw(int id) => void

Refresh the given widget.

dw_3d_reset(int id) => void

Clear the given 3D widget.

dw_3d_setlabel(int id, char *label) => void

Set the label on the given 3D widget. A value of NULL sets the default label.

dw_3d_show(int id) => void

Make the given 3D widget visible. This is not typically needed, since dw_3d_invoke() automatically makes the widget visible.

OPTIONS:

The initial 3D widget display format is controlled by the following options. The HUE_ options may be dynamically altered via the Edgar Widget.

TRACKBALL_X, TRACKBALL_Y TRACKBALL_WIDTH, TRACKBALL_HEIGHT

Specify the initial geometry of the widget in pixels.

USE_TRANSIENT_WINDOWS

If FALSE, the user will be allowed to pin-up property menus (ala olwm); if TRUE, pin-ups will be disabled (ala mwm).

TRACKBALL_DEPTHCUE_MONO, TRACKBALL_DEPTHCUE_COLOR

Specify the initial depth cueing method for monochrome and color displays, respectively. Valid choices are NONE (the default), STYLE, WIDTH, and GRAYSCALE (not valid for monochrome displays).

HUE_BACKGROUND

Specifies the background color.

HUE_BORDER

Specifies the color of the trackball circle.

HUE_ELEM_H, HUE_ELEM_HE .. HUE_ELEM_LA

Specify atom colors by element to be used on color displays with NONE, STYLE, or WIDTH depth cueing.

HUE_GRAY_10, HUE_GRAY_20, .. HUE_GRAY_100

Specify colors for GRAYSCALE depth cueing.

Return Value

Bugs

Related Topics