| Gwyddion Widgets Library Reference Manual | ||||
|---|---|---|---|---|
#include <libgwydgets/gwydgets.h>
GwyGraphArea;
GwyGraphAreaClass;
GtkWidget* gwy_graph_area_new (void);
GtkWidget* gwy_graph_area_get_label (GwyGraphArea *area);
void gwy_graph_area_set_model (GwyGraphArea *area,
GwyGraphModel *gmodel);
GwyGraphModel* gwy_graph_area_get_model (GwyGraphArea *area);
void gwy_graph_area_get_cursor (GwyGraphArea *area,
gdouble *x_cursor,
gdouble *y_cursor);
void gwy_graph_area_set_x_range (GwyGraphArea *area,
gdouble x_min,
gdouble x_max);
void gwy_graph_area_set_y_range (GwyGraphArea *area,
gdouble y_min,
gdouble y_max);
void gwy_graph_area_set_x_grid_data (GwyGraphArea *area,
guint ndata,
const gdouble *grid_data);
void gwy_graph_area_set_y_grid_data (GwyGraphArea *area,
guint ndata,
const gdouble *grid_data);
const gdouble* gwy_graph_area_get_x_grid_data (GwyGraphArea *area,
guint *ndata);
const gdouble* gwy_graph_area_get_y_grid_data (GwyGraphArea *area,
guint *ndata);
GwySelection* gwy_graph_area_get_selection (GwyGraphArea *area,
GwyGraphStatusType status_type);
void gwy_graph_area_set_status (GwyGraphArea *area,
GwyGraphStatusType status_type);
GwyGraphStatusType gwy_graph_area_get_status (GwyGraphArea *area);
void gwy_graph_area_draw_on_drawable (GwyGraphArea *area,
GdkDrawable *drawable,
GdkGC *gc,
gint x,
gint y,
gint width,
gint height);
GString* gwy_graph_area_export_vector (GwyGraphArea *area,
gint x,
gint y,
gint width,
gint height);
void gwy_graph_area_enable_user_input (GwyGraphArea *area,
gboolean enable);
void gwy_graph_area_edit_curve (GwyGraphArea *area,
gint id);
GObject
+----GInitiallyUnowned
+----GtkObject
+----GtkWidget
+----GtkContainer
+----GtkLayout
+----GwyGraphArea
GwyGraphArea is the central part of GwyGraph widget. It plots a set of data curves with the given plot properties.
It is recommended to use it within GwyGraph, however, it can also be used separately.
typedef struct {
GtkLayoutClass parent_class;
void (*edit_curve)(GwyGraphArea *area,
gint id);
void (*reserved2)(void);
} GwyGraphAreaClass;
GtkWidget* gwy_graph_area_new (void);
Creates a new graph area widget.
Returns : |
Newly created graph area as GtkWidget. |
GtkWidget* gwy_graph_area_get_label (GwyGraphArea *area);
Gets the label inside a graph area.
|
A graph area. |
Returns : |
The graph label widget within the graph area. |
void gwy_graph_area_set_model (GwyGraphArea *area, GwyGraphModel *gmodel);
Sets the graph model of a graph area.
|
A graph area. |
|
New graph model. |
GwyGraphModel* gwy_graph_area_get_model (GwyGraphArea *area);
Gets the model of a graph area.
|
A graph area. |
Returns : |
The graph model this graph area widget displays. |
void gwy_graph_area_get_cursor (GwyGraphArea *area, gdouble *x_cursor, gdouble *y_cursor);
Gets mouse cursor related values within a graph area.
|
A graph area. |
|
Location to store the x value corresponding to cursor position. |
|
Location to store the y value corresponding to cursor position. |
void gwy_graph_area_set_x_range (GwyGraphArea *area, gdouble x_min, gdouble x_max);
Sets the horizontal range a graph area displays.
|
A graph area. |
|
The minimum x value, in real coodrinates. |
|
The maximum x value, in real coodrinates. |
void gwy_graph_area_set_y_range (GwyGraphArea *area, gdouble y_min, gdouble y_max);
Sets the vertical range a graph area displays.
|
A graph area. |
|
The minimum y value, in real coodrinates. |
|
The maximum y value, in real coodrinates. |
void gwy_graph_area_set_x_grid_data (GwyGraphArea *area, guint ndata, const gdouble *grid_data);
Sets the grid data on the x-axis of a graph area
|
A graph area. |
|
The number of points in grid_data.
|
|
Array of grid line positions on the x-axis (in real values, not pixels). |
void gwy_graph_area_set_y_grid_data (GwyGraphArea *area, guint ndata, const gdouble *grid_data);
Sets the grid data on the y-axis of a graph area
|
|
|
The number of points in grid_data.
|
|
Array of grid line positions on the y-axis (in real values, not pixels). |
const gdouble* gwy_graph_area_get_x_grid_data (GwyGraphArea *area, guint *ndata);
Gets the grid data on the x-axis of a graph area.
|
A graph area. |
|
Location to store the number of returned positions. |
Returns : |
Array of grid line positions (in real values, not pixels) owned by the graph area. |
const gdouble* gwy_graph_area_get_y_grid_data (GwyGraphArea *area, guint *ndata);
Gets the grid data on the y-axis of a graph area.
|
A graph area. |
|
Location to store the number of returned positions. |
Returns : |
Array of grid line positions (in real values, not pixels) owned by the graph area. |
GwySelection* gwy_graph_area_get_selection (GwyGraphArea *area, GwyGraphStatusType status_type);
Gets the selection object corresponding to a status of a graph area.
A selection object exists even for inactive status types (selection modes), therefore also selections for other modes than the currently active one can be requested.
|
A graph area. |
|
Graph status. Value GWY_GRAPH_STATUS_PLAIN mode (which has
no selection associated) stands for the currentl selection
mode.
|
Returns : |
The requested selection. It is NULL only if status_type is
GWY_GRAPH_STATUS_PLAIN and the current selection mode is
GWY_GRAPH_STATUS_PLAIN.
|
void gwy_graph_area_set_status (GwyGraphArea *area, GwyGraphStatusType status_type);
Sets the status of a graph area.
When the area is inside a GwyGraph, use gwy_graph_set_status() instead
(also see this function for details).
|
A graph area. |
|
New graph area status. |
GwyGraphStatusType gwy_graph_area_get_status (GwyGraphArea *area);
Gets the status of a grap area.
See gwy_graph_area_set_status().
|
A graph area. |
Returns : |
The current graph area status. |
void gwy_graph_area_draw_on_drawable (GwyGraphArea *area, GdkDrawable *drawable, GdkGC *gc, gint x, gint y, gint width, gint height);
Draws a graph area to a Gdk drawable.
|
A graph area. |
|
a GdkDrawable (destination for graphics operations) |
|
Graphics context. It is modified by this function unpredictably. |
|
X position in drawable where the graph area should be drawn
|
|
Y position in drawable where the graph area should be drawn
|
|
width of the graph area on the drawable |
|
height of the graph area on the drawable |
GString* gwy_graph_area_export_vector (GwyGraphArea *area, gint x, gint y, gint width, gint height);
Creates PostScript representation of a graph area.
|
A graph area. |
|
|
|
|
|
|
|
|
Returns : |
A fragment of PostScript code representing the the graph area as a newly allocated GString. |
void gwy_graph_area_enable_user_input (GwyGraphArea *area, gboolean enable);
Enables/disables all user input dialogs (invoked by clicking the mouse).
|
A graph area. |
|
TRUE to enable user interaction, FALSE to disable it.
|
void gwy_graph_area_edit_curve (GwyGraphArea *area, gint id);
Invokes the curve property dialog for a curve.
If the dialog is already displayed, it is switched to the requested curve.
|
A graph area. |
|
The index of the curve to edit properties of. |
Since 2.5
"status" property"status" GwyGraphStatusType : Read / Write
The type of reaction to mouse events (zoom, selections).
Default value: GWY_GRAPH_STATUS_PLAIN
"edit-curve" signalvoid user_function (GwyGraphArea *gwygraphcurvemodel, gint arg1, gpointer user_data) : Run First / Action
The ::data-changed signal is emitted when a curve properties are to be edited.
|
The GwyGraphArea which received the signal. |
|
The index of the curve to edit. |
|
user data set when the signal handler was connected. |
Since 2.5