## GimpColorDisplay GimpColorDisplay — Pluggable GIMP display color correction modules. |

## Synopsis

                        GimpColorDisplay;
    GimpColorDisplay *  gimp_color_display_new              (GType display_type);
    GimpColorDisplay *  gimp_color_display_clone            (GimpColorDisplay *display);
    void                gimp_color_display_set_enabled      (GimpColorDisplay *display,
                                                             gboolean enabled);
    gboolean            gimp_color_display_get_enabled      (GimpColorDisplay *display);
    GimpColorConfig *   gimp_color_display_get_config       (GimpColorDisplay *display);
    GimpColorManaged *  gimp_color_display_get_managed      (GimpColorDisplay *display);
    void                gimp_color_display_convert          (GimpColorDisplay *display,
                                                             guchar *buf,
                                                             gint width,
                                                             gint height,
                                                             gint bpp,
                                                             gint bpl);
    void                gimp_color_display_convert_surface  (GimpColorDisplay *display,
                                                             cairo_surface_t *surface);
    void                gimp_color_display_load_state       (GimpColorDisplay *display,
                                                             GimpParasite *state);
    GimpParasite *      gimp_color_display_save_state       (GimpColorDisplay *display);
    GtkWidget *         gimp_color_display_configure        (GimpColorDisplay *display);
    void                gimp_color_display_configure_reset  (GimpColorDisplay *display);
    void                gimp_color_display_changed          (GimpColorDisplay *display);

## Object Hierarchy

      GObject
       +----GimpColorDisplay

## Implemented Interfaces

GimpColorDisplay implements GimpConfigInterface.

## Properties

      "color-config"             GimpColorConfig*      : Read / Write / Construct Only
      "color-managed"            GimpColorManagedInterface*  : Read / Write / Construct Only
      "enabled"                  gboolean              : Read / Write / Construct

## Signals

      "changed"                                        : Run First

## Description

Functions and definitions for creating pluggable GIMP display color correction modules.

## Details

### GimpColorDisplay

    typedef struct _GimpColorDisplay GimpColorDisplay;

### gimp_color_display_new ()

    GimpColorDisplay *  gimp_color_display_new              (GType display_type);

### Warning

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

This function is deprecated. Please use `g_object_new()` directly.

`display_type` : | the GType of the GimpColorDisplay to instantiate.
Returns : | a new `GimpColorDisplay` object.

### gimp_color_display_clone ()

    GimpColorDisplay *  gimp_color_display_clone            (GimpColorDisplay *display);

### gimp_color_display_set_enabled ()

    void                gimp_color_display_set_enabled      (GimpColorDisplay *display,
                                                             gboolean enabled);

### gimp_color_display_get_enabled ()

    gboolean            gimp_color_display_get_enabled      (GimpColorDisplay *display);

### gimp_color_display_get_config ()

    GimpColorConfig *   gimp_color_display_get_config       (GimpColorDisplay *display);

Returns : | a pointer to the GimpColorConfig object or `NULL`.

Since GIMP 2.4

### gimp_color_display_get_managed ()

    GimpColorManaged *  gimp_color_display_get_managed      (GimpColorDisplay *display);

Returns : | a pointer to the GimpColorManaged object or `NULL`.

Since GIMP 2.4

### gimp_color_display_convert ()

    void                gimp_color_display_convert          (GimpColorDisplay *display,
                                                             guchar *buf,
                                                             gint width,
                                                             gint height,
                                                             gint bpp,
                                                             gint bpl);

### Warning

`gimp_color_display_convert` is deprecated and should not be used in newly-written code. GIMP 2.8: Use `gimp_color_display_convert_surface()` instead.

Converts all pixels in `buf`.

`display` : | a GimpColorDisplay
`buf` : | the pixel buffer to convert
`width` : | the width of the buffer
`height` : | the height of the buffer
`bpp` : | the number of bytes per pixel
`bpl` : | the buffer's rowstride

### gimp_color_display_convert_surface ()

    void                gimp_color_display_convert_surface  (GimpColorDisplay *display,
                                                             cairo_surface_t *surface);

Converts all pixels in `surface`.

`display` : | a GimpColorDisplay
`surface` : | a cairo_image_surface_t of type ARGB32

Since GIMP 2.8

### gimp_color_display_load_state ()

    void                gimp_color_display_load_state       (GimpColorDisplay *display,
                                                             GimpParasite *state);

### gimp_color_display_save_state ()

    GimpParasite *      gimp_color_display_save_state       (GimpColorDisplay *display);

### gimp_color_display_configure ()

    GtkWidget *         gimp_color_display_configure        (GimpColorDisplay *display);

### gimp_color_display_configure_reset ()

    void                gimp_color_display_configure_reset  (GimpColorDisplay *display);

### gimp_color_display_changed ()

    void                gimp_color_display_changed          (GimpColorDisplay *display);

## Property Details

### The `"color-config"` property

      "color-config"             GimpColorConfig*      : Read / Write / Construct Only

### The `"color-managed"` property

      "color-managed"            GimpColorManagedInterface*  : Read / Write / Construct Only

### The `"enabled"` property

      "enabled"                  gboolean              : Read / Write / Construct

Default value: TRUE

## Signal Details

### The `"changed"` signal

    void                user_function                      (GimpColorDisplay *gimpcolordisplay,
                                                            gpointer          user_data)             : Run First

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

## See Also

GModule, GTypeModule, GimpModule