12.11. Warp
| 12. Map Filters |

### 12.11. Warp

#### 12.11.1. Overview

This filter displaces pixels of active layer or selection according to the grey levels of a Displacement map. Pixels are displaced according to the gradient slope in the displacement map. Pixels corresponding to solid areas are not displaced; the higher the slope, the higher the displacement.

Afbeelding 17.272. From left to right: original image, displace map, displaced image

Solid areas of displacement map lead to no displacement. Abrupt transitions give an important displacement. A linear gradient gives a regular displacement. Displacement direction is perpendicular to gradient direction (angle = 90°).

Afbeelding 17.273. With a non-linear gradient

A non-linear gradient leads to curls.

Afbeelding 17.274. With a complex gradient:

And a complex gradient, such as the Solid Noise filter can create, gives a swirl effect.

This filter offers the possibility of masking a part of the image to protect it against filter action.

#### 12.11.2. Activating the filter

This filter is found in the image window menu under Filters → Map → Warp. This filter has no Preview.

#### 12.11.3. Options

Afbeelding 17.275. Warp filter options

Basic Options

Step size

  “Step” is displacement distance for every filter iteration. A 10 value is necessary to get a one pixel displacement. This value can be negative to invert displacement direction.

Iterations

  The number of repetitions of effect when applying filter.

On edges

  Because of displacement, a part of pixels are driven over the borders of layer or selection, and, on the opposite side, pixels places are emptying. Four following options allow you to fix this issue:

  Wrap

    What goes out on one side is going into the opposite side (this is the default).

  Smear

    Emptying places are filled with a spreading of the neighbouring image line.

  Black

    Emptying places are filled with black color.

  Foreground color

    Emptying places are filled with the Foreground color of the color area in Toolbox.

Displacement map

  To be listed in this drop-down list, the displacement map, which should be a grayscaled image, must be present on your screen when you call filter and must have the same size as the original image.

Advanced Options

Dither size

  Once all pixels displaced, this option scatters them randomly, giving grain to the image. The higher this value (0.00-100.00), the thinner the grain.

  Afbeelding 17.276. With a 3.00 dither size:

Rotation angle

  This option sets displacement angle of pixels according to the slope direction of gradient. Previous examples have been created with a vertical gradient and a 90° angle: so, pixels were displaced horizontally and nothing went out of the image borders. Here is an example with a 10° angle and 6 iterations:

  Afbeelding 17.277. With a 10° angle and 6 iterations:

  Displacement is made according to a 10° angle against vertical. Pixels going out the lower border on every iteration are going into through the upper border (Wrap option checked), giving a dotted line.

Substeps

  If you specify a value > 1, the displacement vector is computed in several substeps, giving you a finer control to the displace process.

Magnitude map

  In addition to displacement map, you can add a Magnitude map. This map should also be a grayscaled image, with the same size as the source image and which must be present on your screen when you call filter. This map gives more or less strength to filter on some parts of the image, according to the grey levels of this magnitude map. Image areas corresponding to white parts of this map will undergo all the strength of filter. Image areas corresponding to black parts of the map will be spared by filter. Intermediate grey levels will lessen filter action on corresponding areas of the image. Use magnitude map must be checked for that.

  Afbeelding 17.278. Magnitude Map example:

  From left to right: original image, displacement map, magnitude map, after applying “Warp” filter. You can see that the black areas of magnitude map prevent filter to take action.

More Advanced Options

These extra options let you add two new maps, a gradient map and/or a vector map.

| Opmerking
To test these options alone, you must use a map with a solid color for all the other maps.

Gradient scale

  Using a gradient map, (this map should also be a grayscaled image), the displacement of pixels depends on the direction of grayscale transitions. The Gradient scale option lets you set how much the grayscale variations will influence the displacement of pixels. On every iteration, the filter works of the whole image, not only on the red object: this explains blurredness.

  Afbeelding 17.279. Gradient scale example

  From left to right: original image, Gradient map, filter applied.

  In the example above, “Warp” filter is applied with a gradient map (Gradient scale = 10.0). Gradient is oblique, from top left to right bottom. The part of the image corresponding to the gradient is moved obliquely, 90° rotated (Rotation angle 90° in Advanced Options).

Vector mag

  With this map, the displacement depends on the angle you set in the Angle text box. 0° is upwards. Angles go counter-clockwise. The vector control map determines by how many pixels the image will move on every iteration.

  Afbeelding 17.280. Vector mag example

  From left to right: original image, displacement map, filter applied.

  In the above example, “Warp” filter is applied with a Vector mag. Gradient is vertical, from top to bottom. Vector angle is 45°. The image is moved obliquely, 45° to the top left corner. The image is blurred because every iteration works on the whole image, and not only on the red bar.

Angle

  Angle for fixed vector map (see above).

12.10. Tile |  | 13. Rendering Filters

Report an error in Bugzilla