Name

C Prototype

/*** Standard widget functions ***/

int dw_grins_create (Frame parent);
void dw_grins_destroy (int id);
void dw_grins_hide (int id);
void dw_grins_redraw (int id);
void dw_grins_reset (int id);
void dw_grins_setlabel(int id, char *label);
void dw_grins_show (int id);

/*** Functions specific to the Grins widget ***/

int dy_grins_invoke(int id, dt_Handle dep, void (*cb)());

/*** User-supplied callback functions. ***/

void cb(dt_Handle dep);

Description

Grins may also be used as a conventional molecular editor which reads and writes files in Thor datatree format.

Datatrees in these files contain SMILES ($SMI) and 2-D (2D) data items. A special directory containing such files is used to provide a number of starting templates (GRINS_PARENTDIR). Daylight supplies a directory tree with files containing ring systems and common drug parents. Grins responds to a number of other specialized options, described below.

dw_grins_create(Frame parent) => int

Create a Grins 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_grins_destroy(int id) => void

Destroy the given Grins widget.

dw_grins_hide(int id) => void

Unconditionally hide the given Grins widget.

dy_grins_invoke(int id, dt_Handle dep, void (*depcb)(int id, dt_Handle dep)) => int

Invoke Grins widget id starting with the given depiction. If no depiction is given (i.e. dep is set to NULL_OB), it will start up with the last depiction edited. The callback is called with the edited depiction when the user clicks "Select" (or NULL_OB on "Cancel"). Grins does not use the starting depiction (or it's molecule) directly, so they may be freely deallocated. The returned depiction is owned by Grins so the calling program should not deallocate it, and modify copies rather than the original.

dy_grins_invoke2(int id, dt_Handle ob, int lang, int langmask, void (*sobcb)(int id, int lang, dt_Handle sob) => int

Like dy_grins_invoke(), except that the input object may be a depiction, a molecule or a string object, and that the user may be allowed to specify a pattern as well as a molecule. The flags DX_LANG_SMILES and DX_LANG_SMARTS, defined in dt_widgets.h, are used to control language access. Initial widget state is determined by the value of argument `lang'. Langmask is an input variable determining which languages are available to the user, e.g., if dy_grins_invoke2 is called with langmask = DX_LANG_SMILES | DX_LANG_SMARTS, the user will be able to switch between them. The callback always returns a string object as well as the languages desired by the user.

dw_grins_redraw(int id) => void

Refresh the given widget.

dw_grins_reset(int id) => void

Clear the given Grins widget.

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

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

dw_grins_show(int id) => void

Make the given Grins widget visible. This is not typically needed, since dw_grins_invoke() automatically makes the widget visible.

OPTIONS:

GRINS_X, GRINS_Y, GRINS_WIDTH, GRINS_HEIGHT

Specify initial geometry for Grins window in pixels.

GRINS_DRAG_MINFAST

Minimum number of atoms for which "fast dragging" mode is used. When "fast dragging", drawing atomic symbols are suppressed for better performance. This is only a hint to the widget, which is free to do what it thinks is best (e.g. fast dragging will not be used for atoms which have no bonds).

GRINS_DRAG_STYLE

Specify how to draw dragged parts of the molecule. The default, and best choice, is DOTTED. Some servers have problems XOR'ing dotted lines: if your server leaves "dirt" when dragging, set this to NONE.

GRINS_FONT_PRIMARY, GRINS_FONT_SUBSCRIPT

Specify full names of fonts to be used when drawing atomic symbols and subscripts.

GRINS_FOREGROUND, GRINS_BACKGROUND

Specify Grins foreground and background colors as standard color names (see man page for dw_edgar()).

GRINS_PARENTDIR

Specify the directory containing Thor datatree (.tdt) files of the parent templates. This can be a full path name or symbolic name.

GRINS_PLANE_MASK

Specify how many planes are XOR'ed when dragging. This is typically the number of planes used to represent white, e.g. 1 for Sun servers (0 is black, color cell 1 is white), and 3 for SGI servers (0 is black, planes 1, 2, 3 are red, green, blue).

Return Value

Release 4.2 is the first release of this widget.

Release 4.3 supports all 4.2 requests.

Bugs

Some Sun hardware leaves dirt when dragging (4/470 with CP6 graphics board). Since this is obsolete hardware Sun probably won't fix it; setting GRINS_DRAG_STYLE to NONE is the workaround.

Related Topics