gtk_pick

gtk_pick — The pick and measurement tab in the interactive dialog.

Synopsis

gboolean            visu_ui_interactive_pick_exportXMLFile
                                                        (const gchar *filename,
                                                         GError **error);
GList *             visu_ui_interactive_pick_getNodeSelection
                                                        ();
void                visu_ui_interactive_pick_init       ();
GtkWidget *         visu_ui_interactive_pick_initBuild  (VisuUiMain *main,
                                                         gchar **label,
                                                         gchar **help,
                                                         GtkWidget **radio);
gboolean            visu_ui_interactive_pick_parseXMLFile
                                                        (const gchar *filename,
                                                         VisuData *data,
                                                         GError **error);
void                visu_ui_interactive_pick_start      (VisuUiRenderingWindow *window);
void                visu_ui_interactive_pick_stop       (VisuUiRenderingWindow *window);

Description

This action tab provides widgets to display information about selected atoms, like distances or angles. In addition, measured distances and angles are kept in a list when new files are loaded.

With the list of selected nodes, one can modify properties associated to nodes like their coordinates, the value of colourisation if any, the forces on them, if any... One can also decide to display information directly on nodes.

Details

visu_ui_interactive_pick_exportXMLFile ()

gboolean            visu_ui_interactive_pick_exportXMLFile
                                                        (const gchar *filename,
                                                         GError **error);

Export to filename the list of currently picked nodes.

filename :

a filename to export to.

error :

a location to store an error. [allow-none]

Returns :

TRUE if everything goes right.

Since 3.7


visu_ui_interactive_pick_getNodeSelection ()

GList *             visu_ui_interactive_pick_getNodeSelection
                                                        ();

Compute a list of VisuNode currently listed.

Returns :

a newly created list. Should be freed with g_list_free() after use. [transfer container][element-type guint]

visu_ui_interactive_pick_init ()

void                visu_ui_interactive_pick_init       ();

Internal routine to setup the pick action of the interactive dialog.

Since 3.6


visu_ui_interactive_pick_initBuild ()

GtkWidget *         visu_ui_interactive_pick_initBuild  (VisuUiMain *main,
                                                         gchar **label,
                                                         gchar **help,
                                                         GtkWidget **radio);

This routine should be called in conjonction to the visu_ui_interactive_move_initBuild() one. It completes the creation of widgets (and also initialisation of values) for the pick tab.

main :

the main interface.

label :

a location to store the name of the pick tab ;

help :

a location to store the help message to be shown at the bottom of the window ;

radio :

a location on the radio button that will be toggled when the pick action is used.

visu_ui_interactive_pick_parseXMLFile ()

gboolean            visu_ui_interactive_pick_parseXMLFile
                                                        (const gchar *filename,
                                                         VisuData *data,
                                                         GError **error);

Parse the given V_Sim value file and update the dialog accordingly.

filename :

a filename ;

data :

a VisuData object to take the pick information from ;

error :

a location to store possible errors.

Returns :

TRUE if no error.

visu_ui_interactive_pick_start ()

void                visu_ui_interactive_pick_start      (VisuUiRenderingWindow *window);

Initialise a pick session.

window :

a VisuUiRenderingWindow object.

visu_ui_interactive_pick_stop ()

void                visu_ui_interactive_pick_stop       (VisuUiRenderingWindow *window);

Finalise a pick session.

window :

a VisuUiRenderingWindow object.