Distort Image with Image displaces the content of an image layer accordingly to the content of another image, the so-called displacement matrix. Each pixel of the displacement matrix defines, how far the corresponding pixel of the image layer will be displaced. A 0 in the displacement matrix is the maximum negative displacement, 255 is the maximum positive displacement and 128 means no displacement at all. The displacement matrix can have one channel (i.e. a gray image) or several (i.e. a RGB image). If it has only one channel, the content of this channel will be used for both x- and y-displacement. If there are several channels, the first one is used for the x-direction and the second one is used for the y-direction.
The displacement matrix can be loaded from a file and can be pasted from the clipboard as well. Ideally it is as large as the image layer. If it isn‘t, it can be scaled to the size of the image layer or be repeated like the tiles of a pattern.
At the image borders sometimes pixels from outside the image have to be read. In this case Replace means, that those pixels are read from the other side of the image. Using Repeat the corresponding border pixel will be repeated.
Intensity controls the maximum displacement. 100% utilizes the full displacement of -128 to +127 pixels.