| Gwyddion Widgets Library Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals | ||||
#include <libgwydgets/gwydgets.h>
GwyGraphCurveModel;
GwyGraphCurveModelClass;
#define gwy_graph_curve_model_duplicate (gcmodel)
GwyGraphCurveModel* gwy_graph_curve_model_new (void);
GwyGraphCurveModel* gwy_graph_curve_model_new_alike (GwyGraphCurveModel *gcmodel);
void gwy_graph_curve_model_set_data (GwyGraphCurveModel *gcmodel,
const gdouble *xdata,
const gdouble *ydata,
gint n);
void gwy_graph_curve_model_set_data_from_dataline
(GwyGraphCurveModel *gcmodel,
GwyDataLine *dline,
gint from_index,
gint to_index);
const gdouble* gwy_graph_curve_model_get_xdata (GwyGraphCurveModel *gcmodel);
const gdouble* gwy_graph_curve_model_get_ydata (GwyGraphCurveModel *gcmodel);
gint gwy_graph_curve_model_get_ndata (GwyGraphCurveModel *gcmodel);
gboolean gwy_graph_curve_model_get_x_range (GwyGraphCurveModel *gcmodel,
gdouble *x_min,
gdouble *x_max);
gboolean gwy_graph_curve_model_get_y_range (GwyGraphCurveModel *gcmodel,
gdouble *y_min,
gdouble *y_max);
gboolean gwy_graph_curve_model_get_ranges (GwyGraphCurveModel *gcmodel,
gboolean x_logscale,
gboolean y_logscale,
gdouble *x_min,
gdouble *x_max,
gdouble *y_min,
gdouble *y_max);
"color" GwyRGBA* : Read / Write "description" gchar* : Read / Write "line-style" GdkLineStyle : Read / Write "line-width" gint : Read / Write "mode" GwyGraphCurveType : Read / Write "point-size" gint : Read / Write "point-type" GwyGraphPointType : Read / Write
GwyGraphCurveModel represents information about a graph curve necessary to fully reconstruct it.
typedef struct {
GObjectClass parent_class;
void (*data_changed)(GwyGraphCurveModel *model);
void (*reserved1)(void);
void (*reserved2)(void);
void (*reserved3)(void);
} GwyGraphCurveModelClass;
#define gwy_graph_curve_model_duplicate(gcmodel)
Convenience macro doing gwy_serializable_duplicate() with all the necessary
typecasting.
|
A graph curve model to duplicate. |
GwyGraphCurveModel* gwy_graph_curve_model_new (void);
Creates a new graph curve model.
Returns : |
New empty graph curve model as a GObject. |
GwyGraphCurveModel* gwy_graph_curve_model_new_alike (GwyGraphCurveModel *gcmodel);
Creates new graph curve model object that has the same settings as gcmodel.
Curve data are not duplicated.
|
A graph curve model. |
Returns : |
New graph curve model. |
void gwy_graph_curve_model_set_data (GwyGraphCurveModel *gcmodel,const gdouble *xdata,const gdouble *ydata,gint n);
Sets curve model data.
|
A graph curve model. |
|
X data points (array of size n).
|
|
Y data points (array of size n).
|
|
Number of points, i.e. items in xdata and ydata.
|
void gwy_graph_curve_model_set_data_from_dataline (GwyGraphCurveModel *gcmodel,GwyDataLine *dline,gint from_index,gint to_index);
Sets the curve data from GwyDataLine. The range of import can be
modified using parameters from_index and to_index that are
interpreted directly as data indices within the GwyDataLine.
In the case that from_index == to_index, the full GwyDataLine is used.
|
A graph curve model. |
|
A GwyDataLine |
|
index where to start |
|
where to stop |
const gdouble* gwy_graph_curve_model_get_xdata (GwyGraphCurveModel *gcmodel);
Gets pointer to x data points.
Data are used within the graph and cannot be freed.
|
A graph curve model. |
Returns : |
X data points, owned by the curve model. |
const gdouble* gwy_graph_curve_model_get_ydata (GwyGraphCurveModel *gcmodel);
Gets pointer to y data points.
Data are used within the graph and cannot be freed.
|
A graph curve model. |
Returns : |
Y data points, owned by the curve model. |
gint gwy_graph_curve_model_get_ndata (GwyGraphCurveModel *gcmodel);
|
A graph curve model. |
Returns : |
number of data points within the curve data |
gboolean gwy_graph_curve_model_get_x_range (GwyGraphCurveModel *gcmodel,gdouble *x_min,gdouble *x_max);
Gets the abscissa range of a graph curve.
The values are cached in the curve model therefore repeated calls to this function (with unchanged data) are cheap.
If there are no data points in the curve, x_min and x_max are untouched
and the function returns FALSE.
See also gwy_graph_curve_model_get_ranges() for a more high-level function.
gboolean gwy_graph_curve_model_get_y_range (GwyGraphCurveModel *gcmodel,gdouble *y_min,gdouble *y_max);
Gets the ordinate range of a graph curve.
The values are cached in the curve model therefore repeated calls to this function (with unchanged data) are cheap.
If there are no data points in the curve, x_min and x_max are untouched
and the function returns FALSE.
See also gwy_graph_curve_model_get_ranges() for a more high-level function.
"description" property"description" gchar* : Read / Write
Curve description. It appears on graph key.
Default value: "curve"
"line-style" property"line-style" GdkLineStyle : Read / Write
Curve line style. Curve mode has to include lines for the line to be visible.
Default value: GDK_LINE_SOLID
"line-width" property"line-width" gint : Read / Write
Curve line width.
Allowed values: [0,100]
Default value: 1
"mode" property"mode" GwyGraphCurveType : Read / Write
Curve plotting mode (line, points, ...).
Default value: GWY_GRAPH_CURVE_LINE
"point-size" property"point-size" gint : Read / Write
Curve point symbol size.
Allowed values: [0,100]
Default value: 5
"point-type" property"point-type" GwyGraphPointType : Read / Write
Curve point symbol type. Curve mode has toinclude points for the symbols to be visible.
Default value: GWY_GRAPH_POINT_SQUARE
"data-changed" signalvoid user_function (GwyGraphCurveModel *gwygraphcurvemodel, gpointer user_data) : Run First
The ::data-changed signal is emitted whenever curve data is set with
a function like gwy_graph_curve_model_set_data().
|
The GwyGraphCurveModel which received the signal. |
|
user data set when the signal handler was connected. |