![]() |
![]() |
![]() |
Gwyddion Widgets Library Reference Manual | ![]() |
---|---|---|---|---|
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);
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 (*reserved1)(void); 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.
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.
area : |
A graph area. |
gmodel : |
New graph model. |
GwyGraphModel* gwy_graph_area_get_model (GwyGraphArea *area);
Gets the model of a graph area.
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.
area : |
A graph area. |
x_cursor : |
Location to store the x value corresponding to cursor position. |
y_cursor : |
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.
area : |
A graph area. |
x_min : |
The minimum x value, in real coodrinates. |
x_max : |
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.
area : |
A graph area. |
y_min : |
The minimum y value, in real coodrinates. |
y_max : |
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
area : |
A graph area. |
ndata : |
The number of points in grid_data .
|
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
area : |
|
ndata : |
The number of points in grid_data .
|
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.
area : |
A graph area. |
ndata : |
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.
area : |
A graph area. |
ndata : |
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.
area : |
A graph area. |
status_type : |
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).
area : |
A graph area. |
status_type : |
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()
.
area : |
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.
area : |
A graph area. |
drawable : |
a GdkDrawable (destination for graphics operations) |
gc : |
Graphics context. It is modified by this function unpredictably. |
x : |
X position in drawable where the graph area should be drawn
|
y : |
Y position in drawable where the graph area should be drawn
|
width : |
width of the graph area on the drawable |
height : |
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.
area : |
A graph area. |
x : |
|
y : |
|
width : |
|
height : |
|
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).
status
" property"status" GwyGraphStatusType : Read / Write
The type of reaction to mouse events (zoom, selections).
Default value: GWY_GRAPH_STATUS_PLAIN