GwyGraphArea: Gwyddion Widgets Library Reference Manual

## GwyGraphArea GwyGraphArea — Layout for drawing graph curves |

## Functions

GtkWidget * | gwy_graph_area_new ()
GtkWidget * | gwy_graph_area_get_label ()
void | gwy_graph_area_set_model ()
GwyGraphModel * | gwy_graph_area_get_model ()
void | gwy_graph_area_get_cursor ()
void | gwy_graph_area_set_x_range ()
void | gwy_graph_area_set_y_range ()
void | gwy_graph_area_set_x_grid_data ()
void | gwy_graph_area_set_y_grid_data ()
const gdouble * | gwy_graph_area_get_x_grid_data ()
const gdouble * | gwy_graph_area_get_y_grid_data ()
GwySelection * | gwy_graph_area_get_selection ()
void | gwy_graph_area_set_status ()
GwyGraphStatusType | gwy_graph_area_get_status ()
void | gwy_graph_area_draw_on_drawable ()
GString * | gwy_graph_area_export_vector ()
void | gwy_graph_area_enable_user_input ()
void | gwy_graph_area_set_selection_editable ()
void | gwy_graph_area_edit_curve ()

## Properties

GwyGraphStatusType | status | Read / Write

## Signals

void | edit-curve | Action

## Types and Values

struct | GwyGraphArea
struct | GwyGraphAreaClass

## Object Hierarchy

        GObject
        ╰── GInitiallyUnowned
            ╰── GtkObject
                ╰── GtkWidget
                    ╰── GtkContainer
                        ╰── GtkLayout
                            ╰── GwyGraphArea

## Implemented Interfaces

GwyGraphArea implements AtkImplementorIface and GtkBuildable.

## Includes

    #include <libgwydgets/gwydgets.h>

## Description

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.

## Functions

### gwy_graph_area_new ()

    GtkWidget *
    gwy_graph_area_new (void);

Creates a new graph area widget.

#### Returns

Newly created graph area as GtkWidget.

### gwy_graph_area_get_label ()

    GtkWidget *
    gwy_graph_area_get_label (GwyGraphArea *area);

Gets the label inside a graph area.

#### Parameters

area | A graph area. |

#### Returns

The graph label widget within the graph area.

### gwy_graph_area_set_model ()

    void
    gwy_graph_area_set_model (GwyGraphArea *area,
                              GwyGraphModel *gmodel);

Sets the graph model of a graph area.

#### Parameters

area | A graph area. |
gmodel | New graph model. |

### gwy_graph_area_get_model ()

    GwyGraphModel *
    gwy_graph_area_get_model (GwyGraphArea *area);

Gets the model of a graph area.

#### Parameters

area | A graph area. |

#### Returns

The graph model this graph area widget displays.

### gwy_graph_area_get_cursor ()

    void
    gwy_graph_area_get_cursor (GwyGraphArea *area,
                               gdouble *x_cursor,
                               gdouble *y_cursor);

Gets mouse cursor related values within a graph area.

#### Parameters

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. |

### gwy_graph_area_set_x_range ()

    void
    gwy_graph_area_set_x_range (GwyGraphArea *area,
                                gdouble x_min,
                                gdouble x_max);

Sets the horizontal range a graph area displays.

#### Parameters

area | A graph area. |
x_min | The minimum x value, in real coodrinates. |
x_max | The maximum x value, in real coodrinates. |

### gwy_graph_area_set_y_range ()

    void
    gwy_graph_area_set_y_range (GwyGraphArea *area,
                                gdouble y_min,
                                gdouble y_max);

Sets the vertical range a graph area displays.

#### Parameters

area | A graph area. |
y_min | The minimum y value, in real coodrinates. |
y_max | The maximum y value, in real coodrinates. |

### gwy_graph_area_set_x_grid_data ()

    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

#### Parameters

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). |

### gwy_graph_area_set_y_grid_data ()

    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

#### Parameters

area | A graph 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). |

### gwy_graph_area_get_x_grid_data ()

    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.

#### Parameters

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.

### gwy_graph_area_get_y_grid_data ()

    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.

#### Parameters

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.

### gwy_graph_area_get_selection ()

    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.

#### Parameters

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`.

### gwy_graph_area_set_status ()

    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).

#### Parameters

area | A graph area. |
status_type | New graph area status. |

### gwy_graph_area_get_status ()

    GwyGraphStatusType
    gwy_graph_area_get_status (GwyGraphArea *area);

Gets the status of a grap area.

See `gwy_graph_area_set_status()`.

#### Parameters

area | A graph area. |

#### Returns

The current graph area status.

### gwy_graph_area_draw_on_drawable ()

    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.

#### Parameters

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 |

### gwy_graph_area_export_vector ()

    GString *
    gwy_graph_area_export_vector (GwyGraphArea *area,
                                  gint x,
                                  gint y,
                                  gint width,
                                  gint height);

Creates PostScript representation of a graph area.

#### Parameters

area | A graph area. |
x | Bounding box origin X-coordinate. |
y | Bounding box origin Y-coordinate. |
width | Bounding box width. |
height | Bounding box height. |

#### Returns

A fragment of PostScript code representing the the graph area as a newly allocated GString.

### gwy_graph_area_enable_user_input ()

    void
    gwy_graph_area_enable_user_input (GwyGraphArea *area,
                                      gboolean enable);

Enables/disables auxiliary graph area dialogs (invoked by clicking the mouse).

Note, however, that this setting does not control editability of selections. Use `gwy_graph_area_set_selection_editable()` for that.

#### Parameters

area | A graph area. |
enable | `TRUE` to enable user interaction, `FALSE` to disable it. |

### gwy_graph_area_set_selection_editable ()

    void
    gwy_graph_area_set_selection_editable (GwyGraphArea *area,
                                           gboolean setting);

Enables/disables selection editing using mouse.

When selection editing is disabled the graph area status type determines the selection type that can be drawn on the area. However, the user cannot modify it.

#### Parameters

area | A graph area. |
setting | `TRUE` to enable selection editing, `FALSE` to disable it. |

Since: 2.45

### gwy_graph_area_edit_curve ()

    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.

#### Parameters

area | A graph area. |
id | The index of the curve to edit properties of. |

Since: 2.5

## Types and Values

### struct GwyGraphArea

    struct GwyGraphArea;

### struct GwyGraphAreaClass

    struct GwyGraphAreaClass {
        GtkLayoutClass parent_class;

        void (*edit_curve)(GwyGraphArea *area,
                           gint id);
        void (*reserved2)(void);
    };

## Property Details

### The `“status”` property

      “status”                   GwyGraphStatusType

The type of reaction to mouse events (zoom, selections).

Owner: GwyGraphArea

Flags: Read / Write

Default value: GWY_GRAPH_STATUS_PLAIN

## Signal Details

### The `“edit-curve”` signal

    void
    user_function (GwyGraphArea *gwygraphcurvemodel,
                   int           arg1,
                   gpointer      user_data)

The ::data-changed signal is emitted when a curve properties are to be edited.

#### Parameters

gwygraphcurvemodel | The GwyGraphArea which received the signal. |
arg1 | The index of the curve to edit. |
user_data | user data set when the signal handler was connected. |

Flags: Action

Since: 2.5