+ | + | + | + | + |
Beside GwyResponseType, the following GTK+ responses are recognised and handled automatically.
GTK_RESPONSE_OK
or GTK_RESPONSE_ACCEPT
creates an OK button which finishes the dialog with result
GWY_DIALOG_PROCEED
(or GWY_DIALOG_HAVE_RESULT
if result has been calculated).
GTK_RESPONSE_CANCEL
or GTK_RESPONSE_REJECT
creates a Cancelbutton which finishes the dialog with result
+
GTK_RESPONSE_CANCEL
or GTK_RESPONSE_REJECT
creates a Cancel button which finishes the dialog with result
GWY_DIALOG_CANCEL
.
void +gwy_param_def_add_hold_selection (+GwyParamDef *pardef
, +gint id
, +const gchar *name
, +const gchar *desc
);
Defines a new flags parameter with values that are selection holding flags.
+The values are flags from GwyHoldSelectionFlags. The default is zero.
+pardef |
+A set of parameter definitions. |
++ |
id |
+Parameter identifier. |
++ |
name |
+Parameter name for settings. It can be |
++ |
desc |
+Parameter description which will be used for a label in GUI. Normally pass |
++ |
Since: 2.63
+void gwy_param_def_add_seed (GwyParamDef *pardef
, diff -Nru gwyddion-2.62/devel-docs/libgwyapp/html/GwyParamTable.html gwyddion-2.63/devel-docs/libgwyapp/html/GwyParamTable.html --- gwyddion-2.62/devel-docs/libgwyapp/html/GwyParamTable.html 2022-11-03 13:08:17.000000000 +0000 +++ gwyddion-2.63/devel-docs/libgwyapp/html/GwyParamTable.html 2023-06-13 13:24:17.000000000 +0000 @@ -630,6 +630,14 @@ void+gwy_param_table_append_range () + + ++ @@ -718,6 +726,14 @@ void+void + +gwy_param_table_append_unit_chooser () +gwy_param_table_append_hold_selection () + + ++ @@ -1182,7 +1198,7 @@+void + +gwy_param_table_append_seed () No-reset parameters are untouched by
-gwy_param_table_reset()
. Hence they are not reset by the GwyDialog reset response handler either. This can be useful for parameters that do not have static default values and need special treatment during the reset.Some parameters are no-reset by default: data ids and mask colour.
+Some parameters are no-reset by default: for instance data ids or mask colour.
Parameters
@@ -1802,7 +1818,7 @@ must be a boolean defined by
gwy_param_def_add_boolean()
or a predefined boolean.The parameter identified by
other_id
must be added as combo box, data chooser, slider or radio button row (text -or image buttons). The check box will the be integrated in the control of that parameter. If you have a generic +or image buttons). The check box will then be integrated in the control of that parameter. If you have a generic enable/disable parameter with its own standalone checkbox usegwy_param_table_append_checkbox()
instead (and set widget sensitivity usinggwy_param_table_set_sensitive()
in the “param-changed” signal handler).@@ -3732,6 +3748,52 @@
++gwy_param_table_append_range ()
+void +gwy_param_table_append_range (+GwyParamTable *partable
, +gint id_from
, +gint id_to
);Adds a pair of numerical entries representing a range to a parameter table.
+This is mostly useful for entering graph ranges numerically. For image ranges separate controls are preferred as +they allow pixel plus alternative real values.
+The two parameters identified by
+id_from
+ andid_to
+ must be doubles and distinct. Parameterid_from
+ is considered +primary and should be used for referring to the control as a whole (for instance to make it insensitive), even +though for convenience both are passed directly to this function.Use
+gwy_param_table_entry_set_value_format()
to set the value format.++Parameters
+++
+ + ++ + + + ++ partable
+ Set of parameter value controls.
+ + ++ id_from
+ Parameter identifier for the beginning.
+ + + ++ id_to
+ Parameter identifier for the end.
+ Since: 2.63
+
+gwy_param_table_append_unit_chooser ()
void gwy_param_table_append_unit_chooser (GwyParamTable *partable
, @@ -4247,6 +4309,40 @@
++gwy_param_table_append_hold_selection ()
+void +gwy_param_table_append_hold_selection (+GwyParamTable *partable
, +gint id
);Adds a selection holding parameter to a parameter table.
+The parameter identified by
+id
+ must be a selection holding flags parameter defined by +gwy_param_def_add_hold_selection()
.++Parameters
+++
+ + ++ + + + ++ partable
+ Set of parameter value controls.
+ + + ++ id
+ Parameter identifier.
+ Since: 2.63
+
+gwy_param_table_append_seed ()
void gwy_param_table_append_seed (GwyParamTable *partable
, diff -Nru gwyddion-2.62/devel-docs/libgwyapp/html/GwyPlainTool.html gwyddion-2.63/devel-docs/libgwyapp/html/GwyPlainTool.html --- gwyddion-2.62/devel-docs/libgwyapp/html/GwyPlainTool.html 2022-11-03 13:08:17.000000000 +0000 +++ gwyddion-2.63/devel-docs/libgwyapp/html/GwyPlainTool.html 2023-06-13 13:24:17.000000000 +0000 @@ -97,6 +97,22 @@+ +void + ++gwy_plain_tool_hold_selection () + ++ ++void + ++gwy_plain_tool_enable_selection_holding () + ++ GwyRectSelectionLabels * @@ -159,10 +175,18 @@ GwyPlainToolChanged + +enum +GwyHoldSelectionFlags +GwyRectSelectionLabels + ++ GwyToolHeldSelection +@@ -421,8 +445,7 @@ struct GwyPlainTool void gwy_plain_tool_enable_object_deletion (-GwyPlainTool *plain_tool
,GtkTreeView *treeview
);Enables deletion of selection objects by presssing Delete in a tree view -diplaying them.
+Enables deletion of selection objects by presssing Delete in a tree view diplaying them.
Parameters
@@ -449,6 +472,71 @@
++gwy_plain_tool_hold_selection ()
+void +gwy_plain_tool_hold_selection (+GwyPlainTool *plain_tool
, +GwyHoldSelectionFlags hold_flags
);Possibly transfers the selection to a new image upon plain tool data switch.
+This function should be called from
+data_switched()
class method in a tool after setting up the layer and +selection. If the selection should be transferred to the new image according tohold_flags
+ the previous (held) +selection will replace whatever selection might be there currently. Otherwise the new image's selection is +preserved (and in fact held itself).Selection holding must be enabled in tool instance init function using
+gwy_plain_tool_enable_selection_holding()
.++Parameters
+++
+ + ++ + + + ++ plain_tool
+ A plain tool.
+ + + ++ hold_flags
+ Flags controlling when the selection is held (transferred to another image).
+ Since: 2.63
+
+++gwy_plain_tool_enable_selection_holding ()
+void +gwy_plain_tool_enable_selection_holding + (+GwyPlainTool *plain_tool
);Enables selection holding for a plain tool.
+Selection holding means that, if certain conditions are satisfied, upon data switch the tool transfers the current +selection to the new image, replacing whatever selection might be there.
+This function should be called from the instance init function.
+Holding is currently unsupported for tools which use multiple selection types.
+ +Since: 2.63
+
+gwy_rect_selection_labels_new ()
GwyRectSelectionLabels * gwy_rect_selection_labels_new (gboolean none_is_full
, @@ -725,11 +813,59 @@
++enum GwyHoldSelectionFlags
+Flags controlling the selection holding behaviour of tools.
+Although any combination of flags is valid, this is mainly so that user's choice is not reset. For any holding to +be done at all the
+GWY_HOLD_SELECTION_HOLD
flag must be set. If it is unset thenGWY_HOLD_SELECTION_OVERWRITE
+andGWY_HOLD_SELECTION_CLEAR
do not matter. Similarly, forGWY_HOLD_SELECTION_CLEAR
has any effect only if +overwriting is enabled by settingGWY_HOLD_SELECTION_OVERWRITE
.++Members
+++
+ + ++ + + + ++ + +Selections are held (transferred to the new image).
++ + ++ + +Existing selections on the new image is replaced.
++ + + ++ + +If the current image has no selection the selection on the new image is cleared.
++ Since: 2.63
+
+
+
+ diff -Nru gwyddion-2.62/devel-docs/libgwyapp/html/index.html gwyddion-2.63/devel-docs/libgwyapp/html/index.html --- gwyddion-2.62/devel-docs/libgwyapp/html/index.html 2022-11-03 13:08:17.000000000 +0000 +++ gwyddion-2.63/devel-docs/libgwyapp/html/index.html 2023-06-13 13:24:17.000000000 +0000 @@ -15,7 +15,7 @@
Gwyddion Application Library Reference Manual
@@ -146,6 +146,7 @@- For Gwyddion 2.62. + For Gwyddion 2.63. The latest version of this document can be found on-line at http://gwyddion.net/documentation/libgwyapp/.
Index of new symbols in 2.60 Index of new symbols in 2.61 Index of new symbols in 2.62 +Index of new symbols in 2.63