See also: Main Index; Alphabetic; Misc; By Author; By Module; By Menu External Links: The Gimp; Gimp User Manual

The Gimp plug_in functions

plug_in_LoG	Apply the LoG filter
plug_in_ace	Adaptive Contrast Enhancement
plug_in_alienmap2	AlienMap2 Color Transformation Plug-In
plug_in_align_layers	Align visible layers
plug_in_anamorphose	Apply an anamorphose effect
plug_in_animationoptimize	This procedure applies various optimizations to a GIMP layer-based animation in an attempt to reduce the final file size. If a frame of the animation can use the 'combine' mode, this procedure attempts to maximize the number of ajdacent pixels having the same color, which improves the compression for some image formats such as GIF or MNG.
plug_in_animationoptimize_diff	This procedure applies various optimizations to a GIMP layer-based animation in an attempt to reduce the final file size. If a frame of the animation can use the 'combine' mode, this procedure uses a simple difference between the frames.
plug_in_animationplay	This plugin allows you to preview a GIMP layer-based animation.
plug_in_animationunoptimize	This procedure 'simplifies' a GIMP layer-based animation that has been AnimationOptimized. This makes the animation much easier to work with if, for example, the optimized version is all you have.
plug_in_antialias	Smooths stair-step edges.
plug_in_apply_canvas	Adds a canvas texture map to the picture
plug_in_applylens	Apply a lens effect
plug_in_autocrop	Automagically crops an image.
plug_in_autocrop_layer	Automagically crops a layer.
plug_in_autostretch_hsv	Automatically stretch the contrast of the specified drawable to cover all possible ranges.
plug_in_blinds	Adds a blinds effect to the image. Rather like putting the image on a set of window blinds and the closing or opening the blinds
plug_in_blur	Apply a 3x3 blurring convolution kernel to the specified drawable.
plug_in_borderaverage	Borderaverage
plug_in_bump_map	Create an embossing effect using an image as a bump map
plug_in_bump_map_tiled	Create an embossing effect using a tiled image as a bump map
plug_in_c_astretch	Automatically stretch the contrast of the specified drawable to cover all possible ranges.
plug_in_cartoon	Propagates dark values in an image to achieve cartoon rendering
plug_in_ccanalyze	Colorcube analysis
plug_in_checkerboard	Adds a checkerboard pattern to an image
plug_in_clipboard_copy	copy image to clipboard
plug_in_clipboard_paste	paste image from clipboard
plug_in_clipboard_paste_as_new	Get image from clipboard
plug_in_cml_explorer	Make an image of Coupled-Map Lattice
plug_in_color_adjust	Adjust color range given by foreground/background color to black/white
plug_in_color_enhance	Automatically stretch the saturation of the specified drawable to cover all possible ranges.
plug_in_color_map	Map color range specified by two colorsto color range specified by two other color.
plug_in_colorify	Similar to the "Color" mode for layers.
plug_in_colors_channel_mixer	Mix RGB Channels.
plug_in_colortoalpha	Convert the color in an image to alpha
plug_in_compose	Compose an image from multiple gray images
plug_in_convmatrix	A generic 5x5 convolution matrix
plug_in_cubism	Convert the input drawable into a collection of rotated squares
plug_in_curve_bend	Bends a layer using 2 spline-curves
plug_in_curve_bend_Iterator	This procedure calculates the modified values for one iterationstep for the call of plug_in_curve_bend
plug_in_db_browser	List available procedures in the PDB
plug_in_decompose	Decompose an image into different types of channels
plug_in_deinterlace	Deinterlace
plug_in_depth_merge	Combine two images using corresponding depth maps (z-buffers)
plug_in_despeckle	Despeckle filter, typically used to 'despeckle' a photographic image.
plug_in_destripe	Destripe filter, used to remove vertical stripes caused by cheap scanners.
plug_in_diffraction	Generate diffraction patterns
plug_in_dilate	Dilate image
plug_in_displace	Displace the contents of the specified drawable
plug_in_dog	Edge detection using difference of Gaussians.
plug_in_drawable_compose	Compose an image from multiple drawables of gray images
plug_in_edge	Perform edge detection on the contents of the specified drawable
plug_in_emboss	Emboss filter
plug_in_engrave	Engrave the contents of the specified drawable
plug_in_erode	Erode image
plug_in_exchange	Color Exchange
plug_in_film	Compose several images to a roll film
plug_in_filter_pack	Allows the user to change H, S, or C with many previews
plug_in_flame	Creates cosmic recursive fractal flames
plug_in_flarefx	Add lens flare effects
plug_in_fractal_trace	transform image with the Mandelbrot Fractal
plug_in_fractalexplorer	Chaos Fractal Explorer Plug-In
plug_in_gauss	Applies a gaussian blur to the specified drawable.
plug_in_gauss_iir	Applies a gaussian blur to the specified drawable.
plug_in_gauss_iir2	Applies a gaussian blur to the specified drawable.
plug_in_gauss_rle	Applies a gaussian blur to the specified drawable.
plug_in_gauss_rle2	Applies a gaussian blur to the specified drawable.
plug_in_gfig	Create Geometrical shapes with the Gimp
plug_in_gflare	Produce lense flare effect using custom gradients
plug_in_gimpressionist	Performs various artistic operations on an image
plug_in_glasstile	Divide the image into square glassblocks
plug_in_gradmap	Map the contents of the specified drawable with active gradient
plug_in_grid	Draws a grid.
plug_in_guillotine	Slice up the image into subimages, cutting along the image's Guides. Fooey to you and your broccoli, Pokey.
plug_in_hot	Look for hot NTSC or PAL pixels
plug_in_hsv_noise	Scattering pixel values in HSV space
plug_in_ifs_compose	Create an Iterated Function System (IFS) Fractal
plug_in_illusion	produce illusion
plug_in_imagemap	Creates a clickable imagemap.
plug_in_iwarp	Interactive warping of the specified drawable
plug_in_jigsaw	Renders a jigsaw puzzle look
plug_in_kaleidoscope	Simulate looking at an image thru a kaleidoscope
plug_in_laplace	Edge Detection with Laplace Operation
plug_in_lic	Creates a Van Gogh effect (Line Integral Convolution)
plug_in_lighting	Apply various lighting effects to an image
plug_in_make_seamless	Seamless tile creation
plug_in_map_object	Maps a picture to a object (plane, sphere, box or cylinder)
plug_in_math_merge	merges two images mathematically
plug_in_max_rgb	Return an image in which each pixel holds only the channel that has the maximum value in three (red, green, blue) channels, and other channels are zero-cleared
plug_in_maze	Draws a maze.
plug_in_mblur	Motion blur of image
plug_in_metadata_decode_xmp	Decode an XMP packet
plug_in_metadata_editor	View and edit metadata (EXIF, IPTC, XMP)
plug_in_metadata_encode_xmp	Encode metadata into an XMP packet
plug_in_metadata_export	Export XMP from the current image to a file
plug_in_metadata_get	Retrieve the values of an XMP property
plug_in_metadata_get_simple	Retrieve the value of an XMP property
plug_in_metadata_import	Import XMP from a file into the current image
plug_in_metadata_set	Set the values of an XMP property
plug_in_metadata_set_simple	Set the value of an XMP property
plug_in_mosaic	Convert the input drawable into a collection of tiles
plug_in_neon	Resolution independent edge detection
plug_in_newsprint	Re-sample the image to give a newspaper-like effect
plug_in_nlfilt	Nonlinear swiss army knife filter
plug_in_noisify	Adds random noise to image channels
plug_in_normalize	Normalize the contrast of the specified drawable to cover all possible ranges.
plug_in_nova	Produce Supernova effect to the specified drawable
plug_in_oilify	Modify the specified drawable to resemble an oil painting
plug_in_pagecurl	Pagecurl effect
plug_in_palettemap	Map the contents of the specified drawable with the active palette
plug_in_papertile	Cuts an image into paper tiles, and slides each paper tile.
plug_in_photocopy	Propagates dark values and white regions in an image to achieve photocopy effect
plug_in_pixelize	Pixelize the contents of the specified drawable
plug_in_pixelize2	Pixelize the contents of the specified drawable
plug_in_plasma	Create a plasma cloud like image on the specified drawable
plug_in_plug_in_details	Displays plugin details
plug_in_polar_coords	Converts and image to and from polar coords
plug_in_qbist	Create images based on a random genetic formula
plug_in_randomize_hurl	Add a random factor to the image by hurling random data at it.
plug_in_randomize_pick	Add a random factor to the image by picking a random adjacent pixel.
plug_in_randomize_slur	Add a random factor to the image by slurring (similar to melting).
plug_in_recompose	Recompose a layer from multiple drawables of gray images
plug_in_retinex	Retinex Image Enhancement Algorithm
plug_in_rgb	RGB Transformation Plug-In
plug_in_rgb_noise	Adds random noise to image channels
plug_in_ripple	Ripple the contents of the specified drawable
plug_in_rotate	Rotates a layer or the whole image by 90, 180 or 270 degrees
plug_in_rotate_colormap	Colormap rotation as in xv
plug_in_sample_colorize	Colorize the contents of the specified drawable similar to sample drawable
plug_in_scatter_hsv	Scattering pixel values in HSV space
plug_in_screenshot	Take a screenshot
plug_in_script_fu_console	Provides a console mode for script-fu development
plug_in_script_fu_eval	Evaluate scheme code
plug_in_script_fu_server	Provides a server for remote script-fu operation
plug_in_script_fu_text_console	Provides a text console mode for script-fu development
plug_in_sel2path	Converts a selection to a path
plug_in_sel2path_advanced	Converts a selection to a path (with advanced user menu)
plug_in_sel_gauss	Applies a selective gaussian blur to the specified drawable.
plug_in_semiflatten	Flatten pixels in an RGBA image that aren't completely transparent against the current GIMP background color
plug_in_sharpen	Sharpen filter, typically used to 'sharpen' a photographic image.
plug_in_shift	Shift the contents of the specified drawable
plug_in_sinus	Generates a texture with sinus functions
plug_in_small_tiles	Tiles image into smaller versions of the orginal
plug_in_smooth_palette	derive smooth palette from image
plug_in_sobel	Edge Detection with Sobel Operation
plug_in_softglow	Photographic 'softglow' effect by intensifying the highlights
plug_in_solid_noise	Creates a grayscale noise texture
plug_in_sparkle	Simulates pixel bloom and diffraction effects
plug_in_spheredesigner	Renders textures spheres
plug_in_spread	Spread the contents of the specified drawable
plug_in_the_old_egg	A big hello from the GIMP team!
plug_in_the_slimy_egg	A big hello from the GIMP team!
plug_in_threshold_alpha
plug_in_tile	Create a new image which is a tiled version of the input drawable
plug_in_unit_editor	The GIMP unit editor (runs in interactive mode only)
plug_in_unsharp_mask	An unsharp mask filter
plug_in_video	Apply low-dotpitch RGB simulation to the specified drawable
plug_in_vinvert	Invert the 'value' component of an indexed/RGB image in HSV colorspace
plug_in_vpropagate	Propagate values of the layer
plug_in_warp	Twist or smear an image. (only first six arguments are required)
plug_in_waves	Distort the image with waves
plug_in_web_browser	Open an URL in the user specified web browser
plug_in_whirl_pinch	Distort an image by whirling and pinching
plug_in_wind	Renders a wind effect.
plug_in_winsnap	Capture a Win32 window or desktop image
plug_in_zealouscrop	Automagically crops unused space from the edges and middle of a picture.

plug_in_LoG

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
INT32	pa	Selected pa (0..10)
SUCCESS	sigma	Standard deviation
INT32	type	0: Standard LoG, 1: LoG with Roberts, 2: LoG with Sobel

Returns: nothing
blurb repeated: Apply the LoG filter
Alessandro Baldoni; 1998

plug_in_ace

Input:

INT32	run_mode	Interactive=0x0, Noninteractive=0x1
IMAGE	image_id	(unused)
DRAWABLE	drawable_id	Drawable to affect
INT32	ace_argc	ace argument count
STRINGARRAY	ace_argv	ace argument vector

Returns: nothing
FIXME: Write ACE help.
Alex Stark, Kevin Turner,; 1998

plug_in_alienmap2

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
SUCCESS	redfrequency	Red/hue component frequency factor
SUCCESS	redangle	Red/hue component angle factor (0-360)
SUCCESS	greenfrequency	Green/saturation component frequency factor
SUCCESS	greenangle	Green/saturation component angle factor (0-360)
SUCCESS	bluefrequency	Blue/luminance component frequency factor
SUCCESS	blueangle	Blue/luminance component angle factor (0-360)
PASS_THROUGH	colormodel	Color model (0: RGB_MODEL, 1: HSL_MODEL)
PASS_THROUGH	redmode	Red/hue application mode (TRUE, FALSE)
PASS_THROUGH	greenmode	Green/saturation application mode (TRUE, FALSE)
PASS_THROUGH	bluemode	Blue/luminance application mode (TRUE, FALSE)

Returns: nothing
No help yet. Just try it and you'll see!
Martin Weber (martweb@gmx.net; 24th April 1998

plug_in_anamorphose

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable
SUCCESS	cone_radius	Radius of the reflecting cone in the center
SUCCESS	base_angle	Base angle of the reflecting cone (in degrees)
INT32	keep_surroundings	Keep anamorphose surroundings
INT32	set_background	Set anamorphose surroundings to bkgr value
INT32	set_transparent	Set anamorphose surroundings transparent (Only on Image w/ Alpha-Layer)
INT32	use_antialias	Use antialias for better and smoother results
INT32	flip	Flip the image vertically
INT32	double	Use double reflection algorithm

Returns: nothing
blurb repeated: Apply an anamorphose effect
Daniel Cotting (cotting@multimania.com, http://www.multimania.com/cotting); December, 1998

blurb repeated: This procedure applies various optimizations to a GIMP layer-based animation in an attempt to reduce the final file size. If a frame of the animation can use the 'combine' mode, this procedure attempts to maximize the number of ajdacent pixels having the same color, which improves the compression for some image formats such as GIF or MNG.
Adam D. Moss <adam@gimp.org>; 1997-2003

plug_in_animationoptimize_diff

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable (unused)

Returns:

IMAGE

result

Resulting image

blurb repeated: This procedure applies various optimizations to a GIMP layer-based animation in an attempt to reduce the final file size. If a frame of the animation can use the 'combine' mode, this procedure uses a simple difference between the frames.
Adam D. Moss <adam@gimp.org>; 1997-2001

plug_in_animationplay

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable (unused)

Returns: nothing
blurb repeated: This plugin allows you to preview a GIMP layer-based animation.
Adam D. Moss <adam@gimp.org>; 1997, 1998...

plug_in_animationunoptimize

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable (unused)

Returns:

IMAGE

result

Resulting image

blurb repeated: This procedure 'simplifies' a GIMP layer-based animation that has been AnimationOptimized. This makes the animation much easier to work with if, for example, the optimized version is all you have.
Adam D. Moss <adam@gimp.org>; 1997-2001

plug_in_antialias

Input:

INT32	run_mode	Interactive=0x0, Noninteractive=0x1
IMAGE	image_id	(unused)
DRAWABLE	drawable_id	Drawable to affect
SUCCESS	weight	0 < weight < 1
PASS_THROUGH	same_threshold	How close two colors have to be to be the 'same'. [0,255]
PASS_THROUGH	diff_threshold	...to be 'different'. [0,255]

Returns: nothing
FIXME
Kevin Turner; June 98, February 1999

plug_in_apply_canvas

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable
INT32	direction	Light direction (0 - 3)
INT32	depth	Texture depth (1 - 50)

Returns: nothing
This function applies a canvas texture map to the drawable.
Karl-Johan Andersson; 1997

plug_in_applylens

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable
SUCCESS	refraction	Lens refraction index
INT32	keep_surroundings	Keep lens surroundings
INT32	set_background	Set lens surroundings to bkgr value
INT32	set_transparent	Set lens surroundings transparent

Returns: nothing
This plug-in uses Snell's law to draw an ellipsoid lens over the image
Morten Eriksen; 1997

plug_in_autocrop

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable

Returns: nothing
blurb repeated: Automagically crops an image.
Tim Newsome; 1997

plug_in_autostretch_hsv

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable

Returns: nothing
This simple plug-in does an automatic contrast stretch. For each channel in the image, it finds the minimum and maximum values... it uses those values to stretch the individual histograms to the full contrast range. For some images it may do just what you want; for others it may be total crap :). This version differs from Contrast Autostretch in that it works in HSV space, and preserves hue.
Scott Goehring and Federico Mena Quintero; 1997

plug_in_blinds

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable
INT32	angle_dsp	Angle of Displacement
INT32	number_of_segments	Number of segments in blinds
INT32	orientation	orientation; 0 = Horizontal, 1 = Vertical
INT32	backgndg_trans	background transparent; FALSE,TRUE

Returns: nothing
More here later
Andy Thomas; 1997

plug_in_blur

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable

Returns: nothing
This plug-in blurs the specified drawable, using a 3x3 blur. Indexed images are not supported.
Miles O'Neal, Spencer Kimball, Peter Mattis, Torsten Martinsen, Brian Degenhardt, Federico Mena Quintero, Stephen Norris, Daniel Cotting; 1995-1998

plug_in_borderaverage

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable
INT32	thickness	Border size to take in count
INT32	bucket_exponent	Bits for bucket size (default=4: 16 Levels)

Returns:

COLOR

borderaverage

The average color of the specified border

blurb repeated: Borderaverage
Internet Access AG; 1998

plug_in_bump_map

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
DRAWABLE	bumpmap	Bump map drawable
SUCCESS	azimuth	Azimuth
SUCCESS	elevation	Elevation
INT32	depth	Depth
INT32	xofs	X offset
INT32	yofs	Y offset
INT32	waterlevel	Level that full transparency should represent
INT32	ambient	Ambient lighting factor
INT32	compensate	Compensate for darkening
INT32	invert	Invert bumpmap
INT32	type	Type of map (LINEAR (0), SPHERICAL (1), SINUSOIDAL (2))

Returns: nothing
This plug-in uses the algorithm described by John Schlag, "Fast Embossing Effects on Raster Image Data" in Graphics GEMS IV (ISBN 0-12-336155-9). It takes a drawable to be applied as a bump map to another image and produces a nice embossing effect.
Federico Mena Quintero, Jens Lautenbacher & Sven Neumann; April 2000, 3.0-pre1-ac2

plug_in_bump_map_tiled

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
DRAWABLE	bumpmap	Bump map drawable
SUCCESS	azimuth	Azimuth
SUCCESS	elevation	Elevation
INT32	depth	Depth
INT32	xofs	X offset
INT32	yofs	Y offset
INT32	waterlevel	Level that full transparency should represent
INT32	ambient	Ambient lighting factor
INT32	compensate	Compensate for darkening
INT32	invert	Invert bumpmap
INT32	type	Type of map (LINEAR (0), SPHERICAL (1), SINUSOIDAL (2))

Returns: nothing
This plug-in uses the algorithm described by John Schlag, "Fast Embossing Effects on Raster Image Data" in Graphics GEMS IV (ISBN 0-12-336155-9). It takes a drawable to be tiled and applied as a bump map to another image and produces a nice embossing effect.
Federico Mena Quintero, Jens Lautenbacher & Sven Neumann; April 2000, 3.0-pre1-ac2

plug_in_c_astretch

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable

plug_in_cartoon

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable
SUCCESS	mask_radius	Cartoon mask radius (radius of pixel neighborhood)
SUCCESS	pct_black	Percentage of darkened pixels to set to black (0.0 - 1.0)

Returns: nothing
Propagates dark values in an image based on each pixel's relative darkness to a neighboring average. The idea behind this filter is to give the look of a black felt pen drawing subsequently shaded with color. This is achieved by darkening areas of the image which are measured to be darker than a neighborhood average. In this way, sufficiently large shifts in intensity are darkened to black. The rate at which they are darkened to black is determined by the second pct_black parameter. The mask_radius parameter controls the size of the pixel neighborhood over which the average intensity is computed and then compared to each pixel in the neighborhood to decide whether or not to darken it to black. Large values for mask_radius result in very thick black areas bordering the shaded regions of color and much less detail for black areas everywhere including inside regions of color. Small values result in more subtle pen strokes and detail everywhere. Small values for the pct_black make the blend from the color regions to the black border lines smoother and the lines themselves thinner and less noticable; larger values achieve the opposite effect.
Bit Specialists, Inc.; 2001

plug_in_ccanalyze

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable

Returns:

INT32

num_colors

Number of colors in the image

Analyze colorcube and print some information about the current image (also displays a color-histogram)
robert@experimental.net; June 20th, 1997

plug_in_checkerboard

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable
INT32	check_mode	Regular or Psychobilly
INT32	check_size	Size of the checks

Returns: nothing
More here later
Brent Burton & the Edward Blevins; 1997

plug_in_clipboard_copy

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Drawable to save

Returns: nothing
Copies the active drawable to the clipboard.
Hans Breuer; 1999

plug_in_clipboard_paste

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Drawable to save

Returns: nothing
Paste image from clipboard into active image.
Hans Breuer; 1999

plug_in_clipboard_paste_as_new

Input:

INT32

run_mode

Interactive, non-interactive

Returns: nothing
Get an image from the Windows clipboard, creating a new image
Hans Breuer; 1999

plug_in_cml_explorer

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (not used)
DRAWABLE	drawable	Input drawable
STRING	parameter_file_name	The name of parameter file. CML_explorer makes an image with its settings.

Returns: nothing
Make an image of Coupled-Map Lattice (CML). CML is a kind of Cellula Automata on continuous (value) domain. In GIMP_RUN_NONINTERACTIVE, the name of a prameter file is passed as the 4th arg. You can control CML_explorer via parameter file.
Shuji Narazaki; 1997

plug_in_color_adjust

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (not used)
DRAWABLE	drawable	Input drawable to adjust

Returns: nothing
The current foreground color is mapped to black (black point), the current background color is mapped to white (white point). Intermediate colors are interpolated
Peter Kirchgessner; v1.03 22-May-00

plug_in_color_enhance

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable

Returns: nothing
This simple plug-in does an automatic saturation stretch. For each channel in the image, it finds the minimum and maximum values... it uses those values to stretch the individual histograms to the full range. For some images it may do just what you want; for others it may not work that well. This version differs from Contrast Autostretch in that it works in HSV space, and preserves hue.
Martin Weber; 1997

plug_in_color_map

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (not used)
DRAWABLE	drawable	Input drawable where colors are to map
COLOR	srccolor_1	First source color
COLOR	srccolor_2	Second source color
COLOR	dstcolor_1	First destination color
COLOR	dstcolor_2	Second destination color
INT32	map_mode	Mapping mode (0: linear, others reserved)

Returns: nothing
Map color range specified by two colorsto color range specified by two other color.Intermediate colors are interpolated.
Peter Kirchgessner; v1.03 22-May-00

plug_in_colorify

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
COLOR	color	Color to apply

Returns: nothing
Makes an average of the RGB channels and uses it to set the color
Francisco Bustamante; 1.1

plug_in_colortoalpha

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable
COLOR	color	Color to remove

Returns: nothing
This replaces as much of a given color as possible in each pixel with a corresponding amount of alpha, then readjusts the color accordingly.
Seth Burgess <sjburges@gimp.org>; 7th Aug 1999

plug_in_compose

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image1	First input image
DRAWABLE	drawable	Input drawable (not used)
IMAGE	image2	Second input image
IMAGE	image3	Third input image
IMAGE	image4	Fourth input image
STRING	compose_type	What to compose: RGB, RGBA, HSV, CMY, CMYK

Returns:

IMAGE

new_image

Output image

This function creates a new image from multiple gray images
Peter Kirchgessner (peter@kirchgessner.net); 1997

plug_in_convmatrix

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable
INT32	argc_matrix	The number of elements in the following array. Should be always 25.
FLOATARRAY	matrix	The 5x5 convolution matrix
INT32	alpha_alg	Enable weighting by alpha channel
SUCCESS	divisor	Divisor
SUCCESS	offset	Offset
INT32	argc_channels	The number of elements in following array. Should be always 5.
INT32ARRAY	channels	Mask of the channels to be filtered
INT32	bmode	Mode for treating image borders

Returns: nothing
blurb repeated: A generic 5x5 convolution matrix
Lauri Alanko; 1997

plug_in_cubism

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
SUCCESS	tile_size	Average diameter of each tile (in pixels)
SUCCESS	tile_saturation	Expand tiles by this amount
INT32	bg_color	Background color: { BLACK (0), BG (1) }

Returns: nothing
Help not yet written for this plug-in
Spencer Kimball & Tracy Scott; 1996

plug_in_curve_bend

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable (must be a layer without layermask)
SUCCESS	rotation	Direction {angle 0 to 360 degree } of the bend effect
INT32	smoothing	Smoothing { TRUE, FALSE }
INT32	antialias	Antialias { TRUE, FALSE }
INT32	work_on_copy	{ TRUE, FALSE } TRUE: copy the drawable and bend the copy
INT32	curve_type	{ 0, 1 } 0 == smooth (use 17 points), 1 == freehand (use 256 val_y)
INT32	argc_upper_point_x	{2 <= argc <= 17}
FLOATARRAY	upper_point_x	array of 17 x point_koords { 0.0 <= x <= 1.0 or -1 for unused point }
INT32	argc_upper_point_y	{2 <= argc <= 17}
FLOATARRAY	upper_point_y	array of 17 y point_koords { 0.0 <= y <= 1.0 or -1 for unused point }
INT32	argc_lower_point_x	{2 <= argc <= 17}
FLOATARRAY	lower_point_x	array of 17 x point_koords { 0.0 <= x <= 1.0 or -1 for unused point }
INT32	argc_lower_point_y	{2 <= argc <= 17}
FLOATARRAY	lower_point_y	array of 17 y point_koords { 0.0 <= y <= 1.0 or -1 for unused point }
INT32	argc_upper_val_y	{ 256 }
INT8ARRAY	upper_val_y	array of 256 y freehand koord { 0 <= y <= 255 }
INT32	argc_lower_val_y	{ 256 }
INT8ARRAY	lower_val_y	array of 256 y freehand koord { 0 <= y <= 255 }

Returns:

LAYER

bent_layer

the handled layer

This plug-in does bend the active layer If there is a current selection it is copied to floating selection and the curve_bend distortion is done on the floating selection. If work_on_copy parameter is TRUE, the curve_bend distortion is done on a copy of the active layer (or floating selection). The upper and lower edges are bent in shape of 2 spline curves. both (upper and lower) curves are determined by upto 17 points or by 256 Y-Values if curve_type == 1 (freehand mode) If rotation is not 0, the layer is rotated before and rotated back after the bend operation. This enables bending in other directions than vertical. bending usually changes the size of the handled layer. this plugin sets the offsets of the handled layer to keep its center at the same position
Wolfgang Hofer; v1.3.18 (2003/08/26)

plug_in_db_browser

Input:

INT32

run_mode

Interactive, [non-interactive]

Returns: nothing
blurb repeated: List available procedures in the PDB
Thomas Noel; 23th june 1997

plug_in_decompose

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable
STRING	decompose_type	What to decompose: RGB, Red, Green, Blue, RGBA, Red, Green, Blue, Alpha, HSV, Hue, Saturation, Value, CMY, Cyan, Magenta, Yellow, CMYK, Cyan_K, Magenta_K, Yellow_K, Alpha, LAB
INT32	layers_mode	Create channels as layers in a single image

Returns:

IMAGE	new_image	Output gray image
IMAGE	new_image	Output gray image (N/A for single channel extract)
IMAGE	new_image	Output gray image (N/A for single channel extract)
IMAGE	new_image	Output gray image (N/A for single channel extract)

This function creates new gray images with different channel information in each of them
Peter Kirchgessner (peter@kirchgessner.net); 1997

plug_in_deinterlace

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable
INT32	evenodd	0 = keep odd, 1 = keep even

Returns: nothing
Deinterlace is useful for processing images from video capture cards. When only the odd or even fields get captured, deinterlace can be used to interpolate between the existing fields to correct this.
Andrew Kieschnick; 1997

plug_in_depth_merge

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	result	Result
DRAWABLE	source1	Source 1
DRAWABLE	source2	Source 2
DRAWABLE	depthMap1	Depth map 1
DRAWABLE	depthMap2	Depth map 2
SUCCESS	overlap	Overlap
SUCCESS	offset	Depth relative offset
SUCCESS	scale1	Depth relative scale 1
SUCCESS	scale2	Depth relative scale 2

Returns: nothing
Taking as input two full-color, full-alpha images and two corresponding grayscale depth maps, this plug-in combines the images based on which is closer (has a lower depth map value) at each point.
Sean Cier; 1.0.0; 14 August 1998

plug_in_despeckle

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
INT32	radius	Filter box radius (default = 3)
INT32	type	Filter type (0 = median, 1 = adaptive, 2 = recursive-median, 3 = recursive-adaptive)
INT32	black	Black level (0 to 255)
INT32	white	White level (0 to 255)

Returns: nothing
This plug-in selectively performs a median or adaptive box filter on an image.
Copyright 1997-1998 by Michael Sweet; 1.3.2 - 17 May 1998

plug_in_destripe

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
INT32	avg_width	Averaging filter width (default = 36)

Returns: nothing
This plug-in tries to remove vertical stripes from an image.
Marc Lehmann <pcg@goof.com>; 0.2

plug_in_diffraction

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
SUCCESS	lam_r	Light frequency (red)
SUCCESS	lam_g	Light frequency (green)
SUCCESS	lam_b	Light frequency (blue)
SUCCESS	contour_r	Number of contours (red)
SUCCESS	contour_g	Number of contours (green)
SUCCESS	contour_b	Number of contours (blue)
SUCCESS	edges_r	Number of sharp edges (red)
SUCCESS	edges_g	Number of sharp edges (green)
SUCCESS	edges_b	Number of sharp edges (blue)
SUCCESS	brightness	Brightness and shifting/fattening of contours
SUCCESS	scattering	Scattering (Speed vs. quality)
SUCCESS	polarization	Polarization

Returns: nothing
Help? What help? Real men do not need help :-)
Federico Mena Quintero & David Bleecker; April 1997, 0.5

plug_in_dilate

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (not used)
DRAWABLE	drawable	Input drawable
INT32	propagate-mode	propagate 0:white, 1:black, 2:middle value 3:foreground to peak, 4:foreground, 5:background, 6:opaque, 7:transparent
INT32	propagating-channel	channels which values are propagated
SUCCESS	propagating-rate	0.0 <= propagatating_rate <= 1.0
INT32	direction-mask	0 <= direction-mask <= 15
INT32	lower-limit	0 <= lower-limit <= 255
INT32	upper-limit	0 <= upper-limit <= 255

Returns: nothing
Dilate image
Shuji Narazaki; 1996-1997

plug_in_displace

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable
SUCCESS	amount_x	Displace multiplier for X or radial direction
SUCCESS	amount_y	Displace multiplier for Y or tangent (degrees) direction
INT32	do_x	Displace in X or radial direction?
INT32	do_y	Displace in Y or tangent direction?
DRAWABLE	displace_map_x	Displacement map for X or radial direction
DRAWABLE	displace_map_y	Displacement map for Y or tangent direction
INT32	displace_type	Edge behavior: { WRAP (0), SMEAR (1), BLACK (2) }
INT32	mode	Mode of displacement: { CARTESIAN (0), POLAR (1) }

Returns: nothing
Displaces the contents of the specified drawable by the amounts specified by 'amount_x' and 'amount_y' multiplied by the intensity of corresponding pixels in the 'displace_map' drawables. If mode is polar coordinatesdrawable is whirled and pinched according to map.
Stephen Robert Norris; 1996

plug_in_dog

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
SUCCESS	inner	Radius of inner gaussian blur (in pixels, > 0.0)
SUCCESS	outer	Radius of outer gaussian blur (in pixels, > 0.0)
INT32	normalize	True, False
INT32	invert	True, False

Returns: nothing
Applies two Gaussian blurs to the drawable, and subtracts the results. This is robust and widely used method for detecting edges. Uses Gauss IIR algorithm for the Gaussians.
Spencer Kimball, Peter Mattis, Sven Neumann, William Skaggs; 1995-2004

plug_in_edge

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable
SUCCESS	amount	Edge detection amount
INT32	wrapmode	Edge detection behavior: { WRAP (0), SMEAR (1), BLACK (2) }
INT32	edgemode	Edge detection algorithm: { SOBEL (0), PREWITT (1), GRADIENT (2), ROBERTS (3), DIFFERENTIAL (4), LAPLACE (5) }

Returns: nothing
Perform edge detection on the contents of the specified drawable.AMOUNT is an arbitrary constant, WRAPMODE is like displace plug-in (useful for tilable image). EDGEMODE sets the kind of matrix transform applied to the pixels, SOBEL was the method used in older versions.
Peter Mattis; 1996

plug_in_emboss

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	img	The Image
DRAWABLE	drw	The Drawable
SUCCESS	azimuth	The Light Angle (degrees)
SUCCESS	elevation	The Elevation Angle (degrees)
INT32	depth	The Filter Width
INT32	embossp	Emboss or Bumpmap

Returns: nothing
Emboss or Bumpmap the given drawable, specifying the angle and elevation for the light source.
Eric L. Hernes; 1997

plug_in_engrave

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable
INT32	height	Resolution in pixels
INT32	limit	If true, limit line width

Returns: nothing
Creates a black-and-white 'engraved' version of an image as seen in old illustrations
Spencer Kimball & Peter Mattis, Eiichi Takamori, Torsten Martinsen; 1995,1996,1997

plug_in_erode

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (not used)
DRAWABLE	drawable	Input drawable
INT32	propagate-mode	propagate 0:white, 1:black, 2:middle value 3:foreground to peak, 4:foreground, 5:background, 6:opaque, 7:transparent
INT32	propagating-channel	channels which values are propagated
SUCCESS	propagating-rate	0.0 <= propagatating_rate <= 1.0
INT32	direction-mask	0 <= direction-mask <= 15
INT32	lower-limit	0 <= lower-limit <= 255
INT32	upper-limit	0 <= upper-limit <= 255

Returns: nothing
Erode image
Shuji Narazaki; 1996-1997

plug_in_exchange

Input:

INT32	run_mode	Interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
PASS_THROUGH	fromred	Red value (from)
PASS_THROUGH	fromgreen	Green value (from)
PASS_THROUGH	fromblue	Blue value (from)
PASS_THROUGH	tored	Red value (to)
PASS_THROUGH	togreen	Green value (to)
PASS_THROUGH	toblue	Blue value (to)
PASS_THROUGH	red_threshold	Red threshold
PASS_THROUGH	green_threshold	Green threshold
PASS_THROUGH	blue_threshold	Blue threshold

Returns: nothing
Exchange one color with another, optionally setting a threshold to convert from one shade to another
robert@experimental.net; June 17th, 1997

plug_in_film

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (only used as default image in interactive mode)
DRAWABLE	drawable	Input drawable (not used)
INT32	film_height	Height of film (0: fit to images)
COLOR	film_color	Color of the film
INT32	number_start	Start index for numbering
STRING	number_font	Font for drawing numbers
COLOR	number_color	Color for numbers
INT32	at_top	Flag for drawing numbers at top of film
INT32	at_bottom	Flag for drawing numbers at bottom of film
INT32	num_images	Number of images to be used for film
INT32ARRAY	image_ids	num_images image IDs to be used for film

Returns:

IMAGE

new_image

Output image

Compose several images to a roll film
Peter Kirchgessner (peter@kirchgessner.net); 1997

plug_in_filter_pack

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (used for indexed images)
DRAWABLE	drawable	Input drawable

Returns: nothing
No help available
Pavel Grinfeld (pavel@ml.com); 27th March 1997

plug_in_flame

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable

Returns: nothing
Creates cosmic recursive fractal flames
Scott Draves; 1997

plug_in_flarefx

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable
INT32	posx	X-position
INT32	posy	Y-position

Returns: nothing
Adds a lens flare effects. Makes your image look like it was snapped with a cheap camera with a lot of lens :)
Karl-Johan Andersson; May 2000

plug_in_fractal_trace

Input:

INT32	run_mode	interactive / non-interactive
IMAGE	image	input image (not used)
DRAWABLE	drawable	input drawable
SUCCESS	xmin	xmin fractal image delimiter
SUCCESS	xmax	xmax fractal image delimiter
SUCCESS	ymin	ymin fractal image delimiter
SUCCESS	ymax	ymax fractal image delimiter
INT32	depth	trace depth
INT32	outside_type	outside type(0=WRAP/1=TRANS/2=BLACK/3=WHITE)

Returns: nothing
transform image with the Mandelbrot Fractal
Copyright (C) 1997 Hirotsuna Mizuno; v0.4 test version (Dec. 25 1997)

plug_in_fractalexplorer

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
PASS_THROUGH	fractaltype	0: Mandelbrot; 1: Julia; 2: Barnsley 1; 3: Barnsley 2; 4: Barnsley 3; 5: Spider; 6: ManOWar; 7: Lambda; 8: Sierpinski
SUCCESS	xmin	xmin fractal image delimiter
SUCCESS	xmax	xmax fractal image delimiter
SUCCESS	ymin	ymin fractal image delimiter
SUCCESS	ymax	ymax fractal image delimiter
SUCCESS	iter	Iteration value
SUCCESS	cx	cx value ( only Julia)
SUCCESS	cy	cy value ( only Julia)
PASS_THROUGH	colormode	0: Apply colormap as specified by the parameters below; 1: Apply active gradient to final image
SUCCESS	redstretch	Red stretching factor
SUCCESS	greenstretch	Green stretching factor
SUCCESS	bluestretch	Blue stretching factor
PASS_THROUGH	redmode	Red application mode (0:SIN;1:COS;2:NONE)
PASS_THROUGH	greenmode	Green application mode (0:SIN;1:COS;2:NONE)
PASS_THROUGH	bluemode	Blue application mode (0:SIN;1:COS;2:NONE)
PASS_THROUGH	redinvert	Red inversion mode (1: enabled; 0: disabled)
PASS_THROUGH	greeninvert	Green inversion mode (1: enabled; 0: disabled)
PASS_THROUGH	blueinvert	Green inversion mode (1: enabled; 0: disabled)
INT32	ncolors	Number of Colors for mapping (2<=ncolors<=8192)

Returns: nothing
No help yet.
Daniel Cotting (cotting@multimania.com, www.multimania.com/cotting); December, 1998

plug_in_gauss

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
SUCCESS	horizontal	Horizontal radius of gaussian blur (in pixels, > 0.0)
SUCCESS	vertical	Vertical radius of gaussian blur (in pixels, > 0.0)
INT32	method	IIR (0) or RLE (1)

Returns: nothing
Applies a gaussian blur to the drawable, with specified radius of affect. The standard deviation of the normal distribution used to modify pixel values is calculated based on the supplied radius. Horizontal and vertical blurring can be independently invoked by specifying only one to run. The IIR gaussian blurring works best for large radius values and for images which are not computer-generated.
Spencer Kimball & Peter Mattis; 1995-1996

plug_in_gauss_iir

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable
SUCCESS	radius	Radius of gaussian blur (in pixels, > 0.0)
INT32	horizontal	Blur in horizontal direction
INT32	vertical	Blur in vertical direction

plug_in_gauss_iir2

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
SUCCESS	horizontal	Horizontal radius of gaussian blur (in pixels, > 0.0)
SUCCESS	vertical	Vertical radius of gaussian blur (in pixels, > 0.0)

Returns: nothing
Applies a gaussian blur to the drawable, with specified radius of affect. The standard deviation of the normal distribution used to modify pixel values is calculated based on the supplied radius. This radius can be specified indepently on for the horizontal and the vertical direction. The IIR gaussian blurring works best for large radius values and for images which are not computer-generated.
Spencer Kimball, Peter Mattis & Sven Neumann; 1995-2000

plug_in_gauss_rle

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable
SUCCESS	radius	Radius of gaussian blur (in pixels, > 0.0)
INT32	horizontal	Blur in horizontal direction
INT32	vertical	Blur in vertical direction

Returns: nothing
Applies a gaussian blur to the drawable, with specified radius of affect. The standard deviation of the normal distribution used to modify pixel values is calculated based on the supplied radius. Horizontal and vertical blurring can be independently invoked by specifying only one to run. The RLE gaussian blurring performs most efficiently on computer-generated images or images with large areas of constant intensity.
Spencer Kimball & Peter Mattis; 1995-1996

plug_in_gauss_rle2

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
SUCCESS	horizontal	Horizontal radius of gaussian blur (in pixels, > 0.0)
SUCCESS	vertical	Vertical radius of gaussian blur (in pixels, > 0.0)

Returns: nothing
Applies a gaussian blur to the drawable, with specified radius of affect. The standard deviation of the normal distribution used to modify pixel values is calculated based on the supplied radius. This radius can be specified indepently on for the horizontal and the vertical direction. The RLE gaussian blurring performs most efficiently on computer-generated images or images with large areas of constant intensity.
Spencer Kimball, Peter Mattis & Sven Neumann; 1995-2000

plug_in_gfig

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable
INT32	dummy	dummy

Returns: nothing
Draw Vector Graphics and paint them onto your images. Gfig allows you to draw many types of objects inlcuding Lines, Circles, Ellipses, Curves, Polygons, pointed stars, Bezier curves, and Spirals. Objects can be painted using Brushes or other toolsor filled using colours or patterns. Gfig objects can also be used to create selections.
Andy Thomas; 1997

plug_in_gflare

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable
STRING	gflare_name	The name of GFlare
INT32	xcenter	X coordinate of center of GFlare
INT32	ycenter	Y coordinate of center of GFlare
SUCCESS	radius	Radius of GFlare (pixel)
SUCCESS	rotation	Rotation of GFlare (degree)
SUCCESS	hue	Hue rotation of GFlare (degree)
SUCCESS	vangle	Vector angle for second flares (degree)
SUCCESS	vlength	Vector length for second flares (percentage to Radius)
INT32	use_asupsample	Whether it uses or not adaptive supersampling while rendering (boolean)
INT32	asupsample_max_depth	Max depth for adaptive supersampling
SUCCESS	asupsample_threshold	Threshold for adaptive supersampling

Returns: nothing
This plug-in produces a lense flare effect using custom gradients. In interactive call, the user can edit his/her own favorite lense flare (GFlare) and render it. Edited gflare is saved automatically to the folder in gflare-path, if it is defined in gimprc. In non-interactive call, the user can only render one of GFlare which has been stored in gflare-path already.
Eiichi Takamori, and a lot of GIMP people; 1997

plug_in_gimpressionist

Input:

INT32	run_mode	Interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
STRING	preset	Preset Name

Returns: nothing
Performs various artistic operations on an image
Vidar Madsen; v1.0, November 2003

plug_in_glasstile

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable
INT32	tilex	Tile width (10 - 50)
INT32	tiley	Tile height (10 - 50)

Returns: nothing
Divide the image into square glassblocks in which the image is refracted.
Karl-Johan Andersson; May 2000

plug_in_gradmap

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable

Returns: nothing
This plug-in maps the contents of the specified drawable with active gradient. It calculates luminosity of each pixel and replaces the pixel by the sample of active gradient at the position proportional to that luminosity. Complete black pixel becomes the leftmost color of the gradient, and complete white becomes the rightmost. Works on both Grayscale and RGB image with/without alpha channel.
Eiichi Takamori; 1997

plug_in_grid

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
INT32	hwidth	Horizontal Width (>= 0)
INT32	hspace	Horizontal Spacing (>= 1)
INT32	hoffset	Horizontal Offset (>= 0)
COLOR	hcolor	Horizontal Colour
PASS_THROUGH	hopacity	Horizontal Opacity (0...255)
INT32	vwidth	Vertical Width (>= 0)
INT32	vspace	Vertical Spacing (>= 1)
INT32	voffset	Vertical Offset (>= 0)
COLOR	vcolor	Vertical Colour
PASS_THROUGH	vopacity	Vertical Opacity (0...255)
INT32	iwidth	Intersection Width (>= 0)
INT32	ispace	Intersection Spacing (>= 0)
INT32	ioffset	Intersection Offset (>= 0)
COLOR	icolor	Intersection Colour
PASS_THROUGH	iopacity	Intersection Opacity (0...255)

Returns: nothing
Draws a grid using the specified colors. The grid origin is the upper left corner.
Tim Newsome, Sven Neumann, Tom Rathborne, TC; 1997 - 2000

plug_in_guillotine

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable (unused)

Returns: nothing
This function takes an image and blah blah. Hooray!
Adam D. Moss (adam@foxbox.org); 1998

plug_in_hot

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	The Image
DRAWABLE	drawable	The Drawable
INT32	mode	Mode -- NTSC/PAL
INT32	action	The action to perform
INT32	new_layerp	Create a new layer iff True

Returns: nothing
hot scans an image for pixels that will give unsave values of chrominance or composite signale amplitude when encoded into an NTSC or PAL signal. Three actions can be performed on these ``hot'' pixels. (0) reduce luminance, (1) reduce saturation, or (2) Blacken.
Eric L. Hernes; 1997

plug_in_hsv_noise

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (not used)
DRAWABLE	drawable	Input drawable
INT32	holdness	convolution strength
INT32	hue_distance	distribution distance on hue axis [0,255]
INT32	saturation_distance	distribution distance on saturation axis [0,255]
INT32	value_distance	distribution distance on value axis [0,255]

Returns: nothing
Scattering pixel values in HSV space
Shuji Narazaki; 1997

plug_in_ifs_compose

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable

Returns: nothing
Interactively create an Iterated Function System fractal. Use the window on the upper left to adjust the component transformations of the fractal. The operation that is performed is selected by the buttons underneath the window, or from a menu popped up by the right mouse button. The fractal will be rendered with a transparent background if the current image has an alpha channel.
Owen Taylor; 1997

plug_in_illusion

Input:

INT32	run_mode	interactive / non-interactive
IMAGE	image	input image
DRAWABLE	drawable	input drawable
INT32	division	the number of divisions
INT32	type	illusion type (0=type1, 1=type2)

Returns: nothing
produce illusion
Hirotsuna Mizuno; v0.8 (May 14 2000)

plug_in_iwarp

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable

Returns: nothing
Interactive warping of the specified drawable
Norbert Schmitz; 1997

plug_in_jigsaw

Input:

INT32	run_mode	Interactive, Non-interactive, Last-Vals
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
INT32	x	Number of tiles across > 0
INT32	y	Number of tiles down > 0
INT32	style	The style/shape of the jigsaw puzzle, 0 or 1
INT32	blend_lines	Number of lines for shading bevels >= 0
SUCCESS	blend_amount	The power of the light highlights 0 =< 5

Returns: nothing
Jigsaw puzzle look
Nigel Wetten; May 2000

plug_in_kaleidoscope

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
SUCCESS	angle1	Angle of leading edge of viewing slice
SUCCESS	angle2	Rollback angle
INT32	nsegs	Number of segments

Returns: nothing
Simulate looking at an image thru a kaleidoscope
Kelly Martin; 0.01 (1999/09/30)

plug_in_laplace

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable

Returns: nothing
This plugin creates one-pixel wide edges from the image, with the value proportional to the gradient. It uses the Laplace operator (a 3x3 kernel with -8 in the middle). The image has to be laplacered to get useful results, a gauss_iir with 1.5 - 5.0 depending on the noise in the image is best.
Thorsten Schnier; 1997

plug_in_lic

Input:

INT32	run_mode	Interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable

Returns: nothing
No help yet
Tom Bech & Federico Mena Quintero; Version 0.14, September 24 1997

plug_in_lighting

Input:

INT32	run_mode	Interactive (0), non-interactive (1)
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
DRAWABLE	bumpdrawable	Bumpmap drawable (set to 0 if disabled)
DRAWABLE	envdrawable	Environmentmap drawable (set to 0 if disabled)
INT32	dobumpmap	Enable bumpmapping (TRUE/FALSE)
INT32	doenvmap	Enable envmapping (TRUE/FALSE)
INT32	bumpmaptype	Type of mapping (0=linear,1=log, 2=sinusoidal, 3=spherical)
INT32	lighttype	Type of lightsource (0=point,1=directional,3=spot,4=none)
COLOR	lightcolor	Lightsource color (r,g,b)
SUCCESS	lightposition_x	Lightsource position (x,y,z)
SUCCESS	lightposition_y	Lightsource position (x,y,z)
SUCCESS	lightposition_z	Lightsource position (x,y,z)
SUCCESS	lightdirection_x	Lightsource direction [x,y,z]
SUCCESS	lightdirection_y	Lightsource direction [x,y,z]
SUCCESS	lightdirection_z	Lightsource direction [x,y,z]
SUCCESS	ambient_intensity	Material ambient intensity (0..1)
SUCCESS	diffuse_intensity	Material diffuse intensity (0..1)
SUCCESS	diffuse_reflectivity	Material diffuse reflectivity (0..1)
SUCCESS	specular_reflectivity	Material specular reflectivity (0..1)
SUCCESS	highlight	Material highlight (0..->), note: it's expotential
INT32	antialiasing	Apply antialiasing (TRUE/FALSE)
INT32	newimage	Create a new image (TRUE/FALSE)
INT32	transparentbackground	Make background transparent (TRUE/FALSE)

Returns: nothing
No help yet
Tom Bech & Federico Mena Quintero; Version 0.2.0, March 15 1998

plug_in_make_seamless

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (unused)
DRAWABLE	drawable	Input drawable

Returns: nothing
This plugin creates a seamless tileable from the input drawable
Tim Rowley; 1997

plug_in_map_object

Input:

INT32	run_mode	Interactive (0), non-interactive (1)
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
INT32	maptype	Type of mapping (0=plane,1=sphere,2=box,3=cylinder)
SUCCESS	viewpoint_x	Position of viewpoint (x,y,z)
SUCCESS	viewpoint_y	Position of viewpoint (x,y,z)
SUCCESS	viewpoint_z	Position of viewpoint (x,y,z)
SUCCESS	position_x	Object position (x,y,z)
SUCCESS	position_y	Object position (x,y,z)
SUCCESS	position_z	Object position (x,y,z)
SUCCESS	firstaxis_x	First axis of object [x,y,z]
SUCCESS	firstaxis_y	First axis of object [x,y,z]
SUCCESS	firstaxis_z	First axis of object [x,y,z]
SUCCESS	secondaxis_x	Second axis of object [x,y,z]
SUCCESS	secondaxis_y	Second axis of object [x,y,z]
SUCCESS	secondaxis_z	Second axis of object [x,y,z]
SUCCESS	rotationangle_x	Rotation about X axis in degrees
SUCCESS	rotationangle_y	Rotation about Y axis in degrees
SUCCESS	rotationangle_z	Rotation about Z axis in degrees
INT32	lighttype	Type of lightsource (0=point,1=directional,3=none)
COLOR	lightcolor	Lightsource color (r,g,b)
SUCCESS	lightposition_x	Lightsource position (x,y,z)
SUCCESS	lightposition_y	Lightsource position (x,y,z)
SUCCESS	lightposition_z	Lightsource position (x,y,z)
SUCCESS	lightdirection_x	Lightsource direction [x,y,z]
SUCCESS	lightdirection_y	Lightsource direction [x,y,z]
SUCCESS	lightdirection_z	Lightsource direction [x,y,z]
SUCCESS	ambient_intensity	Material ambient intensity (0..1)
SUCCESS	diffuse_intensity	Material diffuse intensity (0..1)
SUCCESS	diffuse_reflectivity	Material diffuse reflectivity (0..1)
SUCCESS	specular_reflectivity	Material specular reflectivity (0..1)
SUCCESS	highlight	Material highlight (0..->), note: it's expotential
INT32	antialiasing	Apply antialiasing (TRUE/FALSE)
INT32	tiled	Tile source image (TRUE/FALSE)
INT32	newimage	Create a new image (TRUE/FALSE)
INT32	transparentbackground	Make background transparent (TRUE/FALSE)
SUCCESS	radius	Sphere/cylinder radius (only used when maptype=1 or 3)
SUCCESS	x_scale	Box x size (0..->)
SUCCESS	y_scale	Box y size (0..->)
SUCCESS	z_scale	Box z size (0..->)
SUCCESS	cylinder_length	Cylinder length (0..->)
DRAWABLE	box_front_drawable	Box front face (set these to -1 if not used)
DRAWABLE	box_back_drawable	Box back face
DRAWABLE	box_top_drawable	Box top face
DRAWABLE	box_bottom_drawable	Box bottom face
DRAWABLE	box_left_drawable	Box left face
DRAWABLE	box_right_drawable	Box right face
DRAWABLE	cyl_top_drawable	Cylinder top face (set these to -1 if not used)
DRAWABLE	cyl_bottom_drawable	Cylinder bottom face

Returns: nothing
No help yet
Tom Bech & Federico Mena Quintero; Version 1.2.0, July 16 1998

plug_in_math_merge

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	an_image	Active Image
DRAWABLE	source_A	Source A
DRAWABLE	source_B	Source B
INT32	result_to	result to new layer A (-3) or B (-2), new image -1 or a valid drawable id
INT32	merge_mode	Add=0 Sub Mul Div AND OR Min Max
INT32	normalize	normalize with; 0 == mode default

Returns:

IMAGE

image

Output image

In fact it merges two drawables with equal dimension into a new one.The effects are similar to the "Layer Modes" but more flexible out of a mathematical point of view.
Hans Breuer <Hans@Breuer.Org>; 1999/09/02

plug_in_max_rgb

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image (not used)
DRAWABLE	drawable	Input drawable
INT32	max_p	1 for maximizing, 0 for minimizing

Returns: nothing
the help is not yet written for this plug-in since none is needed.
Shuji Narazaki; May 2000

plug_in_maze

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image_ID	(unused)
DRAWABLE	drawable_ID	ID of drawable
INT16	width	Width of the passages
INT16	height	Height of the passages
PASS_THROUGH	tileable	Tileable maze?
PASS_THROUGH	algorithm	Generation algorithm(0=DEPTH FIRST, 1=PRIM'S ALGORITHM)
INT32	seed	Random Seed
INT16	multiple	Multiple (use 57)
INT16	offset	Offset (use 1)

Returns: nothing
Generates a maze using either the depth-first search method or Prim's algorithm. Can make tileable mazes too.
Kevin Turner; 1997, 1998

plug_in_mblur

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable
INT32	type	Type of motion blur (0 - linear, 1 - radial, 2 - zoom)
INT32	length	Length
INT32	angle	Angle
SUCCESS	center_x	Center X (optional)
SUCCESS	center_y	Center Y (optional)
INT32	blur_outward	For radial, 1 for outward, 0 for inward (optional)

Returns: nothing
This plug-in simulates the effect seen when photographing a moving object at a slow shutter speed. Done by adding multiple displaced copies.
Torsten Martinsen, Federico Mena Quintero and Daniel Skarda; Sep 1997, 1.2

plug_in_metadata_decode_xmp

Input:

IMAGE	image	Input image
STRING	xmp	XMP packet

Returns: nothing
Parse an XMP packet and merge the results with any metadata already attached to the image. This should be used when an XMP packet is read from an image file.
Raphaël Quinet <raphael@gimp.org>; 2005

plug_in_metadata_editor

Input:

INT32	run_mode	Interactive, non-interactive
IMAGE	image	Input image
DRAWABLE	drawable	Input drawable (unused)

Returns: nothing
View and edit metadata information attached to the current image. This can include EXIF, IPTC and/or XMP information. Some or all of this metadata will be saved in the file, depending on the output file format.
Raphaël Quinet <raphael@gimp.org>; 2004-2005

plug_in_metadata_encode_xmp

Input:

IMAGE

image

Input image

Returns:

STRING

xmp

XMP packet

Generate an XMP packet from the metadata information attached to the image. The new XMP packet can then be saved into a file.
Raphaël Quinet <raphael@gimp.org>; 2005

plug_in_metadata_export

Input:

IMAGE	image	Input image
STRING	filename	The name of the file to save the XMP packet in
INT32	overwrite	Overwrite existing file: { FALSE (0), TRUE (1) }

Returns: nothing
Export the metadata associated with the current image into a file. The metadata will be saved as an XMP packet. If overwrite is TRUE, then any existing file will be overwritten without warning. If overwrite is FALSE, then an error will occur if the file already exists.
Raphaël Quinet <raphael@gimp.org>; 2005

plug_in_metadata_get

Input:

IMAGE	image	Input image
STRING	schema	XMP schema prefix or URI
STRING	property	XMP property name

Returns:

INT32	type	XMP property type
INT32	num_vals	number of values
STRINGARRAY	vals	XMP property values

Retrieve the list of values associated with an XMP property.
Raphaël Quinet <raphael@gimp.org>; 2005

plug_in_metadata_get_simple

Input:

IMAGE	image	Input image
STRING	schema	XMP schema prefix or URI
STRING	property	XMP property name

Returns:

STRING

value

XMP property value

Retrieve value associated with a scalar XMP property. This can only be done for simple prope