gimp_palette_new ()

gchar*      gimp_palette_new                (const gchar *name);

Creates a new palette

This procedure creates a new, uninitialized palette

Since GIMP 2.2

gimp_palette_duplicate ()

gchar*      gimp_palette_duplicate          (const gchar *name);

Duplicates a palette

This procedure creates an identical palette by a different name

Since GIMP 2.2

gimp_palette_rename ()

gchar*      gimp_palette_rename             (const gchar *name,
                                             const gchar *new_name);

Rename a palette

This procedure renames a palette

Since GIMP 2.2

gimp_palette_delete ()

gboolean    gimp_palette_delete             (const gchar *name);

Deletes a palette

This procedure deletes a palette

Since GIMP 2.2

gimp_palette_get_info ()

gboolean    gimp_palette_get_info           (const gchar *name,
                                             gint *num_colors);

Retrieve information about the specified palette.

This procedure retrieves information about the specified palette. This includes the name, and the number of colors.

Since GIMP 2.2

gimp_palette_add_entry ()

gboolean    gimp_palette_add_entry          (const gchar *name,
                                             const gchar *entry_name,
                                             const GimpRGB *color,
                                             gint *entry_num);

Adds a palette entry to the specified palette.

This procedure adds an entry to the specifed palette. It returns an error if the entry palette does not exist.

Since GIMP 2.2

gimp_palette_delete_entry ()

gboolean    gimp_palette_delete_entry       (const gchar *name,
                                             gint entry_num);

Deletes a palette entry from the specified palette.

This procedure deletes an entry from the specifed palette. It returns an error if the entry palette does not exist.

Since GIMP 2.2

gimp_palette_entry_get_color ()

gboolean    gimp_palette_entry_get_color    (const gchar *name,
                                             gint entry_num,
                                             GimpRGB *color);

Gets the specified palette entry from the specified palette.

This procedure retrieves the color of the zero-based entry specifed for the specified palette. It returns an error if the entry does not exist.

Since GIMP 2.2

gimp_palette_entry_set_color ()

gboolean    gimp_palette_entry_set_color    (const gchar *name,
                                             gint entry_num,
                                             const GimpRGB *color);

Sets the specified palette entry in the specified palette.

This procedure sets the color of the zero-based entry specifed for the specified palette. It returns an error if the entry does not exist.

Since GIMP 2.2

gimp_palette_entry_get_name ()

gboolean    gimp_palette_entry_get_name     (const gchar *name,
                                             gint entry_num,
                                             gchar **entry_name);

Gets the specified palette entry from the specified palette.

This procedure retrieves the name of the zero-based entry specifed for the specified palette. It returns an error if the entry does not exist.

Since GIMP 2.2

gimp_palette_entry_set_name ()

gboolean    gimp_palette_entry_set_name     (const gchar *name,
                                             gint entry_num,
                                             const gchar *entry_name);

Sets the specified palette entry in the specified palette.

This procedure sets the name of the zero-based entry specifed for the specified palette. It returns an error if the entry does not exist.

Since GIMP 2.2

gimp_palette_get_foreground ()

gboolean    gimp_palette_get_foreground     (GimpRGB *foreground);

Get the current GIMP foreground color.

This procedure retrieves the current GIMP foreground color. The foreground color is used in a variety of tools such as paint tools, blending, and bucket fill.

gimp_palette_get_background ()

gboolean    gimp_palette_get_background     (GimpRGB *background);

Get the current GIMP background color.

This procedure retrieves the current GIMP background color. The background color is used in a variety of tools such as blending, erasing (with non-alpha images), and image filling.

gimp_palette_set_foreground ()

gboolean    gimp_palette_set_foreground     (const GimpRGB *foreground);

Set the current GIMP foreground color.

This procedure sets the current GIMP foreground color. After this is set, operations which use foreground such as paint tools, blending, and bucket fill will use the new value.

gimp_palette_set_background ()

gboolean    gimp_palette_set_background     (const GimpRGB *background);

Set the current GIMP background color.

This procedure sets the current GIMP background color. After this is set, operations which use background such as blending, filling images, clearing, and erasing (in non-alpha images) will use the new value.

gimp_palette_set_default_colors ()

gboolean    gimp_palette_set_default_colors (void);

Set the current GIMP foreground and background colors to black and white.

This procedure sets the current GIMP foreground and background colors to their initial default values, black and white.

gimp_palette_swap_colors ()

gboolean    gimp_palette_swap_colors        (void);

Swap the current GIMP foreground and background colors.

This procedure swaps the current GIMP foreground and background colors, so that the new foreground color becomes the old background color and vice versa.