Top | ![]() |
![]() |
![]() |
![]() |
gchar * (*GwySaveAuxiliaryCreate) (gpointer user_data
,gssize *data_len
);
The type of auxiliary saved data creation function.
user_data |
The data passed to |
|
data_len |
The length of the returned data in bytes. Leaving it unset has
the same effect as setting it to a negative value. See
|
Since: 2.3
void (*GwySaveAuxiliaryDestroy) (gchar *data
,gpointer user_data
);
The type of auxiliary saved data destruction function.
data |
The data returned by the corresponding GwySaveAuxiliaryCreate function. |
|
user_data |
The data passed to |
Since: 2.3
gboolean gwy_save_auxiliary_data (const gchar *title
,GtkWindow *parent
,gssize data_len
,const gchar *data
);
Saves a report or other auxiliary data to a user specified file.
This is actually a simple gwy_save_auxiliary_with_callback()
wrapper, see
its description for details.
title |
File chooser dialog title. |
|
parent |
Parent window for the file chooser dialog (may be |
|
data_len |
The length of |
|
data |
The data to save. |
Since: 2.3
gboolean gwy_save_auxiliary_with_callback (const gchar *title
,GtkWindow *parent
,GwySaveAuxiliaryCreate create
,GwySaveAuxiliaryDestroy destroy
,gpointer user_data
);
Saves a report or other auxiliary data to a user specified file.
title |
File chooser dialog title. |
|
parent |
Parent window for the file chooser dialog (may be |
|
create |
Function to create the data (it will not be called if the user cancels the saving). |
|
destroy |
Function to destroy the data (if will be called iff |
|
user_data |
User data passed to |
TRUE
if the data was save, FALSE
if it was not saved for any
reason (I/O error, cancellation, overwrite cancellation, etc.).
Since: 2.3
void gwy_set_data_preview_size (GwyDataView *data_view
,gint max_size
);
Sets up data view zoom to not exceed specified size.
Before calling this function, data keys have be set, data fields and layers have to be present and physically square mode set in the container. Sizing of both pixel-wise square and physically square displays is performed correctly.
data_view |
A data view used for module preview. |
|
max_size |
Maximum allowed |
Since: 2.7
gint gwy_app_add_graph_or_curves (GwyGraphModel *gmodel
,GwyContainer *data
,const GwyAppDataId *target_graph
,gint colorstep
);
Puts the curves of a graph to another graph if possible, or adds the graph as new.
If the units of gmodel
are compatible with the units of the graph
identified by target_graph
the curves are copied to the target graph with
gwy_graph_model_append_curves()
.
In all other cases, including when target_graph
does not refer to any
existing graph, the graph model is added to data
as a new graph.
Either way, the caller usually need to release its own reference afterwards.
This function is useful particularly in modules that create graphs and can be run non-interactively.
gmodel |
A graph model with curves to add. |
|
data |
Data container where the graph would be added. |
|
target_graph |
Graph where curves would be added. |
|
colorstep |
Curve block size as in |
The numerical identifier of the newly-created graph of one was
created. Value -1 is returned if curves were added to
target_graph
.
Since: 2.41
void gwy_preview_surface_to_datafield (GwySurface *surface
,GwyDataField *dfield
,gint max_xres
,gint max_yres
,GwyPreviewSurfaceFlags flags
);
Renders a preview of a XYZ data surface to a data field.
surface |
A surface representing a XYZ data. |
|
dfield |
A data field to fill with |
|
max_xres |
Maximum width of the preview, it must be at least 2. |
|
max_yres |
Maximum height of the preview, it must be at least 2. |
|
flags |
Flags modifying the behaviour. |
Since: 2.46
gboolean
gwy_app_data_id_verify_channel (GwyAppDataId *id
);
Checks if numerical channel identifiers correspond to an existing channel.
If either the data contained referenced in id
or the channel does not exist
the structure is cleared to GWY_APP_DATA_ID_NONE
and the function returns
FALSE
. If it represents an existing channel it is kept intact and the
function returns TRUE
.
Since: 2.41
gboolean
gwy_app_data_id_verify_graph (GwyAppDataId *id
);
Checks if numerical graph identifiers correspond to an existing graph.
If either the data contained referenced in id
or the graph model does not
exist the structure is cleared to GWY_APP_DATA_ID_NONE
and the function
returns FALSE
. If it represents an existing graph it is kept intact and
the function returns TRUE
.
Since: 2.41
gboolean
gwy_app_data_id_verify_volume (GwyAppDataId *id
);
Checks if numerical volume data identifiers correspond to existing volume data.
If either the data contained referenced in id
or the volume data does not
exist the structure is cleared to GWY_APP_DATA_ID_NONE
and the function
returns FALSE
. If it represents existing volume data it is kept intact
and the function returns TRUE
.
Since: 2.41
gboolean
gwy_app_data_id_verify_xyz (GwyAppDataId *id
);
Checks if numerical XYZ data identifiers correspond to existing XYZ data.
If either the data contained referenced in id
or the XYZ data does not
exist the structure is cleared to GWY_APP_DATA_ID_NONE
and the function
returns FALSE
. If it represents existing XYZ data it is kept intact
and the function returns TRUE
.
Since: 2.46
gboolean
gwy_app_data_id_verify_spectra (GwyAppDataId *id
);
Checks if numerical spectra identifiers correspond to existing spectra.
If either the data contained referenced in id
or the spectra does not
exist the structure is cleared to GWY_APP_DATA_ID_NONE
and the function
returns FALSE
. If it represents existing spectra it is kept intact and
the function return TRUE
.
Since: 2.41
Type of behaviour modifying flags that can be passed to
gwy_preview_surface_to_datafield()
.
Since: 2.46