forked from AuroraMiddleware/gtk
372c4d2627
1999-09-22 Damon Chaplin <damon@karuna.freeserve.co.uk> * gtk/tmpl/*.sgml: ran make templates, to fix problems with structs. * gtk/gtk-sections.txt: rearranged GtkCombo section. * gtk/tmpl/gtkvseparator.sgml: * gtk/tmpl/gtkhseparator.sgml: * gtk/tmpl/gtkgc.sgml: * gtk/tmpl/gtkfeatures.sgml: * gtk/tmpl/gtktipsquery.sgml: * gtk/tmpl/gtkitem.sgml: * gtk/tmpl/gtkinvisible.sgml: * gtk/tmpl/gtkgamma.sgml: * gtk/tmpl/gtkdata.sgml: * gtk/tmpl/gtkcurve.sgml: * gtk/tmpl/gtkcombo.sgml: * gtk/tmpl/gtkaccellabel.sgml: documented.
126 lines
3.3 KiB
Plaintext
126 lines
3.3 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
GtkCurve
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
allows direct editing of a curve.
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
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.
|
|
</para>
|
|
<para>
|
|
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.
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term>#GtkGammaCurve</term>
|
|
<listitem><para>a subclass for editing gamma curves.
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
</para>
|
|
|
|
<!-- ##### STRUCT GtkCurve ##### -->
|
|
<para>
|
|
The #GtkCurve-struct struct contains private data only, and
|
|
should be accessed using the functions below.
|
|
</para>
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_curve_new ##### -->
|
|
<para>
|
|
Creates a new #GtkCurve.
|
|
</para>
|
|
|
|
@Returns: a new #GtkCurve.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_curve_reset ##### -->
|
|
<para>
|
|
Resets the curve to a straight line from the minimum x & y values to the
|
|
maximum x & y values (i.e. from the bottom-left to the top-right corners).
|
|
The curve type is not changed.
|
|
</para>
|
|
|
|
@curve: a #GtkCurve.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_curve_set_gamma ##### -->
|
|
<para>
|
|
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.
|
|
</para>
|
|
|
|
@curve: a #GtkCurve.
|
|
@gamma: the gamma value.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_curve_set_range ##### -->
|
|
<para>
|
|
Sets the minimum and maximum x & y values of the curve.
|
|
The curve is also reset with a call to gtk_curve_reset().
|
|
</para>
|
|
|
|
@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.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_curve_get_vector ##### -->
|
|
<para>
|
|
Returns a vector of points representing the curve.
|
|
</para>
|
|
|
|
@curve: a #GtkCurve.
|
|
@veclen: the number of points to calculate.
|
|
@vector: returns the points.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_curve_set_vector ##### -->
|
|
<para>
|
|
Sets the vector of points on the curve.
|
|
The curve type is set to %GTK_CURVE_TYPE_FREE.
|
|
</para>
|
|
|
|
@curve: a #GtkCurve.
|
|
@veclen: the number of points.
|
|
@vector: the points on the curve.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_curve_set_curve_type ##### -->
|
|
<para>
|
|
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.
|
|
</para>
|
|
|
|
@curve: a #GtkCurve.
|
|
@type: the type of the curve.
|
|
|
|
|
|
<!-- ##### SIGNAL GtkCurve::curve-type-changed ##### -->
|
|
<para>
|
|
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().
|
|
</para>
|
|
|
|
@curve: the object which received the signal.
|
|
|