GIMP Library Reference Manual | |||
---|---|---|---|
<<< Previous Page | Home | Up | Next Page >>> |
gimpgradients
Synopsis
|
Details
gimp_gradients_get_list ()
|
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 ()
|
Retrieve the name of the active gradient.
This procedure returns the name of the active gradient in the gradient editor.
gimp_gradients_set_active ()
|
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 ()
|
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 ()
|
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 ()
|
gimp_gradients_popup ()
|
Invokes the Gimp gradients selection.
This procedure popups the gradients selection dialog.
gradients_callback : | The callback PDB proc to call when gradient selection is made. |
popup_title : | Title to give the gradient popup window. |
initial_gradient : | The name of the pattern to set as the first selected. |
sample_size : | Size of the sample to return when the gradient is changed. |
Returns : | TRUE on success. |
gimp_gradients_close_popup ()
|
Popdown the Gimp gradient selection.
This procedure closes an opened gradient selection dialog.