gnocl::curve

Create and display image processing gamma editing curves.

Synopsis

gnocl::curve [-option value...]

Screenshot


Options

-range string (default: 0 1 0 1)

List of float values specifying the x/y ranges for the graphy in the form of minX, maxX, minY maxY.
-curveType string (default: spline)
Specify curve type, one of linear, spline or curve.
-data string
User defined data which can be retrieved via the cget subcommand.
-name string
Name of the widget, can be used to set options in an rc file.
-tooltip string (default: "")

Message that appear next to this widget when the mouse pointer is held over it for a short amount of time.
-onCurveChanged string (default: "")
Tcl script which is executed whenever the curve type changes. Before evaluation the following percent strings are substituted:

%w    widget name
%g
   glade/builder name

-onShowHelp string (default: "")
Tcl command which is executed in the global scope if the "show-help" signal is received, which is normally the case if the user presses F1 or Ctrl-F1. Before evaluation the following percent strings are substituted:

%w   widget name
%h   help type: either "whatsThis" or "tooltip"
-sensitive boolean (default: 1)
Whether or not the item is sensitive to user input.
-visible boolean (default: 1)
Whether or not the item is visible.

Description

The curve widget allows a user to edit a curve covering a range of values. It is typically used to fine-tune color balances in graphics applications.  The curve 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.

Commands

id cget option

Returns the value for the specified option. The option may have any of hte values accepted by configure.

id class

Returns the class of the widget, i.e. statusIcon.

id configure [-option value...]

Configures the widget. Option may have any of the values accepted on creation of the widget.
id delete
Deletes the widget and the associated tcl command.
id get
Returns a vector of points representing the curve.

id reset
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.
id set [-option value...]
         Adjust the curve displayed.
Sub-Command Options
            -gamma

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

            -vector

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

Example

# statusIcon.tcl
#
#!/bin/sh
# the next line restarts using tclsh \
exec tclsh "$0" "$@"

package require Gnocl

gnocl::mainLoop

Comments