![]() |
![]() |
![]() |
Gwyddion Widgets Library Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals |
#include <libgwydgets/gwydgets.h> struct GwyGraphCurveModel; struct 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
); GwyCurveCalibrationData * gwy_graph_curve_model_get_calibration_data (GwyGraphCurveModel *gcmodel
); void gwy_graph_curve_model_set_calibration_data (GwyGraphCurveModel *gcmodel
,const GwyCurveCalibrationData *calibration
);
"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.
struct GwyGraphCurveModelClass { GObjectClass parent_class; void (*data_changed)(GwyGraphCurveModel *model); void (*reserved1)(void); void (*reserved2)(void); void (*reserved3)(void); };
#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.
If there were calibration data in the former gcmodel
, they are removed.
|
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.
If there were calibration data in the former gcmodel
, they are removed.
|
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.
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
);
GwyCurveCalibrationData * gwy_graph_curve_model_get_calibration_data
(GwyGraphCurveModel *gcmodel
);
Get pointer to actual calibration data for curve.
|
A graph curve model. |
Returns : |
Pointer to the calibration data of present curve (NULL if none). |
void gwy_graph_curve_model_set_calibration_data (GwyGraphCurveModel *gcmodel
,const GwyCurveCalibrationData *calibration
);
Set calibration data for curve.
|
A graph curve model. |
|
Curve calibration data |
"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. |