gimp_gradients_sample_custom (1997)

NAME

gimp_gradients_sample_custom - Sample the active gradient in custom positions.

SYNOPSIS

(array_length,color_samples) = gimp_gradients_sample_custom (num_samples,positions)

DESCRIPTION

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.

INPUT ARGUMENTS

TYPE	NAME	DESCRIPTION
INT32	num_samples	The number of samples to take
FLOATARRAY	positions	The list of positions to sample along the gradient

RETURN VALUES

TYPE	NAME	DESCRIPTION
INT32	array_length	Length of the color_samples array (4 * num_samples)
FLOATARRAY	color_samples	Color samples: { R1, G1, B1, A1, ..., Rn, Gn, Bn, An }

SOME SYNTAX ALTERNATIVES

color_samples = Gradients->sample_custom (positions)
color_samples = Gimp->gradients_sample_custom (positions)
color_samples = gradients_sample_custom Layer (positions)
color_samples = gradients_sample_custom Image (positions)
color_samples = gradients_sample_custom Channel (positions)
color_samples = gradients_sample_custom Display (positions)

AUTHOR

Federico Mena Quintero
(c)1997 Federico Mena Quintero