Curve map modules: Gwyddion Application Library Reference Manual

Curve map modules

Curve map modules — Curve map data processing modules

Functions

void	(*GwyCurveMapFunc) ()
gboolean	gwy_curve_map_func_register ()
void	gwy_curve_map_func_run ()
gboolean	gwy_curve_map_func_exists ()
GwyRunModeFlags	gwy_curve_map_func_get_run_types ()
const gchar *	gwy_curve_map_func_get_menu_path ()
const gchar *	gwy_curve_map_func_get_icon_name ()
const gchar *	gwy_curve_map_func_get_tooltip ()
guint	gwy_curve_map_func_get_sensitivity_mask ()
void	gwy_curve_map_func_foreach ()
const gchar *	gwy_curve_map_func_current ()

Includes

#include <libgwyapp/gwyapp.h>

Description

Curve map data processing modules implement function processing curve map data represented with GwyLawn. They reigster functions that get a GwyFile with data and either modify it or create a new data from it. In this regard, they are quite similar to regular (two-dimensional) data processing functions but they live in separate menus, toolbars, etc.

Functions

GwyCurveMapFunc()

void
(*GwyCurveMapFunc) (GwyFile *data,
                    GwyRunModeFlags run);

The type of curve map data processing function.

Parameters

data	The data container to operate on.
run	Run mode.

gwy_curve_map_func_register()

gboolean
gwy_curve_map_func_register (const gchar *name,
                             GwyCurveMapFunc func,
                             const gchar *menu_path,
                             const gchar *icon_name,
                             GwyRunModeFlags run,
                             guint sens_mask,
                             const gchar *tooltip);

Registers a curve map data processing function.

Note: the string arguments are not copied as modules are not expected to vanish. If they are constructed (non-constant) strings, do not free them. Should modules ever become unloadable they will get a chance to clean-up.

Parameters

name	Name of function to register. It should be a valid identifier and if a module registers only one function, module and function names should be the same.
func	The function itself.
menu_path	Menu path under Curve Map menu. The menu path should be marked translatabe, but passed untranslated (to allow merging of translated and untranslated submenus).
icon_name	Stock icon id for toolbar.
run	Supported run modes. Curve map data processing functions can have two run modes: `GWY_RUN_IMMEDIATE` (no questions asked) and `GWY_RUN_INTERACTIVE` (a modal dialog with parameters).
sens_mask	Sensitivity mask (a combination of GwyMenuSensFlags flags). Usually it contains GWY_MENU_FLAG_CMAP, possibly other requirements.
tooltip	Tooltip for this function.

Returns

Normally TRUE; FALSE on failure.

gwy_curve_map_func_run()

void
gwy_curve_map_func_run (const gchar *name,
                        GwyFile *data,
                        GwyRunModeFlags run);

Runs a curve map processing function identified by name .

Parameters

name	Curve map data processing function name.
data	Data (a GwyFile).
run	How the function should be run.

gwy_curve_map_func_exists()

gboolean
gwy_curve_map_func_exists (const gchar *name);

Checks whether a curve map processing function exists.

Parameters

name

Curve map data processing function name.

Returns

TRUE if function name exists, FALSE otherwise.

gwy_curve_map_func_get_run_types()

GwyRunModeFlags
gwy_curve_map_func_get_run_types (const gchar *name);

Returns run modes supported by a curve map processing function.

Parameters

name

Curve map data processing function name.

Returns

The run mode bit mask.

gwy_curve_map_func_get_menu_path()

const gchar *
gwy_curve_map_func_get_menu_path (const gchar *name);

Returns the menu path of a curve map processing function.

The returned menu path is only the tail part registered by the function, i.e., without any leading "/Curve Map".

Parameters

name

Curve map data processing function name.

Returns

The menu path. The returned string is owned by the module.

gwy_curve_map_func_get_icon_name()

const gchar *
gwy_curve_map_func_get_icon_name (const gchar *name);

Gets icon name of a curve map processing function.

Parameters

name

Curve map data processing function name.

Returns

The icon name. The returned string is owned by the module.

gwy_curve_map_func_get_tooltip()

const gchar *
gwy_curve_map_func_get_tooltip (const gchar *name);

Gets tooltip for a curve map processing function.

Parameters

name

Curve map data processing function name.

Returns

The tooltip. The returned string is owned by the module.

gwy_curve_map_func_get_sensitivity_mask()

guint
gwy_curve_map_func_get_sensitivity_mask
                               (const gchar *name);

Gets menu sensititivy mask for a curve map processing function.

Parameters

name

Curve map data processing function name.

Returns

The menu item sensitivity mask (a combination of GwyMenuSensFlags flags).

gwy_curve_map_func_foreach()

void
gwy_curve_map_func_foreach (GwyNameFunc function,
                            gpointer user_data);

Calls a function for each curve map function.

Parameters

function	Function to run for each curve map function. It will get function name (constant string owned by module system) as its first argument, `user_data` as the second argument.
user_data	Data to pass to `function` .

gwy_curve_map_func_current()

const gchar *
gwy_curve_map_func_current (void);

Obtains the name of currently running curve map processing function.

If no curve map processing function is currently running, NULL is returned.

If multiple nested functions are running (which is not usual but technically possible), the innermost function name is returned.

Returns

The name of currently running curve map processing function or NULL.