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)
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  Doublevalue 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.
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Doubleblur-radius Radius of square pixel region, (width and height will be radius*2+1).
  Doubleedge-preservation Amount of edge preservation
  box-blur
  Performs an averaging of a square box of pixels.
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Doubleradius Radius of square pixel region, (width and height will be radius*2+1).
  brightness-contrast
  Changes the light level and contrast.
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Doublecontrast Range scale factor
  Doublebrightness Amount to increase brightness
  c2g
  Color to grayscale conversion that uses, spatial color differences to perform local grayscale contrast enhancement.
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Intradius Neighbourhood taken into account
  Intsamples Number of samples to do
  Intiterations Number of iterations (length of exposure)
  Booleansame-spray Use the same spray for all pixels
  Doublergamma Gamma applied to radial distribution
  Doublestrength Amount of correction 0=none 1.0=full
  Doublegamma Post correction gamma.
  checkerboard
  Checkerboard renderer.
  Objectoutput Ouput pad for generated image buffer.
  Intx Horizontal width of cells pixels.
  Inty Vertical width of cells in pixels.
  Intx-offset Horizontal offset (from origin) for start of grid.
  Inty-offset Vertical offset (from origin) for start of grid.
  Colorcolor1 One of the cell colors (defaults to 'black')
  Colorcolor2 The other cell color (defaults to 'white')
  clear
  Porter Duff operation clear (d = 0.0)
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  clone
  Clone a buffer
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Stringref 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.
  Objectoutput Ouput pad for generated image buffer.
  Colorvalue 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)))
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux 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))
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  contrast-curve
  Adjusts the contrast of the image according to a curve.
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Intsampling-points Number of curve sampling points. 0 for exact calculation.
  Curvecurve The contrast curve.
  convert-format
  Convert the data to the specified format
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Stringformat Babl ouput format string
  crop
  Crop a buffer
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Doublex X
  Doubley Y
  Doublewidth Width
  Doubleheight Height
  darken
  SVG blend operation darken (d = MIN (cA * aB, cB * aA) + cA * (1 - aB) + cB * (1 - aA))
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  difference
  SVG blend operation difference (d = cA + cB - 2 * (MIN (cA * aB, cB * aA)))
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  difference-of-gaussians
  Does an edge detection based on the differnece of two gaussian blurs.
  Doubleradius1 Radius
  Doubleradius2 Radius
  divide
  Math operation divide (c = value==0.0?0.0:c/value)
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  Doublevalue global value used if aux doesn't contain data
  dropshadow
  Creates a dropshadow effect on the input buffer.
  Doubleopacity Opacity
  Doublex Horizontal shadow offset.
  Doubley Vertical shadow offset.
  Doubleradius Blur radius.
  dst
  Porter Duff operation dst (d = cB)
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  dst-atop
  Porter Duff operation dst-atop (d = cB * aA + cA * (1 - aB))
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  dst-in
  Porter Duff operation dst-in (d = cB * aA)
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  dst-out
  Porter Duff operation dst-out (d = cB * (1 - aA))
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  dst-over
  Porter Duff operation dst-over (d = cB + cA * (1 - aB))
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  exclusion
  SVG blend operation exclusion (d = (cA * aB + cB * aA - 2 * cA * cB) + cA * (1 - aB) + cB * (1 - aA))
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  ff-load
  FFmpeg video frame importer.
  Objectoutput Ouput pad for generated image buffer.
  Pathpath Path of file to load.
  Intframe frame number
  fractal-explorer
  Fractal Explorer
  Objectoutput Ouput pad for generated image buffer.
  Intwidth Width
  Intheight Height
  Intfractaltype Fractal Type
  Doublexmin Left
  Doublexmax Right
  Doubleymin Top
  Doubleymax Bottom
  Intiter Iterations
  Doublecx CX (only Julia)
  Doublecy CY (only Julia)
  Doubleredstretch Red stretching factor
  Doublegreenstretch Green stretching factor
  Doublebluestretch Blue stretching factor
  Intredmode Red application mode (0:SIN; 1:COS; 2:NONE)
  Intgreenmode Green application mode (0:SIN; 1:COS; 2:NONE)
  Intbluemode Blue application mode (0:SIN; 1:COS; 2:NONE)
  Booleanredinvert Red inversion
  Booleangreeninvert Green inversion
  Booleanblueinvert Blue inversion
  Intncolors Number of colors
  Booleanuseloglog Use loglog smoothing
  gamma
  Math operation gamma (c = powf (c, value))
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  Doublevalue global value used if aux doesn't contain data
  gaussian-blur
  Performs an averaging of neighbouring pixels with the normal distribution as weighting.
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Doublestd-dev-x Standard deviation for the horizontal axis. (multiply by ~2 to get radius)
  Doublestd-dev-y Standard deviation for the vertical axis. (multiply by ~2 to get radius.)
  Stringfilter Optional parameter to override the automatic selection of blur filter.
  grey
  Turns the image greyscale
  Objectoutput Ouput pad for generated image buffer.
  Objectinput 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))
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  introspect
  GEGL graph vizualizer.
  Objectoutput Ouput pad for generated image buffer.
  Objectnode GeglNode to introspect
  Pointerbuf Buffer
  invert
  Inverts the components (except alpha), the result is the corresponding "negative" image.
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  layer
  A layer in the traditional sense.
  Stringcomposite-op Composite operation to use
  Doubleopacity Opacity
  Doublex Horizontal position
  Doubley Vertical position
  Doublescale Scale 1:1 size
  Pathsrc Source datafile (png, jpg, raw, svg, bmp, tif, ...)
  levels
  Remaps the intensity range of the image
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Doublein-low Input luminance level to become lowest output
  Doublein-high Input luminance level to become white.
  Doubleout-low Lowest luminance level in output
  Doubleout-high Highest luminance level in output
  lighten
  SVG blend operation lighten (d = MAX (cA * aB, cB * aA) + cA * (1 - aB) + cB * (1 - aA))
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  load
  Multipurpose file loader, that uses other native handlers, and fallback conversion using image magick's convert.
  Pathpath Path of file to load.
  load-buffer
  A source that uses an in-memory GeglBuffer, for use internally by GEGL.
  Objectoutput Ouput pad for generated image buffer.
  Objectbuffer The GeglBuffer to load into the pipeline
  mblur
  Accumulating motion blur
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Doubledampness dampening, 0.0 is no dampening 1.0 is no change.
  mono-mixer
  Monochrome channel mixer
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Doublered Amount of red
  Doublegreen Amount of green
  Doubleblue Amount of blue
  multiply
  Math operation multiply (c = c * value)
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  Doublevalue global value used if aux doesn't contain data
  nop
  No operation (can be used as a routing point)
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  normal
  Other blend operation normal (d = cA + cB * (1 - aA))
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux 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.
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  Doublevalue Global opacity value, used if no auxiliary input buffer is provided.
  over
  Other blend operation over (d = cA + cB * (1 - aA))
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux 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))
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  perlin-noise
  Perlin noise generator.
  Objectoutput Ouput pad for generated image buffer.
  Doublealpha not documented
  Doublescale not documented
  Doublezoff not documented
  Doubleseed not documented
  Intn not documented
  pixbuf
  Uses the GdkPixbuf located at the memory location in pixbuf.
  Objectoutput Ouput pad for generated image buffer.
  Pointerpixbuf GdkPixbuf to use
  plus
  SVG blend operation plus (d = cA + cB)
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  png-save
  PNG image saver (passes the buffer through, saves as a side-effect.)
  Objectinput Input pad, for image buffer input.
  Stringpath Target path and filename, use '-' for stdout.
  Intcompression PNG compression level from 1 to 9
  reflect
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Doubleorigin-x X-coordinate of origin
  Doubleorigin-y Y-coordinate of origin
  Stringfilter Filter type (nearest, linear, lanczos)
  Booleanhard-edges Hard edges
  Intlanczos-width Lanczos-width width of lanczos function
  Doublex Direction vector's x component
  Doubley 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.
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Doubleorigin-x X-coordinate of origin
  Doubleorigin-y Y-coordinate of origin
  Stringfilter Filter type (nearest, linear, lanczos)
  Booleanhard-edges Hard edges
  Intlanczos-width Lanczos-width width of lanczos function
  Doubledegrees Angle to rotate (clockwize)
  save-buffer
  A GEGL buffer destination surface.
  Objectinput Input pad, for image buffer input.
  Pointerbuffer The location where to store the output GeglBuffer
  save-pixbuf
  Save output into a GdkPixbuf.
  Objectinput Input pad, for image buffer input.
  Pointerpixbuf The location where to store the output GdkPixuf.
  scale
  Scales the buffer.
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Doubleorigin-x X-coordinate of origin
  Doubleorigin-y Y-coordinate of origin
  Stringfilter Filter type (nearest, linear, lanczos)
  Booleanhard-edges Hard edges
  Intlanczos-width Lanczos-width width of lanczos function
  Doublex Horizontal scale factor.
  Doubley Vertical scale factor.
  screen
  SVG blend operation screen (d = cA + cB - cA * cB)
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  shear
  Shears the buffer.
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Doubleorigin-x X-coordinate of origin
  Doubleorigin-y Y-coordinate of origin
  Stringfilter Filter type (nearest, linear, lanczos)
  Booleanhard-edges Hard edges
  Intlanczos-width Lanczos-width width of lanczos function
  Doublex Horizontal shear amount.
  Doubley Vertical shear amount.
  shift
  Shift the contents of a buffer
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Doublex X-axis shift
  Doubley Y-axis shift
  snn-mean
  Noise reducing edge enhancing blur filter based on Symmetric Nearest Neighbours
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Doubleradius Radius of square pixel region, (width and height will be radius*2+1)
  Intpairs 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))
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  src
  Porter Duff operation src (d = cA)
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  src-atop
  Porter Duff operation src-atop (d = cA * aB + cB * (1 - aA))
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  src-in
  Porter Duff operation src-in (d = cA * aB)
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  src-out
  Porter Duff operation src-out (d = cA * (1 - aB))
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  src-over
  Porter Duff operation src-over (d = cA + cB * (1 - aA))
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  stress
  Spatio Temporal Retinex-like Envelope with Stochastic Sampling.
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Intradius Neighbourhood taken into account
  Intsamples Number of samples to do
  Intiterations Number of iterations (length of exposure)
  Booleansame-spray Use the same spray for all pixels
  Doublergamma Gamma applied to radial distribution
  Doublestrength Amount of correction 0=none 1.0=full
  Doublegamma 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).
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  subtract
  Math operation subtract (c = c - value)
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  Doublevalue global value used if aux doesn't contain data
  svg-huerotate
  SVG color matrix operation svg_huerotate
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Stringvalues list of s
  svg-load
  Load an SVG file using librsvg
  Objectoutput Ouput pad for generated image buffer.
  Pathpath Path to SVG file to load
  Intwidth Width for rendered image
  Intheight Height for rendered image
  svg-luminancetoalpha
  SVG color matrix operation svg_luminancetoalpha
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Stringvalues list of s
  svg-matrix
  SVG color matrix operation svg_matrix
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Stringvalues list of s
  svg-multiply
  SVG blend operation svg-multiply (d = cA * cB + cA * (1 - aB) + cB * (1 - aA))
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  svg-saturate
  SVG color matrix operation svg_saturate
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Stringvalues list of s
  text
  Display a string of text using pango and cairo.
  Objectoutput Ouput pad for generated image buffer.
  Multilinestring String to display (utf8)
  Stringfont Font family (utf8)
  Doublesize Approximate height of text in pixels.
  Colorcolor Color for the text (defaults to 'white')
  Intwrap Sets the width in pixels at which long lines will wrap. Use -1 for no wrapping.
  Intalignment Alignment for multi-line text (0=Left, 1=Center, 2=Right)
  Intwidth Rendered width in pixels. (read only)
  Intheight 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.
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.
  Doublevalue Global threshold level (used when there is no auxiliary input buffer).
  tonemap
  Local contrast enhancement
  Doubleradius radius
  Doubleblur blur
  Doubleamount amount
  translate
  Repositions the buffer (with subpixel precision).
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Doubleorigin-x X-coordinate of origin
  Doubleorigin-y Y-coordinate of origin
  Stringfilter Filter type (nearest, linear, lanczos)
  Booleanhard-edges Hard edges
  Intlanczos-width Lanczos-width width of lanczos function
  Doublex Horizontal translation.
  Doubley Vertical translation.
  unsharp-mask
  Performs an unsharp mask on the input buffer (sharpens an image by adding false mach-bands around edges).
  Doublestd-dev Standard deviation (spatial scale factor)
  Doublescale Scale, strength of effect.
  value-invert
  Inverts just the value component, the result is the corresponding `inverted' image.
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  whitebalance
  Allows changing the whitepoint and blackpoint of an image.
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Doublehigh-a-delta not documented
  Doublehigh-b-delta not documented
  Doublelow-a-delta not documented
  Doublelow-b-delta not documented
  Doublesaturation not documented
  xor
  Porter Duff operation xor (d = cA * (1 - aB)+ cB * (1 - aA))
  Objectoutput Ouput pad for generated image buffer.
  Objectinput Input pad, for image buffer input.
  Objectaux Auxiliary image buffer input pad.