manpagez: man pages & more
html files: gtk2
Home | html | info | man

GtkCurve

GtkCurve — Allows direct editing of a curve

Properties

GtkCurveType curve-type Read / Write
gfloat max-x Read / Write
gfloat max-y Read / Write
gfloat min-x Read / Write
gfloat min-y Read / Write

Types and Values

struct GtkCurve

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkObject
            ╰── GtkWidget
                ╰── GtkDrawingArea
                    ╰── GtkCurve

Implemented Interfaces

GtkCurve implements AtkImplementorIface and GtkBuildable.

Includes

#include <gtk/gtk.h>

Description

The GtkCurve widget allows the user to edit a curve covering a range of values. It is typically used to fine-tune color balances in graphics applications like the Gimp.

The GtkCurve widget has 3 modes of operation - spline, linear and free. In spline mode the user places points on the curve which are automatically connected together into a smooth curve. In linear mode the user places points on the curve which are connected by straight lines. In free mode the user can draw the points of the curve freely, and they are not connected at all.

As of GTK+ 2.20, GtkCurve has been deprecated since it is too specialized.

Functions

gtk_curve_new ()

GtkWidget *
gtk_curve_new (void);

gtk_curve_new has been deprecated since version 2.20 and should not be used in newly-written code.

Don't use this widget anymore.

Creates a new GtkCurve.

Returns

a new GtkCurve.


gtk_curve_reset ()

void
gtk_curve_reset (GtkCurve *curve);

gtk_curve_reset has been deprecated since version 2.20 and should not be used in newly-written code.

Don't use this widget anymore.

Resets the curve to a straight line from the minimum x and y values to the maximum x and y values (i.e. from the bottom-left to the top-right corners). The curve type is not changed.

Parameters

curve

a GtkCurve.

 

gtk_curve_set_gamma ()

void
gtk_curve_set_gamma (GtkCurve *curve,
                     gfloat gamma_);

gtk_curve_set_gamma has been deprecated since version 2.20 and should not be used in newly-written code.

Don't use this widget anymore.

Recomputes the entire curve using the given gamma value. A gamma value of 1 results in a straight line. Values greater than 1 result in a curve above the straight line. Values less than 1 result in a curve below the straight line. The curve type is changed to GTK_CURVE_TYPE_FREE. FIXME: Needs a more precise definition of gamma.

Parameters

curve

a GtkCurve.

 

gamma_

the gamma value.

 

gtk_curve_set_range ()

void
gtk_curve_set_range (GtkCurve *curve,
                     gfloat min_x,
                     gfloat max_x,
                     gfloat min_y,
                     gfloat max_y);

gtk_curve_set_range has been deprecated since version 2.20 and should not be used in newly-written code.

Don't use this widget anymore.

Sets the minimum and maximum x and y values of the curve. The curve is also reset with a call to gtk_curve_reset().

Parameters

curve

a GtkCurve.

 

min_x

the minimum x value.

 

max_x

the maximum x value.

 

min_y

the minimum y value.

 

max_y

the maximum y value.

 

gtk_curve_get_vector ()

void
gtk_curve_get_vector (GtkCurve *curve,
                      int veclen,
                      gfloat vector[]);

gtk_curve_get_vector has been deprecated since version 2.20 and should not be used in newly-written code.

Don't use this widget anymore.

Returns a vector of points representing the curve.

Parameters

curve

a GtkCurve.

 

veclen

the number of points to calculate.

 

vector

returns the points.

 

gtk_curve_set_vector ()

void
gtk_curve_set_vector (GtkCurve *curve,
                      int veclen,
                      gfloat vector[]);

gtk_curve_set_vector has been deprecated since version 2.20 and should not be used in newly-written code.

Don't use this widget anymore.

Sets the vector of points on the curve. The curve type is set to GTK_CURVE_TYPE_FREE.

Parameters

curve

a GtkCurve.

 

veclen

the number of points.

 

vector

the points on the curve.

 

gtk_curve_set_curve_type ()

void
gtk_curve_set_curve_type (GtkCurve *curve,
                          GtkCurveType type);

gtk_curve_set_curve_type has been deprecated since version 2.20 and should not be used in newly-written code.

Don't use this widget anymore.

Sets the type of the curve. The curve will remain unchanged except when changing from a free curve to a linear or spline curve, in which case the curve will be changed as little as possible.

Parameters

curve

a GtkCurve.

 

type

the type of the curve.

 

Types and Values

struct GtkCurve

struct GtkCurve;

GtkCurve is deprecated and should not be used in newly-written code.

The GtkCurve struct contains private data only, and should be accessed using the functions below.

Property Details

The “curve-type” property

  “curve-type”               GtkCurveType

Is this curve linear, spline interpolated, or free-form.

Flags: Read / Write

Default value: GTK_CURVE_TYPE_SPLINE


The “max-x” property

  “max-x”                    gfloat

Maximum possible X value.

Flags: Read / Write

Default value: 1


The “max-y” property

  “max-y”                    gfloat

Maximum possible value for Y.

Flags: Read / Write

Default value: 1


The “min-x” property

  “min-x”                    gfloat

Minimum possible value for X.

Flags: Read / Write

Default value: 0


The “min-y” property

  “min-y”                    gfloat

Minimum possible value for Y.

Flags: Read / Write

Default value: 0

Signal Details

The “curve-type-changed” signal

void
user_function (GtkCurve *curve,
               gpointer  user_data)

Emitted when the curve type has been changed. The curve type can be changed explicitly with a call to gtk_curve_set_curve_type(). It is also changed as a side-effect of calling gtk_curve_reset() or gtk_curve_set_gamma().

Parameters

curve

the object which received the signal.

 

user_data

user data set when the signal handler was connected.

 

Flags: Run First

See Also

GtkGammaCurve

a subclass for editing gamma curves.

© manpagez.com 2000-2017
Individual documents may contain additional copyright information.