4.13. The Cage Tool
| 4. Transform Tools |

### 4.13. The Cage Tool

Figure 14.160. The Cage Tool in the Toolbox

The Cage tool is a special transforming tool allowing you to select the transforming area by setting anchor points by free hand drawing similar to the way you do it with the Free Selection (Lasso) tool. The tool adds nothing to the image until you confirm the transformation by pressing the Enter key.

#### 4.13.1. Activating the Tool

You can activate the Cage tool in several ways:

- From the image-menu, through: Tools → Transform Tools → Cage Transform

- by clicking on the tool icon: in the toolbox

- or by using the Shift G keyboard shortcut.

#### 4.13.2. Tool Options

Figure 14.161. Cage Tool options

Normally, tool options are displayed in a window attached under the Toolbox as soon as you activate a tool. If they are not, you can access them from the image menu bar through Windows → Dockable Windows → Tool Options which opens the option window of the selected tool.

Create or adjust the cage

  When activating the Cage Tool this option is selected. You can now click in the image to make anchor points around the desired area. If you need to add anchor points at a later stage, you click on this option.

Deform the cage to deform the image

  GIMP switch to this option automatically when the cage outline is finished. Now you are able to drag the anchor points around in the image and even outside it to transform the picture. The transforming starts when you release the mouse button.

  You can activate more than one anchor point by holding down the Shift key while clicking on the points. You can also select more points by holding down the mouse button while drawing a rectangle around the desired points.

Fill the original position of the cage with a plain color

  If the transforming action results in empty areas these areas will be filled with color if this option is checked. It looks like the color is picked from the start pixel of the cage line.

#### 4.13.3. Using “Cage” tool

Figure 14.162. Cage Tool example

The cage area selected
Transformed

When clicking on the cage icon in the toolbox the cage option is set to “Create or adjust the cage”. You are now able to draw a cage outline in the image by successively clicking around the area you want to transform. Click on the starting point to finish the selection. GIMP will then do some mathematics and activate the “Deform the cage to deform the image” to allow you to drag the points on the line to deform the cage and the image.

The selected point(s) turns to a square. Drag the points around in the image to transform it. The transforming will occur every time you release the press on the mouse button. The transforming may take some time so be patient especially when working with large images.

If you desire to add more points to the line you have to select the “Create or adjust the cage” in the tool options dialog. Put the points on the line and switch back to the “Deform the cage to deform the image” to transform the image or layer.

When the work is done, press the Enter key to confirm it.

4.12. Flip |  | 4.14. Warp Transform

Report a bug in GIMP Report a documentation error