Gnome User Interface Library Reference Manual | |||
---|---|---|---|
<<< Previous Page | Home | Up | Next Page >>> |
#include <gnome.h> struct GnomeColorPicker; GtkWidget* gnome_color_picker_new (void); void gnome_color_picker_set_d (GnomeColorPicker *cp, gdouble r, gdouble g, gdouble b, gdouble a); void gnome_color_picker_get_d (GnomeColorPicker *cp, gdouble *r, gdouble *g, gdouble *b, gdouble *a); void gnome_color_picker_set_i8 (GnomeColorPicker *cp, guint8 r, guint8 g, guint8 b, guint8 a); void gnome_color_picker_get_i8 (GnomeColorPicker *cp, guint8 *r, guint8 *g, guint8 *b, guint8 *a); void gnome_color_picker_set_i16 (GnomeColorPicker *cp, gushort r, gushort g, gushort b, gushort a); void gnome_color_picker_get_i16 (GnomeColorPicker *cp, gushort *r, gushort *g, gushort *b, gushort *a); void gnome_color_picker_set_dither (GnomeColorPicker *cp, gboolean dither); void gnome_color_picker_set_use_alpha (GnomeColorPicker *cp, gboolean use_alpha); void gnome_color_picker_set_title (GnomeColorPicker *cp, const gchar *title); |
GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkButton +----GnomeColorPicker |
"color-set" void user_function (GnomeColorPicker *colorpicker, guint arg1, guint arg2, guint arg3, guint arg4, gpointer user_data); |
This widget provides color selection facilities to your application. The widget appears as a button which contains a "color swatch" of the currently selected color. When the button is pressed, the widget presents the user with a color selection dialog where the color can be selected.
You can select the color to be displayed in a number of ways: floating point values for the red, green and blue channels, integers in the range 0 to 65,535, or integers in the range 0 to 255, depending on your needs.
void color_picked_callback(GtkWidget *w, guint r, guint g, guint b, guint a) { g_print("User selected color (rgba): d d d d\n", r, g, b, a); /* save colors to configuration file, or use them some other way */ } ... GtkWidget *cp; /* create a color picker, set a default color */ cp = gnome_color_picker_new(); gnome_color_picker_set_i8(GNOME_COLOR_PICKER(cp), 255, 0, 0, 0); /* connect a function to our widget */ gtk_signal_connect(GTK_OBJECT(cp), "color_set", GTK_SIGNAL_FUNC(color_picked_callback), NULL); ... /* retrieve color from our widget, someplace else in code */ gdouble r, g, b, a; gnome_color_picker_get_d(GNOME_COLOR_PICKER(cp), &r, &g, &b, &a); g_print("Color (rgba): %g %g %g %g\n", r, g, b, a); |
GtkWidget* gnome_color_picker_new (void); |
Creates a new GNOME color picker widget. This returns a widget in the form of a small button containing a swatch representing the current selected color. When the button is clicked, a color-selection dialog will open, allowing the user to select a color. The swatch will be updated to reflect the new color when the user finishes.
Returns : | Pointer to new GNOME color picker widget. |
void gnome_color_picker_set_d (GnomeColorPicker *cp, gdouble r, gdouble g, gdouble b, gdouble a); |
Set color shown in the color picker widget using floating point values.
cp : | Pointer to GNOME color picker widget. |
r : | Red color component, values are in [0.0, 1.0] |
g : | Green color component, values are in [0.0, 1.0] |
b : | Blue color component, values are in [0.0, 1.0] |
a : | Alpha component, values are in [0.0, 1.0] |
void gnome_color_picker_get_d (GnomeColorPicker *cp, gdouble *r, gdouble *g, gdouble *b, gdouble *a); |
Retrieve color currently selected in the color picker widget in the form of floating point values.
cp : | Pointer to GNOME color picker widget. |
r : | Output location of red color component, values are in [0.0, 1.0] |
g : | Output location of green color component, values are in [0.0, 1.0] |
b : | Output location of blue color component, values are in [0.0, 1.0] |
a : | Output location of alpha color component, values are in [0.0, 1.0] |
void gnome_color_picker_set_i8 (GnomeColorPicker *cp, guint8 r, guint8 g, guint8 b, guint8 a); |
Set color shown in the color picker widget using 8-bit integer values.
cp : | Pointer to GNOME color picker widget. |
r : | Red color component, values are in [0, 255] |
g : | Green color component, values are in [0, 255] |
b : | Blue color component, values are in [0, 255] |
a : | Alpha component, values are in [0, 255] |
void gnome_color_picker_get_i8 (GnomeColorPicker *cp, guint8 *r, guint8 *g, guint8 *b, guint8 *a); |
Retrieve color currently selected in the color picker widget in the form of 8-bit integer values.
cp : | Pointer to GNOME color picker widget. |
r : | Output location of red color component, values are in [0, 255] |
g : | Output location of green color component, values are in [0, 255] |
b : | Output location of blue color component, values are in [0, 255] |
a : | Output location of alpha color component, values are in [0, 255] |
void gnome_color_picker_set_i16 (GnomeColorPicker *cp, gushort r, gushort g, gushort b, gushort a); |
Set color shown in the color picker widget using 16-bit integer values.
cp : | Pointer to GNOME color picker widget. |
r : | Red color component, values are in [0, 65535] |
g : | Green color component, values are in [0, 65535] |
b : | Blue color component, values are in [0, 65535] |
a : | Alpha component, values are in [0, 65535] |
void gnome_color_picker_get_i16 (GnomeColorPicker *cp, gushort *r, gushort *g, gushort *b, gushort *a); |
Retrieve color currently selected in the color picker widget in the form of 16-bit integer values.
cp : | Pointer to GNOME color picker widget. |
r : | Output location of red color component, values are in [0, 65535] |
g : | Output location of green color component, values are in [0, 65535] |
b : | Output location of blue color component, values are in [0, 65535] |
a : | Output location of alpha color component, values are in [0, 65535] |
void gnome_color_picker_set_dither (GnomeColorPicker *cp, gboolean dither); |
Sets whether the picker should dither the color sample or just paint a solid rectangle.
cp : | Pointer to GNOME color picker widget. |
dither : | TRUE if color sample should be dithered, FALSE if not. |
void gnome_color_picker_set_use_alpha (GnomeColorPicker *cp, gboolean use_alpha); |
Sets whether or not the picker should use the alpha channel.
cp : | Pointer to GNOME color picker widget. |
use_alpha : | TRUE if color sample should use alpha channel, FALSE if not. |
void gnome_color_picker_set_title (GnomeColorPicker *cp, const gchar *title); |
Sets the title for the color selection dialog.
cp : | Pointer to GNOME color picker widget. |
title : | String containing new window title. |
void user_function (GnomeColorPicker *colorpicker, guint arg1, guint arg2, guint arg3, guint arg4, gpointer user_data); |
This signal is emitted when the user changes the color on the color selector. The values passed to this signal are the red, green, blue and alpha channels selected in integer form in the range 0 to 65535.
colorpicker : | The object which received the signal. |
arg1 : | Red color component, values are in [0, 65535] |
arg2 : | Green color component, values are in [0, 65535] |
arg3 : | Blue color component, values are in [0, 65535] |
arg4 : | Alpha component, values are in [0, 65535] |
user_data : | User data set when the signal handler was connected. |
user_data : | user data set when the signal handler was connected. |
Returns : |