gimpgradients

gimp_gradients_get_list ()

gchar**     gimp_gradients_get_list         (gint *num_gradients);

Retrieve the list of loaded gradients.

This procedure returns a list of the gradients that are currently loaded in the gradient editor. You can later use the gimp_gradients_set_active function to set the active gradient.

gimp_gradients_get_active ()

gchar*      gimp_gradients_get_active       (void);

Retrieve the name of the active gradient.

This procedure returns the name of the active gradient in the gradient editor.

gimp_gradients_set_active ()

gboolean    gimp_gradients_set_active       (gchar *name);

Sets the specified gradient as the active gradient.

This procedure lets you set the specified gradient as the active or \"current\" one. The name is simply a string which corresponds to one of the loaded gradients in the gradient editor. If no matching gradient is found, this procedure will return an error. Otherwise, the specified gradient will become active and will be used for subsequent custom gradient operations.

gimp_gradients_sample_uniform ()

gdouble*    gimp_gradients_sample_uniform   (gint num_samples);

Sample the active gradient in uniform parts.

This procedure samples the active gradient from the gradient editor in the specified number of uniform parts. It returns a list of floating-point values which correspond to the RGBA values for each sample. The minimum number of samples to take is 2, in which case the returned colors will correspond to the { 0.0, 1.0 } positions in the gradient. For example, if the number of samples is 3, the procedure will return the colors at positions { 0.0, 0.5, 1.0 }.

gimp_gradients_sample_custom ()

gdouble*    gimp_gradients_sample_custom    (gint num_samples,
                                             gdouble *positions);

Sample the active gradient in custom positions.

This procedure samples the active gradient from the gradient editor in the specified number of points. The procedure will sample the gradient in the specified positions from the list. The left endpoint of the gradient corresponds to position 0.0, and the right endpoint corresponds to 1.0. The procedure returns a list of floating-point values which correspond to the RGBA values for each sample.

gimp_gradients_get_gradient_data ()

gchar*      gimp_gradients_get_gradient_data
                                            (gchar *name,
                                             gint *width,
                                             gint sample_size,
                                             gdouble **grad_data);

gimp_gradients_popup ()

gboolean    gimp_gradients_popup            (gchar *gradients_callback,
                                             gchar *popup_title,
                                             gchar *initial_gradient,
                                             gint sample_size);

Invokes the Gimp gradients selection.

This procedure popups the gradients selection dialog.

gimp_gradients_close_popup ()

gboolean    gimp_gradients_close_popup      (gchar *gradients_callback);

Popdown the Gimp gradient selection.

This procedure closes an opened gradient selection dialog.

gimp_gradients_set_popup ()

gboolean    gimp_gradients_set_popup        (gchar *gradients_callback,
                                             gchar *gradient_name);

Sets the current gradient selection in a popup.

Sets the current gradient selection in a popup.