plug_in_warp (1997)

NAME

plug_in_warp - Twist or smear an image. (only first six arguments are required)

SYNOPSIS

plug_in_warp (run_mode,image,drawable,amount,warp_map,iter,dither,angle,wrap_type,mag_map,mag_use,substeps,grad_map,grad_scale,vector_map,vector_scale,vector_angle)

DESCRIPTION

Smears an image along vector paths calculated as the gradient of a separate control matrix. The effect can look like brushstrokes of acrylic or watercolor paint, in some cases.

MENUPATH

<Image>/Filters/Map/Warp...

IMAGETYPES

RGB*, GRAY*

INPUT ARGUMENTS

TYPE	NAME	DESCRIPTION
INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable
FLOAT	amount	Pixel displacement multiplier
DRAWABLE	warp_map	Displacement control map
INT32	iter	Iteration count (last required argument)
FLOAT	dither	Random dither amount (first optional argument)
FLOAT	angle	Angle of gradient vector rotation
INT32	wrap_type	Edge behavior: { WRAP (0), SMEAR (1), BLACK (2), COLOR (3) }
DRAWABLE	mag_map	Magnitude control map
INT32	mag_use	Use magnitude map: { FALSE (0), TRUE (1) }
INT32	substeps	Substeps between image updates
INT32	grad_map	Gradient control map
FLOAT	grad_scale	Scaling factor for gradient map (0=don't use)
INT32	vector_map	Fixed vector control map
FLOAT	vector_scale	Scaling factor for fixed vector map (0=don't use)
FLOAT	vector_angle	Angle for fixed vector map

SOME SYNTAX ALTERNATIVES

$drawable->warp (amount,warp_map,iter,dither,angle,wrap_type,mag_map,mag_use,substeps,grad_map,grad_scale,vector_map,vector_scale,vector_angle)
$image->warp (drawable,amount,warp_map,iter,dither,angle,wrap_type,mag_map,mag_use,substeps,grad_map,grad_scale,vector_map,vector_scale,vector_angle)
plug_in_warp (drawable,amount,warp_map,iter,dither,angle,wrap_type,mag_map,mag_use,substeps,grad_map,grad_scale,vector_map,vector_scale,vector_angle)
warp Layer (drawable,amount,warp_map,iter,dither,angle,wrap_type,mag_map,mag_use,substeps,grad_map,grad_scale,vector_map,vector_scale,vector_angle)
warp Image (drawable,amount,warp_map,iter,dither,angle,wrap_type,mag_map,mag_use,substeps,grad_map,grad_scale,vector_map,vector_scale,vector_angle)
warp Plugin (drawable,amount,warp_map,iter,dither,angle,wrap_type,mag_map,mag_use,substeps,grad_map,grad_scale,vector_map,vector_scale,vector_angle)

INSTALLATION PATH

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

AUTHOR

John P. Beale
(c)1997 John P. Beale