GEGL operation reference

Image processing operations are shared objects (plug-ins) loaded when GEGL initializes. This page is generated from information registered by the plug-ins themselves.

Categories

A plug-in can belong in multiple categories. Below is indexes broken down into the various available categories.

misc

transparency

blur

meta

svgfilter

programming

math

porter-duff

edge

video

other-blend

effects

render

transform

color

input

compositors

core

enhance

output

	add
	Math operation add (c = c + value)
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	Double	value	global value used if aux doesn't contain data
	bilateral-filter
	An edge preserving blur filter that can be used for noise reduction. It is a gaussian blur where the contribution of neighbourhood pixels are weighted by the color difference from the center pixel.
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Double	blur-radius	Radius of square pixel region, (width and height will be radius*2+1).
	Double	edge-preservation	Amount of edge preservation
	box-blur
	Performs an averaging of a square box of pixels.
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Double	radius	Radius of square pixel region, (width and height will be radius*2+1).
	brightness-contrast
	Changes the light level and contrast.
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Double	contrast	Range scale factor
	Double	brightness	Amount to increase brightness
	c2g
	Color to grayscale conversion that uses, spatial color differences to perform local grayscale contrast enhancement.
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Int	radius	Neighbourhood taken into account
	Int	samples	Number of samples to do
	Int	iterations	Number of iterations (length of exposure)
	Boolean	same-spray	Use the same spray for all pixels
	Double	rgamma	Gamma applied to radial distribution
	Double	strength	Amount of correction 0=none 1.0=full
	Double	gamma	Post correction gamma.
	checkerboard
	Checkerboard renderer.
	Object	output	Ouput pad for generated image buffer.
	Int	x	Horizontal width of cells pixels.
	Int	y	Vertical width of cells in pixels.
	Int	x-offset	Horizontal offset (from origin) for start of grid.
	Int	y-offset	Vertical offset (from origin) for start of grid.
	Color	color1	One of the cell colors (defaults to 'black')
	Color	color2	The other cell color (defaults to 'white')
	clear
	Porter Duff operation clear (d = 0.0)
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	clone
	Clone a buffer
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	String	ref	The reference ID used as input (for use in XML).
	color
	Generates a buffer entirely filled with the specified color, crop it to get smaller dimensions.
	Object	output	Ouput pad for generated image buffer.
	Color	value	The color to render (defaults to 'black')
	color-burn
	SVG blend operation color-burn (if cA * aB + cB * aA <= aA * aB: d = cA * (1 - aB) + cB * (1 - aA) otherwise: d = (cA == 0 ? 1 : (aA * (cA * aB + cB * aA - aA * aB) / cA) + cA * (1 - aB) + cB * (1 - aA)))
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	color-dodge
	SVG blend operation color-dodge (if cA * aB + cB * aA >= aA * aB: d = aA * aB + cA * (1 - aB) + cB * (1 - aA) otherwise: d = (cA == aA ? 1 : cB * aA / (aA == 0 ? 1 : 1 - cA / aA)) + cA * (1 - aB) + cB * (1 - aA))
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	contrast-curve
	Adjusts the contrast of the image according to a curve.
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Int	sampling-points	Number of curve sampling points. 0 for exact calculation.
	Curve	curve	The contrast curve.
	convert-format
	Convert the data to the specified format
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	String	format	Babl ouput format string
	crop
	Crop a buffer
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Double	x	X
	Double	y	Y
	Double	width	Width
	Double	height	Height
	darken
	SVG blend operation darken (d = MIN (cA * aB, cB * aA) + cA * (1 - aB) + cB * (1 - aA))
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	difference
	SVG blend operation difference (d = cA + cB - 2 * (MIN (cA * aB, cB * aA)))
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	difference-of-gaussians
	Does an edge detection based on the differnece of two gaussian blurs.
	Double	radius1	Radius
	Double	radius2	Radius
	divide
	Math operation divide (c = value==0.0?0.0:c/value)
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	Double	value	global value used if aux doesn't contain data
	dropshadow
	Creates a dropshadow effect on the input buffer.
	Double	opacity	Opacity
	Double	x	Horizontal shadow offset.
	Double	y	Vertical shadow offset.
	Double	radius	Blur radius.
	dst
	Porter Duff operation dst (d = cB)
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	dst-atop
	Porter Duff operation dst-atop (d = cB * aA + cA * (1 - aB))
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	dst-in
	Porter Duff operation dst-in (d = cB * aA)
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	dst-out
	Porter Duff operation dst-out (d = cB * (1 - aA))
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	dst-over
	Porter Duff operation dst-over (d = cB + cA * (1 - aB))
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	exclusion
	SVG blend operation exclusion (d = (cA * aB + cB * aA - 2 * cA * cB) + cA * (1 - aB) + cB * (1 - aA))
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	ff-load
	FFmpeg video frame importer.
	Object	output	Ouput pad for generated image buffer.
	Path	path	Path of file to load.
	Int	frame	frame number
	fractal-explorer
	Fractal Explorer
	Object	output	Ouput pad for generated image buffer.
	Int	width	Width
	Int	height	Height
	Int	fractaltype	Fractal Type
	Double	xmin	Left
	Double	xmax	Right
	Double	ymin	Top
	Double	ymax	Bottom
	Int	iter	Iterations
	Double	cx	CX (only Julia)
	Double	cy	CY (only Julia)
	Double	redstretch	Red stretching factor
	Double	greenstretch	Green stretching factor
	Double	bluestretch	Blue stretching factor
	Int	redmode	Red application mode (0:SIN; 1:COS; 2:NONE)
	Int	greenmode	Green application mode (0:SIN; 1:COS; 2:NONE)
	Int	bluemode	Blue application mode (0:SIN; 1:COS; 2:NONE)
	Boolean	redinvert	Red inversion
	Boolean	greeninvert	Green inversion
	Boolean	blueinvert	Blue inversion
	Int	ncolors	Number of colors
	Boolean	useloglog	Use loglog smoothing
	gamma
	Math operation gamma (c = powf (c, value))
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	Double	value	global value used if aux doesn't contain data
	gaussian-blur
	Performs an averaging of neighbouring pixels with the normal distribution as weighting.
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Double	std-dev-x	Standard deviation for the horizontal axis. (multiply by ~2 to get radius)
	Double	std-dev-y	Standard deviation for the vertical axis. (multiply by ~2 to get radius.)
	String	filter	Optional parameter to override the automatic selection of blur filter.
	grey
	Turns the image greyscale
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	hard-light
	SVG blend operation hard-light (if 2 * cA < aA: d = 2 * cA * cB + cA * (1 - aB) + cB * (1 - aA) otherwise: d = aA * aB - 2 * (aB - cB) * (aA - cA) + cA * (1 - aB) + cB * (1 - aA))
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	introspect
	GEGL graph vizualizer.
	Object	output	Ouput pad for generated image buffer.
	Object	node	GeglNode to introspect
	Pointer	buf	Buffer
	invert
	Inverts the components (except alpha), the result is the corresponding "negative" image.
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	layer
	A layer in the traditional sense.
	String	composite-op	Composite operation to use
	Double	opacity	Opacity
	Double	x	Horizontal position
	Double	y	Vertical position
	Double	scale	Scale 1:1 size
	Path	src	Source datafile (png, jpg, raw, svg, bmp, tif, ...)
	levels
	Remaps the intensity range of the image
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Double	in-low	Input luminance level to become lowest output
	Double	in-high	Input luminance level to become white.
	Double	out-low	Lowest luminance level in output
	Double	out-high	Highest luminance level in output
	lighten
	SVG blend operation lighten (d = MAX (cA * aB, cB * aA) + cA * (1 - aB) + cB * (1 - aA))
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	load
	Multipurpose file loader, that uses other native handlers, and fallback conversion using image magick's convert.
	Path	path	Path of file to load.
	load-buffer
	A source that uses an in-memory GeglBuffer, for use internally by GEGL.
	Object	output	Ouput pad for generated image buffer.
	Object	buffer	The GeglBuffer to load into the pipeline
	mblur
	Accumulating motion blur
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Double	dampness	dampening, 0.0 is no dampening 1.0 is no change.
	mono-mixer
	Monochrome channel mixer
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Double	red	Amount of red
	Double	green	Amount of green
	Double	blue	Amount of blue
	multiply
	Math operation multiply (c = c * value)
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	Double	value	global value used if aux doesn't contain data
	nop
	No operation (can be used as a routing point)
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	normal
	Other blend operation normal (d = cA + cB * (1 - aA))
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	opacity
	Weights the opacity of the input with either the value of the aux input or the global value property.
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	Double	value	Global opacity value, used if no auxiliary input buffer is provided.
	over
	Other blend operation over (d = cA + cB * (1 - aA))
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	overlay
	SVG blend operation overlay (if 2 * cB > aB: d = 2 * cA * cB + cA * (1 - aB) + cB * (1 - aA) otherwise: d = aA * aB - 2 * (aB - cB) * (aA - cA) + cA * (1 - aB) + cB * (1 - aA))
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	perlin-noise
	Perlin noise generator.
	Object	output	Ouput pad for generated image buffer.
	Double	alpha	not documented
	Double	scale	not documented
	Double	zoff	not documented
	Double	seed	not documented
	Int	n	not documented
	pixbuf
	Uses the GdkPixbuf located at the memory location in pixbuf.
	Object	output	Ouput pad for generated image buffer.
	Pointer	pixbuf	GdkPixbuf to use
	plus
	SVG blend operation plus (d = cA + cB)
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	png-save
	PNG image saver (passes the buffer through, saves as a side-effect.)
	Object	input	Input pad, for image buffer input.
	String	path	Target path and filename, use '-' for stdout.
	Int	compression	PNG compression level from 1 to 9
	reflect
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Double	origin-x	X-coordinate of origin
	Double	origin-y	Y-coordinate of origin
	String	filter	Filter type (nearest, linear, lanczos)
	Boolean	hard-edges	Hard edges
	Int	lanczos-width	Lanczos-width width of lanczos function
	Double	x	Direction vector's x component
	Double	y	Direction vector's y component
	remap
	Linearly remap the R,G,B based on per pixel minimum and maximum values from the high/low input pads
	rotate
	Rotate the buffer around the specfied origin.
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Double	origin-x	X-coordinate of origin
	Double	origin-y	Y-coordinate of origin
	String	filter	Filter type (nearest, linear, lanczos)
	Boolean	hard-edges	Hard edges
	Int	lanczos-width	Lanczos-width width of lanczos function
	Double	degrees	Angle to rotate (clockwize)
	save-buffer
	A GEGL buffer destination surface.
	Object	input	Input pad, for image buffer input.
	Pointer	buffer	The location where to store the output GeglBuffer
	save-pixbuf
	Save output into a GdkPixbuf.
	Object	input	Input pad, for image buffer input.
	Pointer	pixbuf	The location where to store the output GdkPixuf.
	scale
	Scales the buffer.
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Double	origin-x	X-coordinate of origin
	Double	origin-y	Y-coordinate of origin
	String	filter	Filter type (nearest, linear, lanczos)
	Boolean	hard-edges	Hard edges
	Int	lanczos-width	Lanczos-width width of lanczos function
	Double	x	Horizontal scale factor.
	Double	y	Vertical scale factor.
	screen
	SVG blend operation screen (d = cA + cB - cA * cB)
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	shear
	Shears the buffer.
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Double	origin-x	X-coordinate of origin
	Double	origin-y	Y-coordinate of origin
	String	filter	Filter type (nearest, linear, lanczos)
	Boolean	hard-edges	Hard edges
	Int	lanczos-width	Lanczos-width width of lanczos function
	Double	x	Horizontal shear amount.
	Double	y	Vertical shear amount.
	shift
	Shift the contents of a buffer
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Double	x	X-axis shift
	Double	y	Y-axis shift
	snn-mean
	Noise reducing edge enhancing blur filter based on Symmetric Nearest Neighbours
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Double	radius	Radius of square pixel region, (width and height will be radius*2+1)
	Int	pairs	Number of pairs higher number preserves more acute features
	soft-light
	SVG blend operation soft-light (if 2 * cA < aA: d = cB * (aA - (aB == 0 ? 1 : 1 - cB / aB) * (2 * cA - aA)) + cA * (1 - aB) + cB * (1 - aA); if 8 * cB <= aB: d = cB * (aA - (aB == 0 ? 1 : 1 - cB / aB) * (2 * cA - aA) * (aB == 0 ? 3 : 3 - 8 * cB / aB)) + cA * (1 - aB) + cB * (1 - aA); otherwise: d = (aA * cB + (aB == 0 ? 0 : sqrt (cB / aB) * aB - cB) * (2 * cA - aA)) + cA * (1 - aB) + cB * (1 - aA))
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	src
	Porter Duff operation src (d = cA)
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	src-atop
	Porter Duff operation src-atop (d = cA * aB + cB * (1 - aA))
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	src-in
	Porter Duff operation src-in (d = cA * aB)
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	src-out
	Porter Duff operation src-out (d = cA * (1 - aB))
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	src-over
	Porter Duff operation src-over (d = cA + cB * (1 - aA))
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	stress
	Spatio Temporal Retinex-like Envelope with Stochastic Sampling.
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Int	radius	Neighbourhood taken into account
	Int	samples	Number of samples to do
	Int	iterations	Number of iterations (length of exposure)
	Boolean	same-spray	Use the same spray for all pixels
	Double	rgamma	Gamma applied to radial distribution
	Double	strength	Amount of correction 0=none 1.0=full
	Double	gamma	Post correction gamma.
	stretch-contrast
	Scales the components of the buffer to be in the 0.0-1.0 range. This improves images that makes poor use of the available contrast (little contrast, very dark, or very bright images).
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	subtract
	Math operation subtract (c = c - value)
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	Double	value	global value used if aux doesn't contain data
	svg-huerotate
	SVG color matrix operation svg_huerotate
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	String	values	list of s
	svg-load
	Load an SVG file using librsvg
	Object	output	Ouput pad for generated image buffer.
	Path	path	Path to SVG file to load
	Int	width	Width for rendered image
	Int	height	Height for rendered image
	svg-luminancetoalpha
	SVG color matrix operation svg_luminancetoalpha
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	String	values	list of s
	svg-matrix
	SVG color matrix operation svg_matrix
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	String	values	list of s
	svg-multiply
	SVG blend operation svg-multiply (d = cA * cB + cA * (1 - aB) + cB * (1 - aA))
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	svg-saturate
	SVG color matrix operation svg_saturate
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	String	values	list of s
	text
	Display a string of text using pango and cairo.
	Object	output	Ouput pad for generated image buffer.
	Multiline	string	String to display (utf8)
	String	font	Font family (utf8)
	Double	size	Approximate height of text in pixels.
	Color	color	Color for the text (defaults to 'white')
	Int	wrap	Sets the width in pixels at which long lines will wrap. Use -1 for no wrapping.
	Int	alignment	Alignment for multi-line text (0=Left, 1=Center, 2=Right)
	Int	width	Rendered width in pixels. (read only)
	Int	height	Rendered height in pixels. (read only)
	threshold
	Thresholds the image to white/black based on either the global value set in the value property, or per pixel from the aux input.
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.
	Double	value	Global threshold level (used when there is no auxiliary input buffer).
	tonemap
	Local contrast enhancement
	Double	radius	radius
	Double	blur	blur
	Double	amount	amount
	translate
	Repositions the buffer (with subpixel precision).
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Double	origin-x	X-coordinate of origin
	Double	origin-y	Y-coordinate of origin
	String	filter	Filter type (nearest, linear, lanczos)
	Boolean	hard-edges	Hard edges
	Int	lanczos-width	Lanczos-width width of lanczos function
	Double	x	Horizontal translation.
	Double	y	Vertical translation.
	unsharp-mask
	Performs an unsharp mask on the input buffer (sharpens an image by adding false mach-bands around edges).
	Double	std-dev	Standard deviation (spatial scale factor)
	Double	scale	Scale, strength of effect.
	value-invert
	Inverts just the value component, the result is the corresponding `inverted' image.
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	whitebalance
	Allows changing the whitepoint and blackpoint of an image.
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Double	high-a-delta	not documented
	Double	high-b-delta	not documented
	Double	low-a-delta	not documented
	Double	low-b-delta	not documented
	Double	saturation	not documented
	xor
	Porter Duff operation xor (d = cA * (1 - aB)+ cB * (1 - aA))
	Object	output	Ouput pad for generated image buffer.
	Object	input	Input pad, for image buffer input.
	Object	aux	Auxiliary image buffer input pad.