Pixel Manipulation Filter Primitives

These primitives move pixels or blend adjacent pixels.

Convolve Matrix

The Convolve Matrix primitive uses neighboring pixels to modify the color of a pixel. How the pixel is changed is determined by an N × M matrix with one entry for each neighboring pixel.

Convolve Matrix formula.

The following is an example of a Gaussian Blur that uses a 5 × 5 matrix around the center pixel. The Kernel is an integer representation of a 2-dimensional Gaussian with a standard deviation of 1.4 pixels. It is normalized by the Divisor.[14]

Dialog for Convolve Matrix filter.
Filter Effects dialog after defining a Gaussian Blur using the Convolve Matrix filter primitive.
Convolve Matrix Filter, Gaussian Example.
The above Gaussian Blur, Convolve Matrix filter is applied to a photograph.

The parameters for the effect are:

  • Size: Size of matrix (x × y).
  • Target: Which matrix element corresponds to the target pixel, default is to center Kernel on target pixel.
  • Kernel: The matrix.
  • Divisor: Scale factor after Kernel applied.
  • Bias: Value added after Kernel applied, default 0.
  • Edge Mode: The method that the input image is extended so that pixels at the edge can be evaluated. The options are: Duplicate (the edge pixels are duplicated), Wrap (the pixels are taken from the opposite side of the input image), none (the extended pixels are given RGB and Alpha values of zero). At the moment Inkscape does not use this parameter despite it being in the user interface.
  • Preserve Alpha: If box is checked, Alpha will be copied directly from the input graphics. Otherwise, it will be calculated just like RGB.

The Convolve Matrix primitive is necessarily linked to evaluating pixels. By default, the pixel size is that of the display. This means that the resulting image is not resolution independent. The SVG standard provides ways to avoid this through the filterRes and kernelUnitLength attributes but Inkscape does not yet support them.


Edge Detection


Convolve Matrix: Edge detection formula.

Divisor = 1.0, Bias = 0.0, Preserve Alpha selected.

Convolve Matrix Filter, Edge Detect Example.
Edge detection.


Convolve Matrix: Sharpen formula.

Divisor = 1.0, Bias = 0.0.

Convolve Matrix Filter, Sharpen Example.

The above Sharpen filter is a bit extreme. This Unsharp filter is a bit more subtle.


Convolve Matrix: Unsharp formula.

Divisor = 9.0, Bias = 0.0.

Convolve Matrix Filter, Unsharp Example.


Convolve Matrix: Emboss formula.

Divisor = 1.0, Bias = 0.0.

Convolve Matrix Filter, Emboss Example.

Displacement Map

The Displacement Map primitive distorts one bitmap using another as input. A pixel in the source bitmap is translated to a new coordinate via the equations x' = scale × (CX(x,y) − 0.5) and y' = scale × (CY(x,y) − 0.5) where CX and CY are the any of the RGB components or Alpha, selectable by the X Channel and Y Channel attributes. The X Channel and Y Channel can be mapped with different colors.

The Displacement Map filter can be used to produce some interesting effects, but figuring out a correct map can be difficult. Many of the Preset filters use the output of a Turbulence filter to generate random distortions.

In the following examples, the x displacement is set to red and the y displacement is set to green. The olive green background corresponds to red and green values of 127, which corresponds (almost) to no displacement.

Magnify map.
Magnify map (uniform gradients inside of circle).
Bubble map.
Bubble map.
Twirl map.
Twirl map.
Ripple map.
Ripple map.

See the Stereoscopic Picture example in the next section for another example of using this filter.


Zero displacement? Not possible in the SVG standard. Color and Alpha are described by a byte (8 bits). This corresponds to a range of 0 to 255. A zero displacement would be a value halfway between 0 and 255, or 127.5. But these are integer numbers and you can't have a value of 127.5. Take your pick, 127 or 128. In most practical cases, the shift won't be noticeable.

Gaussian Blur

The Gaussian Blur primitive blurs objects. Realistic highlights and reflections can be added to drawings as well as making objects out-of-focus. The primitive creates an output image by using a Gaussian weighted average of the input pixels around the location of each corresponding output pixel.

Internally, the amount of blur is defined in terms of the blur radius, which for the mathematically inclined is just the standard deviation of the Gaussian. Technically, a Gaussian function extends to infinity. For practical reasons, the limit of an object's blur is two times the blur radius outside the bounding box at maximum blur.

The Gaussian Blur primitive is highly CPU intensive. The output is a trade-off between speed and quality. One can set the Blur quality for the screen display in the Inkscape Preferences dialog (File icon Inkscape Preferences... (Shift+Ctrl+P)) under the Filter entry. Choosing a low-quality option will affect blurring of thin objects the most. Bitmap export is always done at the highest quality (and thus may be slow). In v0.48, one can set the number of threads used to render the filter in the dialog.

A Gaussian Blur filter can be created through both the Filter Effects and the Fill and Stroke dialogs.

Blurring with the Fill and Stroke Dialog

Using the Fill and Stroke dialog to create a blur is fast and easy. The dialog automatically creates the filter for you (and removes it if the blur is removed). In this dialog, the amount of blurring is defined in terms of a percentage. A blurring of 100% (the maximum blurring allowed) is equivalent to a blur radius of 1/8 of the bounding box perimeter. For a square bounding box, this would be half of a side.

To apply a Gaussian Blur to an object, select the object and then adjust the blur with the Blur slider near the bottom of the dialog. Only a symmetric blur can be applied with this dialog.


Blurs created through the Fill and Stroke dialog depend on the size of the blurred object. To get the exact same amount of blur on different size objects, you can either use the Edit icon Paste Style (Shift+Ctrl+V) command (if all the attributes are to be the same) or use the Filter Effects dialog to set the blur radius (standard deviation) to the same values.

Gaussian Blur filter example.
Example of using the Gaussian Blur filter. The star on the left has been blurred respectively by 5%, 10%, and 20% to the right.

Blurring with the Filter Effects dialog

For more sophisticated use of the Gaussian Blur filter it is necessary to use the Filter Effects dialog. Through this dialog you can create asymmetric blurs as well as have precise control over the blur radius. You can also build more complicated filters as demonstrated in the Drop Shadow example earlier in this chapter.

Blurring Examples

Gradient Blurring

Blurring an object with a Gradient softens the color transitions.

Gaussian Blur -- Gradient example.
A Rectangle with a radial Gradient. Left: no blurring; Middle: 2% blurring; Right: 5% blurring.
Clipping and Masking

The Gaussian Blur primitive is applied to an object before any Clipping or Masking. This will give a sharp edge along the clipping path to a blurred object. If you wish the clipped edge to be blurred, put it in a Group by itself and then blur the Group. If you want a feathered edge to an object like a bitmap, create a white transparency mask with the edge blurred.

Gaussian Blur -- Clipping example.
From left to right: Star with circular Clip path not yet applied; Clip path applied to star; star blurred; star put into Group with Group blurred.
Gaussian Blur -- Masking example.
From left to right: White circle mask over bitmap image; blurred circle mask over image; mask applied to image.
Tile Clones

The Create Tiled Clones dialog has an option to vary the Blur Radius under the Blur and opacity tab.

Gaussian Blur -- Tile Clones.
A sphere cloned with the Create Tiled Clones dialog, with Shift, Scale, and Blur changed from their default values.


The Morphology primitive fattens or thins an object. The Operator attribute can either be Dilate or Erode. The amount of change is controlled by the Radius attribute. It can have independent x and y values.

Note: Inkscape seems to under do the transform in PNG export.

Examples of the Morphology primitive. From left to right: Unfiltered object. Dilated object with Radius of 4. Eroded object with Radius of 4.


The Offset primitive shifts a graphic by the specified amounts in x and y. The classic example is the use of this primitive to create a shadow. See the Drop Shadow example earlier in this section.

This primitive has two parameters: Delta X, the offset in the horizontal direction and Delta Y the offset in the vertical direction. Note that the positive y direction is in the downward direction (as defined by the SVG standard).

If the specified offset is large, the filter region needs to be enlarged. You can increase the filter region under the Filter General Settings tab at the bottom of the Filter Effects dialog.

Examples of the Offset primitive. The three squares are drawn on top of each other. The green and red squares are then shifted with the Offset primitive. The filter region for the green and red squares had to be enlarged.

[14] Why define a Gaussian Blur using the Convolve Matrix filter when a Gaussian Blur filter exists? The Gaussian Blur filter is designed to blur on a large scale. The Convolve Matrix filter works on a short scale, reducing noise from neighboring pixels.