Documentation
Chapter 03

Tools

The toolbar on the left contains 58 tools in 20 groups. Here you'll learn what each tool is for, which options the options bar shows for it, and how to use it with clicks, drags and modifier keys.

Choosing and setting up tools

Each button in the toolbar stands for a group of related tools. A click selects the tool of the group you used last. You reach the other tools with a right-click on the button: a list with all the tools in the group and their shortcuts drops down.

Right-clicking a tool group shows Object Selection, Quick Selection and Magic Wand
Right-clicking a tool group shows all the tools in the group with their shortcuts.

Above the canvas is the options bar. It shows the name of the active tool on the left, followed by its settings. To the right of these, a short usage hint appears in gray text – it's worth a look when you use a tool for the first time.

Keyboard shortcuts

  • A letter selects the main tool of its group, e.g. B the Brush.
  • ⇧ + letter selects the second tool in the group; if a tool of the group is already active, it cycles to the next one (e.g. ⇧ M through all the marquees).
  • ⌥ J selects the Patch tool directly, ⌥ O the Sponge.
  • [ and ] make the tool tip smaller and larger.
  • The number keys 1 … 9 set the opacity to 10 … 90%, 0 to 100%.
  • D resets the foreground and background colors to black and white, X swaps them, Q turns the Quick Mask view on and off (see Selections).
  • Holding down the Space bar lets you pan the view with any tool.

All tools at a glance

GroupToolsShortcut
MoveMoveV
MarqueesRectangular Marquee, Elliptical Marquee, Single Row Marquee, Single Column MarqueeM, ⇧ M
LassoLasso, Polygonal Lasso, Magnetic LassoL, ⇧ L
Selection by contentObject Selection, Quick Selection, Magic WandW, ⇧ W
CropCrop, Perspective Crop, Slice; plus FrameC, ⇧ C; Frame K
MeasuringEyedropper, Ruler, Count, NoteI, ⇧ I
HealingSpot Healing Brush, Remove (AI), Healing Brush, Patch, Content-Aware Move, Red EyeJ, ⇧ J, ⌥ J
PaintingBrush, Pencil, Color Replacement, Mixer Brush, Adjustment BrushB, ⇧ B; Pencil N
StampsClone Stamp, Pattern StampS, ⇧ S
HistoryHistory Brush, Art History BrushY, ⇧ Y
ErasersEraser, Background Eraser, Magic EraserE, ⇧ E
FillGradient, Paint BucketPaint Bucket G, Gradient ⇧ G
SharpnessBlur Brush, Sharpen, SmudgeR, ⇧ R
ExposureDodge, Burn, SpongeO, ⇧ O, ⌥ O
PensPen, Freeform Pen, Curvature PenP, ⇧ P
TypeType, Vertical Type, Horizontal and Vertical Type MaskT, ⇧ T
Path selectionPath Selection, Direct SelectionA, ⇧ A
ShapeShape (rectangle, rounded rectangle, ellipse, polygon/star, line)U
ViewHand, Rotate ViewH, ⇧ H
ZoomZoomZ

Move

The Move tool (V) moves the selected and linked layers. If there is a selection, it moves only the selected pixels. Layer masks move along with their layers, and a selected group moves all its layers. Type, shape and Smart Object layers are always moved as a whole.

  • Dragging moves; holding ⇧ while dragging keeps the movement horizontal or vertical.
  • Holding ⌥ while dragging (without a selection) moves copies of the layers; the originals stay where they are.
  • If guides are shown and not locked, you move them with this tool.

The options bar contains buttons for aligning the selected layers (left, center, right, top, middle, bottom) and for distributing them (horizontal and vertical centers, horizontal and vertical spacing). More on this in the chapter Layers.

The Move tool with align and distribute buttons in the options bar
The Move tool: align and distribute are in the options bar.

Selection tools

The selection tools are explained in detail in the chapter Selections. Here is a summary of how to use them.

All marquee, lasso and Magic Wand tools have the buttons New, Add, Subtract and Intersect in the options bar, plus the Feather field (0–250 px). Instead of using the buttons, you can also hold keys: ⇧ adds, ⌥ subtracts.

Rectangular Marquee and Elliptical Marquee

Drag out a rectangle or an ellipse. The Single Row and Single Column tools select, with one click, a row one pixel high or a column one pixel wide across the whole image.

Lasso, Polygonal Lasso and Magnetic Lasso

  • Lasso: Drag freely around the area you want; when you release, the shape closes.
  • Polygonal Lasso: Each click sets a corner; the edges between them are straight.
  • Magnetic Lasso: Click on the edge of an object and guide the pointer along it; the line follows the strongest edge nearby.

With the Polygonal and Magnetic Lasso, Return closes the shape, ⌫ takes back the last corner and Esc discards the outline.

A four-sided selection made with the Polygonal Lasso over the church
Corners set with the Polygonal Lasso make a straight-edged selection.

Object Selection, Quick Selection and Magic Wand

  • Object Selection: Drag a rectangle around an object; Chromatelier selects the object inside it. With the Object Finder option, a local AI model outlines the objects it recognizes, and a click selects one of them (you install the model under Preferences › Local AI, see AI on Your Computer). Sample All Layers takes the whole image into account instead of only the active layer.
  • Quick Selection: Paint over the area; the selection grows to similar colors and stops at edges. ⌥ subtracts. You set the Size in the options bar or with [ / ].
  • Magic Wand: A click selects similar colors. Tolerance (0–255) determines how similar; Contiguous limits the selection to connected pixels; Sample All Layers reads the composite image.
Options bar of Object Selection with Object Finder
Object Selection: selection mode, Sample All Layers and Object Finder.
Options bar of Quick Selection with Size
Quick Selection: tip size and Sample All Layers.

Crop, Slice and Frame

Crop

With the Crop tool (C) you drag out the area you want to keep. Outside it, the image is darkened. Holding ⇧ while dragging forces a square. You apply the crop with Return, a double-click inside the frame or the ✔ Apply crop (Enter) button; Esc or ✖ Cancel (Esc) discards it.

When Content-Aware is turned on, you may drag the frame beyond the edge of the image (up to twice the image size). The new edges are then filled in from the image.

Crop frame over the photo, darkened outside
The crop frame: whatever lies outside it is darkened.

Straightening and cropping a photo

  1. Choose the Ruler tool (⇧ I, or right-click the Eyedropper).
  2. Drag a line along an edge that should be horizontal (or vertical), such as the horizon or a cornice. The options bar shows the angle A and the length L.
    Ruler tool: measuring line over the image, values and the Straighten Layer button in the options bar
    The measuring line and its values in the options bar.
  3. Click Straighten Layer. The layer rotates so that the line is horizontal or vertical.
  4. Choose the Crop tool (C) and drag a frame inside the image so that no empty corners remain in it. Alternatively, turn on Content-Aware and let the corners be filled in.
  5. Press Return.

Perspective Crop

This tool straightens a rectangle photographed at an angle – a sign, a picture on the wall, a facade. First drag out a rectangle, then drag its four corners onto the corners of the object. A grid shows the perspective. The options bar gives the size of the result in pixels; Return applies, Esc cancels.

Perspective Crop: quadrilateral with corner points and grid over the church facade
Perspective Crop: you drag the corners onto the edges of the object.

Slice

The Slice tool divides the image into pieces for the web. Drag a rectangle for each slice; ⌥-click deletes the slice under the pointer. The options bar shows the number of slices, creates a grid from the existing guides with Slices From Guides and removes all of them with Clear Slices. File › Export › Save for Web… then writes one file per slice (see Saving, Export & Printing).

Frame

The Frame tool (K) draws placeholders that you put an image into later. In the options bar choose Rectangular Frame or Elliptical Frame and drag it out. An image goes inside when you drag a file onto the frame, or when you choose Layer › Frames › Place Image in Frame… with the frame active. More commands are under Layer › Frames (see Layers).

Eyedropper, Ruler, Count and Note

ToolHow to use itOptions bar
EyedropperA click (or drag) picks up the foreground color, ⌥-click the background color.only the hint
RulerDragging measures distance and angle, with ⇧ in 45° steps.X, Y, W, H, angle A, length L (in the scale's unit if a measurement scale is set); Straighten Layer, Clear
CountEach click places a numbered marker, ⌥-click removes the nearest one.Number of markers, Clear
NoteA click places a note, clicking a note opens it, dragging moves it, ⌫ deletes the open note.Author, Color, Clear All, Show Notes

You write the text of a note in the Window › Information › Notes panel; there you can also page between the notes with ◀ and ▶. The measurement scale, scale markers and recording measurements are under Image › Analysis.

Eyedropper with the hint Click = foreground, Alt+Click = background
The Eyedropper picks up the foreground and background colors.
Note tool with Author, Color and a note placed on the image
Note tool: Author and Color in the options bar, the note as a small icon in the image.

The brush engine

All the painting tools – Brush, Pencil, the erasers, the stamps, History Brush, the healing brushes, Blur Brush, Sharpen, Smudge, Dodge, Burn, Sponge and others – share the same brush engine and the same basic options in the options bar:

OptionMeaning
SizeDiameter of the tip in pixels (1–2000 px). Also with [ and ].
Hardness0 = soft edge, 1 = hard edge (not for the Pencil, which always paints hard).
OpacityThe maximum coverage of a stroke. Also with the number keys.
FlowHow much paint each dab applies; areas you paint over become denser (not for the Pencil and Smudge).
SpacingThe distance between dabs relative to the size.
Smoothing0–100%: steadies shaky strokes (Brush, Pencil, Eraser).
🦋 SymmetryBrush, Pencil and Eraser also paint mirrored: Off, Vertical, Horizontal, Dual Axis, Diagonal, Radial and Mandala (2–12 segments), each around the center of the image.
Brush Settings…Opens the window with all the settings of the tip (F5).

A ⇧-click connects the clicked point to the end of the last stroke with a straight line.

Options bar of the Brush with Size, Hardness, Symmetry, Opacity, Flow, Spacing and Smoothing
The Brush options bar.

Brush Settings

You open the Brush Settings window with F5, the Brush Settings… button in the options bar, or via View › Show › Brush Settings. At the bottom, a preview shows what a stroke looks like with the current settings.

The Brush Settings window with Brush Tip Shape and the sections Shape Dynamics, Scattering, Color Dynamics, Transfer
The Brush Settings: the brush tip shape at the top, the sections you can switch on below it.

Brush Tip Shape: Size (up to 5000 px), Hardness (for a round tip), Angle (−180° to 180°), Roundness (1–100%) and Spacing (1–1000%). If a sampled tip is active, Use a round tip brings back the round one.

You switch the following sections on with the checkbox in front of their names:

SectionSettings
Shape DynamicsSize Jitter with Minimum Diameter, Angle Jitter, Roundness Jitter with Minimum Roundness, Flip X Jitter, Flip Y Jitter
ScatteringScatter (0–1000%), Both Axes, Count (1–16), Count Jitter
Color DynamicsApply Per Tip, Foreground/Background Jitter, Hue, Saturation and Brightness Jitter
TransferOpacity Jitter, Flow Jitter
TexturePattern, Scale, Depth, Brightness, Contrast, Mode (Multiply or Subtract), Invert
Dual Brusha second tip (Round or Current Tip) that masks the stroke: Size, Spacing, Scatter, Count, Both Axes
Wet Edgesthe stroke is denser at its edges, like watercolor

Each jitter value has a Control: Off, Pen Pressure, Fade (over a number of dabs you choose) and, for the angle, also Direction (the tip turns with the direction of the stroke).

Pressure sensitivity with a pen

With a graphics tablet or a pressure-sensitive pen, Chromatelier reads the pressure. With a mouse, every stroke paints at full pressure. You decide what the pressure controls in the Brush Settings: for Size Jitter, Opacity Jitter or Flow Jitter, set the Control to Pen Pressure. The presets Hard Round Pressure Size, Soft Round Pressure Opacity and Airbrush Soft are already set up this way.

Brush presets and ABR brushes

The Window › Brushes panel shows the presets as stroke previews. A click makes a preset the current brush. Among the included presets are Hard Round, Soft Round, Calligraphic Flat, Chalk, Spatter, Scattered Leaves and Grass.

  • New Preset saves the current brush with all its settings.
  • Import… loads brushes from an .abr file; the status bar reports how many were added.
  • Settings… opens the Brush Settings.
  • You delete presets of your own with a right-click › Delete Brush.

To create a brush tip of your own from the image, use Edit › Presets › Define Brush Preset: the selected area (or the whole image) becomes the tip, and dark pixels paint.

Using brushes from an ABR file

  1. Show the Brushes panel via Window › Brushes.
  2. Click Import… and choose the .abr file.
  3. The new brushes appear at the end of the list. Click one and paint with the Brush tool (B).
  4. If needed, adjust the size and spacing with F5 and save the result with New Preset.

Healing tools

The healing group (J) removes spots, distractions and red eyes. Other retouching commands such as Content-Aware Fill are described in the chapter Retouching & Transforming.

ToolEffect
Spot Healing BrushPaint over a blemish; when you release, the stroke is filled from the surroundings.
Remove (AI)Paint over what should disappear; a local AI model repaints the spot. Without an installed model it works like the Spot Healing Brush – the Install the AI model… button in the options bar downloads it.
Healing Brush⌥-click sets the source; after that you copy from there, and the color is matched to the target area.
PatchDraw around the damaged area (the tool draws like a lasso) and drag the selection onto a clean area: the area is repaired from there.
Content-Aware MoveDraw around an object and drag it to a new place. Move mode: the old spot is filled from the surroundings. Extend mode: the original stays, and the copy is blended in.
Red EyeClick into the red of the pupil. Options: Pupil Size and Darken Amount.
Spot Healing Brush with a portrait
Spot Healing Brush: just paint over the blemish.
Remove (AI) with the Install the AI model button
Remove (AI): without a model, the options bar offers to install it.

Removing a spot with the Spot Healing Brush

  1. Choose the Spot Healing Brush with J.
  2. Zoom in close to the spot (⌘ + or the Zoom tool).
  3. Set the size with [ and ] so that the tip is a little larger than the spot.
  4. Click the spot or paint over it in a short stroke. When you release, Chromatelier fills the area from its surroundings.
  5. If you don't like the result, take it back with ⌘ Z and try again with a smaller stroke.

Repairing a larger area with the Patch tool

  1. Choose Patch with ⌥ J.
    Patch tool with a hint in the options bar
    The Patch tool explains how to use it in the options bar.
  2. Draw around the damaged area with the mouse button held down.
  3. Click inside the selection and drag it onto a clean area with a similar texture.
  4. Release: the original area is repaired with this texture and its color is matched. Deselect with ⌘ D.
Content-Aware Move with the Move and Extend modes
Content-Aware Move: Move or Extend mode.

Brush, Pencil and related tools

  • Brush (B) paints soft or hard strokes with the foreground color.
  • Pencil (N) always paints with a hard edge, without anti-aliasing – good for pixel art.
  • Color Replacement replaces the hue, saturation, color or luminosity of similar pixels under the tip with the foreground color (Mode). Tolerance sets how similar; with Sample Once, only the color at the first click counts.
  • Mixer Brush mixes the foreground color with the color in the image: Wet (how much image color is picked up), Load (paint supply) and Mix, each in percent.
  • Adjustment Brush paints an adjustment into the image: the first stroke creates an adjustment layer with a black mask, each stroke paints the mask white, with ⌥ black. Under Adjustment you choose Brighten, Darken, Increase Contrast, Decrease Contrast, Saturate, Desaturate, Warm, Cool, Black & White or Invert. Afterwards you change the layer's values in the Properties panel.
Mixer Brush with Wet, Load and Mix
Mixer Brush: Wet, Load, Mix.
Adjustment Brush with the Brighten adjustment
Adjustment Brush: the adjustment is painted in as an adjustment layer.

Clone Stamp and Pattern Stamp

The Clone Stamp (S) transfers parts of the image from a source to another spot without adjusting the color. The Pattern Stamp (⇧ S) paints a pattern that you choose in the options bar under Pattern; you create patterns of your own with Edit › Presets › Define Pattern….

Clone Stamp with a portrait and the hint Alt+Click sets the source
The Clone Stamp needs a source first (⌥-click).

Retouching with the Clone Stamp

  1. Choose the Clone Stamp with S. To work non-destructively, create a new, empty layer first.
  2. Set a suitable Size and a low Hardness so that the edges blend softly.
  3. Hold down ⌥ and click a clean spot that will serve as the source. The status bar confirms the position.
  4. Paint over the spot that should disappear. During the stroke, the source moves in parallel with the brush; each new stroke starts again at the source you set.
  5. If needed, set a new source with ⌥-click so that no patterns repeat.

With the Healing Brush, setting the source works the same way; it also matches the copied pixels to the color and brightness of the target area.

History Brush and Art History Brush

The History Brush (Y) paints an earlier state of the image back in – namely the state you marked with 🖌 in the History panel. This lets you take back a filter in individual spots.

The Art History Brush paints stylized strokes in the colors of that state. Style offers Tight Short, Tight Medium, Tight Long, Loose Medium, Loose Long, Dab, Tight Curl, Tight Curl Long, Loose Curl and Loose Curl Long; Area (1–500 px) determines how far the strokes spread, Tolerance (0–100%) where painting happens.

Art History Brush with Style, Area and Tolerance
Art History Brush: Style, Area and Tolerance.

Erasers

  • Eraser (E) makes pixels transparent. It has the same options as the Brush, including Smoothing and Symmetry.
  • Background Eraser erases only pixels that resemble the color under the center of the tip – ideal for separating a subject from a plain background. Options: Tolerance, Sample Once.
  • Magic Eraser erases all similar pixels with one click, the way the Paint Bucket fills. Options: Tolerance, Opacity, Contiguous, Sample All Layers.
Options bar of the Eraser
The Eraser has the Brush's options.

Paint Bucket and Gradient

Paint Bucket

The Paint Bucket (G) fills similar pixels with the foreground color in one click. Options: Tolerance (0–255), Opacity, Contiguous and Sample All Layers. For fills with a pattern or a content-aware fill, use Edit › Fill….

Gradient

With the Gradient tool (⇧ G) you drag a line: its start and end determine where the gradient begins and ends. ⇧ keeps the line in 45° steps.

OptionMeaning
Linear, Radial, Angle, Reflected, DiamondShape of the gradient
ReverseColors in reverse order
Livecreates a gradient fill layer that stays editable on the canvas: drag its ends and color stops, ⇧-click the line to add a stop, ⌥-click a stop to give it the foreground color, drag a stop away to remove it
OpacityCoverage of the gradient
Gradient fieldA click opens the Gradient Editor
Gradient Presets ⏷List of saved gradients
Options bar of the Gradient tool with shapes, Reverse, Live, Opacity and the gradient field
The Gradient tool's options bar.

The Gradient Editor

Clicking the gradient field opens the Gradient Editor window. The Presets are at the top; a click applies one of them. Below them you edit the current gradient:

  • Gradient Type: a gradient made of color stops, or Noise – a random gradient with Roughness, Color Model with ranges, Restrict Colors, Add Transparency and Randomize.
  • Below the color ramp are the color stops. A click below the ramp adds one, dragging moves it, dragging it down and away removes it.
  • For the selected stop you set the Color (Foreground, Background or Custom), Location and Opacity. Delete Stop removes it (at least two remain).
  • With Name and New you save the gradient as a preset. You delete presets of your own with a right-click › Delete Gradient.
The Gradient Editor window with Presets, Name, Gradient Type, color ramp and the settings of the color stop
The Gradient Editor with presets, color ramp and the settings of the selected color stop.

Creating a gradient

  1. Create a new layer so that the gradient doesn't overwrite the photo.
  2. Choose the Gradient tool with ⇧ G and, in the options bar, the shape, e.g. Linear.
  3. Click the gradient field. In the editor, click the left color stop, choose Custom and a color; do the same with the right one.
  4. Click below the color ramp to add a third color in the middle, and set its Location.
  5. Enter a Name, click New to save the gradient as a preset, and close with OK.
  6. On the canvas, drag from the start point to the end point. Hold ⇧ if the line should be exactly horizontal or vertical.

A gradient you want to change later belongs in a gradient fill layer: turn on Live or choose Layer › New Fill Layer › Gradient… (see Layers).

Blur Brush, Sharpen and Smudge

  • Blur Brush (R) softens the areas you paint over.
  • Sharpen increases sharpness there – use it sparingly, or noise appears.
  • Smudge smears the color in the direction of the stroke; Strength (0–1) determines how far.

All three have the basic options of the brush engine.

Dodge, Burn and Sponge

  • Dodge (O) lightens the areas you paint over.
  • Burn (⇧ O) darkens them.
  • Sponge (⌥ O) reduces saturation.

The Exposure option (0.01–1) determines how strongly each stroke works. A low exposure and several strokes give the most natural results.

Dodge with Exposure in the options bar
Dodge with the Exposure option.

Type, pens, path selection and shapes

These tools create type, shape and path objects that stay editable. They are described in detail in the chapter Type, Shapes & Paths:

  • Type, Vertical Type, Horizontal and Vertical Type Mask (T)
  • Pen, Freeform Pen and Curvature Pen (P)
  • Path Selection and Direct Selection (A)
  • Shape (U) with rectangle, rounded rectangle, ellipse, polygon/star and line

Hand, Rotate View and Zoom

  • Hand (H): dragging pans the view. With the Space bar held down, this works with any tool.
  • Rotate View (⇧ H): dragging rotates the view like a sheet of paper on a drawing table – the image itself stays unchanged. ⇧ rotates in 15° steps. In the options bar you enter the exact Rotation Angle; Reset View or Esc straightens it again.
  • Zoom (Z): a click zooms in at the clicked spot, ⌥-click zooms out. ⌘ + scrolling or the two-finger gesture also works everywhere.
Rotated view of the photo with Rotation Angle in the options bar
Rotate View turns only the display; the rotation angle is shown in the options bar.

You'll find more about navigation in the chapter Interface.