## GimpColorSelector

GimpColorSelector — Pluggable GIMP color selector modules.

## Synopsis

                        GimpColorSelector;
    #define             GIMP_COLOR_SELECTOR_SIZE
    #define             GIMP_COLOR_SELECTOR_BAR_SIZE
    enum                GimpColorSelectorChannel;
    GtkWidget *         gimp_color_selector_new             (GType selector_type,
                                                             const GimpRGB *rgb,
                                                             const GimpHSV *hsv,
                                                             GimpColorSelectorChannel channel);
    void                gimp_color_selector_set_toggles_visible
                                                            (GimpColorSelector *selector,
                                                             gboolean visible);
    void                gimp_color_selector_set_toggles_sensitive
                                                            (GimpColorSelector *selector,
                                                             gboolean sensitive);
    void                gimp_color_selector_set_show_alpha  (GimpColorSelector *selector,
                                                             gboolean show_alpha);
    void                gimp_color_selector_set_color       (GimpColorSelector *selector,
                                                             const GimpRGB *rgb,
                                                             const GimpHSV *hsv);
    void                gimp_color_selector_set_channel     (GimpColorSelector *selector,
                                                             GimpColorSelectorChannel channel);
    void                gimp_color_selector_color_changed   (GimpColorSelector *selector);
    void                gimp_color_selector_channel_changed (GimpColorSelector *selector);
    void                gimp_color_selector_set_config      (GimpColorSelector *selector,
                                                             GimpColorConfig *config);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBox
                                     +----GtkVBox
                                           +----GimpColorSelector
                                                 +----GimpColorNotebook
                                                 +----GimpColorScales
                                                 +----GimpColorSelect

## Implemented Interfaces

GimpColorSelector implements AtkImplementorIface, GtkBuildable and GtkOrientable.

## Signals

      "channel-changed"                                : Run First
      "color-changed"                                  : Run First

## Description

Functions and definitions for creating pluggable GIMP color selector modules.

## Details

### GimpColorSelector

    typedef struct _GimpColorSelector GimpColorSelector;

### GIMP_COLOR_SELECTOR_SIZE

    #define GIMP_COLOR_SELECTOR_SIZE      150

The suggested size for a color area in a GimpColorSelector implementation.

### GIMP_COLOR_SELECTOR_BAR_SIZE

    #define GIMP_COLOR_SELECTOR_BAR_SIZE  15

The suggested width for a color bar in a GimpColorSelector implementation.

### enum GimpColorSelectorChannel

    typedef enum
    {
      GIMP_COLOR_SELECTOR_HUE,        /*< desc="_H", help="Hue"        >*/
      GIMP_COLOR_SELECTOR_SATURATION, /*< desc="_S", help="Saturation" >*/
      GIMP_COLOR_SELECTOR_VALUE,      /*< desc="_V", help="Value"      >*/
      GIMP_COLOR_SELECTOR_RED,        /*< desc="_R", help="Red"        >*/
      GIMP_COLOR_SELECTOR_GREEN,      /*< desc="_G", help="Green"      >*/
      GIMP_COLOR_SELECTOR_BLUE,       /*< desc="_B", help="Blue"       >*/
      GIMP_COLOR_SELECTOR_ALPHA       /*< desc="_A", help="Alpha"      >*/
    } GimpColorSelectorChannel;

`GIMP_COLOR_SELECTOR_HUE` | the hue channel
`GIMP_COLOR_SELECTOR_SATURATION` | the saturation channel
`GIMP_COLOR_SELECTOR_VALUE` | the value channel
`GIMP_COLOR_SELECTOR_RED` | the red channel
`GIMP_COLOR_SELECTOR_GREEN` | the green channel
`GIMP_COLOR_SELECTOR_BLUE` | the blue channel
`GIMP_COLOR_SELECTOR_ALPHA` | the alpha channel

### gimp_color_selector_new ()

    GtkWidget *         gimp_color_selector_new             (GType selector_type,
                                                             const GimpRGB *rgb,
                                                             const GimpHSV *hsv,
                                                             GimpColorSelectorChannel channel);

`selector_type` : |
`rgb` : |
`hsv` : |
`channel` : |
Returns : |

### gimp_color_selector_set_toggles_visible ()

    void                gimp_color_selector_set_toggles_visible
                                                            (GimpColorSelector *selector,
                                                             gboolean visible);

`selector` : |
`visible` : |

### gimp_color_selector_set_toggles_sensitive ()

    void                gimp_color_selector_set_toggles_sensitive
                                                            (GimpColorSelector *selector,
                                                             gboolean sensitive);

`selector` : |
`sensitive` : |

### gimp_color_selector_set_show_alpha ()

    void                gimp_color_selector_set_show_alpha  (GimpColorSelector *selector,
                                                             gboolean show_alpha);

`selector` : |
`show_alpha` : |

### gimp_color_selector_set_color ()

    void                gimp_color_selector_set_color       (GimpColorSelector *selector,
                                                             const GimpRGB *rgb,
                                                             const GimpHSV *hsv);

`selector` : |
`rgb` : |
`hsv` : |

### gimp_color_selector_set_channel ()

    void                gimp_color_selector_set_channel     (GimpColorSelector *selector,
                                                             GimpColorSelectorChannel channel);

`selector` : |
`channel` : |

### gimp_color_selector_color_changed ()

    void                gimp_color_selector_color_changed   (GimpColorSelector *selector);

`selector` : |

### gimp_color_selector_channel_changed ()

    void                gimp_color_selector_channel_changed (GimpColorSelector *selector);

`selector` : |

### gimp_color_selector_set_config ()

    void                gimp_color_selector_set_config      (GimpColorSelector *selector,
                                                             GimpColorConfig *config);

Sets the color management configuration to use with this color selector.

Since GIMP 2.4

## Signal Details

### The `"channel-changed"` signal

    void                user_function                      (GimpColorSelector *gimpcolorselector,
                                                            gint               arg1,
                                                            gpointer           user_data)              : Run First

`gimpcolorselector` : | the object which received the signal.
`arg1` : |
`user_data` : | user data set when the signal handler was connected.

### The `"color-changed"` signal

    void                user_function                      (GimpColorSelector *gimpcolorselector,
                                                            gpointer           arg1,
                                                            gpointer           arg2,
                                                            gpointer           user_data)              : Run First

`gimpcolorselector` : | the object which received the signal.
`arg1` : |
`arg2` : |
`user_data` : | user data set when the signal handler was connected.

## See Also

GModule

GTypeModule

libgimp-gimpmodule