plug_in_sample_colorize (02/2000)

NAME

plug_in_sample_colorize - Colorize the contents of the specified drawable similar to sample drawable

SYNOPSIS

plug_in_sample_colorize (run_mode,image,dst_drawable,sample_drawable,hold_inten,orig_inten,rnd_subcolors,guess_missing,in_low,in_high,gamma,out_low,out_high)

DESCRIPTION

This plug-in colorizes the contents of the specified (gray) layer with the help of a sample (color) layer. It analyzes all colors in the sample layer. The sample colors are sorted by brightness (== intentisty) and amount and stored in a sample colortable (where brightness is the index) The pixels of the destination layer are remapped with the help of the sample colortable. If use_subcolors is TRUE, the remapping process uses all sample colors of the corresponding brightness-intensity and distributes the subcolors according to their amount in the sample (If the sample has 5 green, 3 yellow, and 1 red pixel of the intensity value 105, the destination pixels at intensity value 105 are randomly painted in green, yellow and red in a relation of 5:3:1 If use_subcolors is FALSE only one sample color per intensity is used. (green will be used in this example) The brightness intensity value is transformed at the remapping process according to the levels: out_lo, out_hi, in_lo, in_high and gamma The in_low / in_high levels specify an initial mapping of the intensity. The gamma value determines how intensities are interpolated between the in_lo and in_high levels. A gamma value of 1.0 results in linear interpolation. Higher gamma values results in more high-level intensities Lower gamma values results in more low-level intensities The out_low/out_high levels constrain the resulting intensity index The intensity index is used to pick the corresponding color in the sample colortable. If hold_inten is FALSE the picked color is used 1:1 as resulting remap_color. If hold_inten is TRUE The brightness of the picked color is adjusted back to the origial intensity value (only hue and saturation are taken from the picked sample color) (or to the input level, if orig_inten is set FALSE) Works on both Grayscale and RGB image with/without alpha channel. (the image with the dst_drawable is converted to RGB if necessary) The sample_drawable should be of type RGB or RGBA

MENUPATH

<Image>/Filters/Colors/Map/Sample Colorize...

IMAGETYPES

RGB*, GRAY*

INPUT ARGUMENTS

TYPE	NAME	DESCRIPTION
INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	dst_drawable	The drawable to be colorized (Type GRAY* or RGB*)
DRAWABLE	sample_drawable	Sample drawable (should be of Type RGB or RGBA)
INT32	hold_inten	hold brightness intensity levels (TRUE, FALSE)
INT32	orig_inten	TRUE: hold brightness of original intensity levels. FALSE: Hold Intensity of input levels
INT32	rnd_subcolors	TRUE: Use all subcolors of same intensity, FALSE: use only one color per intensity
INT32	guess_missing	TRUE: guess samplecolors for the missing intensity values FALSE: use only colors found in the sample
INT32	in_low	intensity of lowest input (0 <= in_low <= 254)
INT32	in_high	intensity of highest input (1 <= in_high <= 255)
FLOAT	gamma	gamma correction factor (0.1 <= gamma <= 10) where 1.0 is linear
INT32	out_low	lowest sample color intensity (0 <= out_low <= 254)
INT32	out_high	highest sample color intensity (1 <= out_high <= 255)

SOME SYNTAX ALTERNATIVES

$drawable->sample_colorize (sample_drawable,hold_inten,orig_inten,rnd_subcolors,guess_missing,in_low,in_high,gamma,out_low,out_high)
$image->sample_colorize (dst_drawable,sample_drawable,hold_inten,orig_inten,rnd_subcolors,guess_missing,in_low,in_high,gamma,out_low,out_high)
plug_in_sample_colorize (dst_drawable,sample_drawable,hold_inten,orig_inten,rnd_subcolors,guess_missing,in_low,in_high,gamma,out_low,out_high)
sample_colorize Layer (dst_drawable,sample_drawable,hold_inten,orig_inten,rnd_subcolors,guess_missing,in_low,in_high,gamma,out_low,out_high)
sample_colorize Image (dst_drawable,sample_drawable,hold_inten,orig_inten,rnd_subcolors,guess_missing,in_low,in_high,gamma,out_low,out_high)
sample_colorize Plugin (dst_drawable,sample_drawable,hold_inten,orig_inten,rnd_subcolors,guess_missing,in_low,in_high,gamma,out_low,out_high)

INSTALLATION PATH

/opt/lib/gimp/1.2/plug-ins/sample_colorize

AUTHOR

Wolfgang Hofer
(c)02/2000 hof@hotbot.com