gimpgradients

gimpgradients — Operations related to gradients.

Synopsis




gboolean    gimp_gradients_refresh          (void);
gchar**     gimp_gradients_get_list         (const gchar *filter,
                                             gint *num_gradients);
gchar*      gimp_gradients_get_gradient     (void);
gboolean    gimp_gradients_set_gradient     (const gchar *name);
gdouble*    gimp_gradients_sample_uniform   (gint num_samples,
                                             gboolean reverse);
gdouble*    gimp_gradients_sample_custom    (gint num_samples,
                                             const gdouble *positions,
                                             gboolean reverse);
gchar*      gimp_gradients_get_gradient_data
                                            (const gchar *name,
                                             gint sample_size,
                                             gboolean reverse,
                                             gint *width,
                                             gdouble **grad_data);

Description

Operations related to gradients.

Details

gimp_gradients_refresh ()

gboolean    gimp_gradients_refresh          (void);

Refresh current gradients. This function always succeeds.

This procedure retrieves all gradients currently in the user's gradient path and updates the gradient dialogs accordingly.

Returns : TRUE on success.

gimp_gradients_get_list ()

gchar**     gimp_gradients_get_list         (const gchar *filter,
                                             gint *num_gradients);

Retrieve the list of loaded gradients.

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

filter : An optional regular expression used to filter the list.
num_gradients : The number of loaded gradients.
Returns : The list of gradient names.

gimp_gradients_get_gradient ()

gchar*      gimp_gradients_get_gradient     (void);

Warning

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

This procedure is deprecated! Use gimp_context_get_gradient() instead.

Returns : The name of the active gradient.

gimp_gradients_set_gradient ()

gboolean    gimp_gradients_set_gradient     (const gchar *name);

Warning

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

This procedure is deprecated! Use gimp_context_set_gradient() instead.

name : The name of the gradient to set.
Returns : TRUE on success.

gimp_gradients_sample_uniform ()

gdouble*    gimp_gradients_sample_uniform   (gint num_samples,
                                             gboolean reverse);

Warning

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

This procedure is deprecated! Use gimp_gradient_get_uniform_samples() instead.

num_samples : The number of samples to take.
reverse : Use the reverse gradient.
Returns : Color samples: { R1, G1, B1, A1, ..., Rn, Gn, Bn, An }.

gimp_gradients_sample_custom ()

gdouble*    gimp_gradients_sample_custom    (gint num_samples,
                                             const gdouble *positions,
                                             gboolean reverse);

Warning

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

This procedure is deprecated! Use gimp_gradient_get_custom_samples() instead.

num_samples : The number of samples to take.
positions : The list of positions to sample along the gradient.
reverse : Use the reverse gradient.
Returns : Color samples: { R1, G1, B1, A1, ..., Rn, Gn, Bn, An }.

gimp_gradients_get_gradient_data ()

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

Warning

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

This procedure is deprecated! Use gimp_gradient_get_uniform_samples() instead.

name : The gradient name (\"\" means current active gradient).
sample_size : Size of the sample to return when the gradient is changed.
reverse : Use the reverse gradient.
width : The gradient sample width (r,g,b,a).
grad_data : The gradient sample data.
Returns : The gradient name.