Alla Prima PrimerUser Guide Open the app

Alla Prima Primer — User Guide

Contents
  1. Welcome
  2. Getting started
  3. 1 · Reference
  4. 2 · Adjust
  5. 3 · Analyze
  6. 4 · Value
  7. 5 · Notan
  8. 6 · Temperature
  9. 7 · Simplify
  10. 8 · Drawing
  11. 9 · Form & modeling
  12. 10 · Edges
  13. 11 · Color mixing
  14. 12 · Color check
  15. 13 · Proportion check
  16. A painting session, start to finish
  17. Limits and troubleshooting

Welcome

Alla Prima Primer turns a reference photo into a plan for an alla prima oil painting, then checks your painting against it. It answers the questions you ask before and during a session: is the reference good enough, what are the big shapes, where do the values split, which colors are warm or cool, how does the light turn each form, which edges stay hard, and how do you mix each color.

Alla prima oil painting

Alla prima is Italian for "at the first attempt". An alla prima oil painting is painted wet-into-wet, usually in a single session, instead of being built up in layers that dry between sittings. Each stroke goes down close to its final value, color and edge and is meant to stay, so the thinking happens before the brush touches the canvas: the design, the value plan, the mixes and the order of work. Painters also call it direct painting, or au premier coup in French.

Working wet-into-wet has its own order, and the app follows it:

The 13 modules run in the order you paint. You can use them in any order, but each one builds on the crop you make in Reference and the edits you make in Adjust.

#ModuleThe question it answersWhen to use it
1ReferenceIs this a good reference, cropped to my canvas?First, every time
2AdjustDo the lights and shadows hold detail, and is the color true?Right after cropping
3AnalyzeWhich colors make this picture, and how do I mix them?Choosing your palette
4ValueWhere does each value fall, and how do the values describe the light?Planning the values
5NotanDoes the light-and-shadow design read?Before you draw
6TemperatureWhere is it warm or cool, in the lights, midtones and shadows?Planning mixes and toning the canvas
7SimplifyWhat are the big shapes, and in which layer do I paint each one?Planning and during the block-in
8DrawingWhere do the lines, angles, proportions and shadow shapes go?Drawing on the canvas
9Form & modelingHow does the light turn each form, as value planes, and which brush lays each stroke?Planning the modeling and brushwork
10EdgesWhich edges are hard, soft or lost?Before and while refining
11Color mixingWhat do I premix, and what do I add for light and shadow?Setting up the palette
12Color checkHow do I mix this exact color, and is my mix right?At the easel
13Proportion checkIs my painting on track?During and after painting

Two conventions run through the app. Value is on the Munsell scale, 0 (black) to 10 (white), except where steps are numbered: the 10-step value chart runs from 1 (darkest) to 10 (lightest), and the Five-value notan from 1 to 5. Mixes are modeled from the photo, so treat every recipe as a starting point and judge the final color by eye under your painting light.

Everything runs on your device. Photos are never uploaded, and projects are saved in the browser on the device you use.

Getting started

Open a photo, crop it to your canvas in Reference, fix the photo in Adjust, set your palette in Paints, then work down the module list. The app saves as you go.

The Alla Prima Primer window, with its seven parts numbered
The Alla Prima Primer window, with its seven parts numbered
#PartWhat it does
1Top barOpen, Library, Paints, Timer, Guide and Save view are always here. Guide opens this User Guide. On wider screens the project name shows too; tap it to rename the project.
2Module listThe 13 modules in painting order. On a phone or tablet it becomes a strip you swipe sideways.
3StageYour reference as the current module sees it. Tap to read a color; drag to fine-tune with the magnifier.
4Hold to compare, Mirror, SquintHold to flash the photo (or hold the space bar). Mirror flips the picture so you see the design fresh. Squint blurs the view the way half-closed eyes do: small details drop away and the big value masses show. It also gives an idea of how the painting will look with its brushstrokes blended, the way strokes merge when you step back from the easel.
5ZoomPinch or scroll to zoom. Drag with two fingers, or with the right mouse button, to move around. The middle button fits the picture again.
6Legend and readoutWhat the colors and marks mean in this view. On the right: value, hue and temperature of the last color you tapped.
7PanelThe controls and results for the module. Back and Next at the bottom walk you through the modules in order.

Open a reference

Set your palette first

Every recipe in the app uses only the paints switched on in Paints, so set this before you look at any mixes. Pick a starting palette, then tap paints to add or remove them. Tap Save changes to apply them: until you do, the footer reads "Unsaved changes", and Cancel leaves your palette as it was. If you close the window with unsaved changes, it warns you first; close it again to discard them. Your palette is kept in this browser and used by every project.

Paints with one paint switched on and not yet saved, Library and Session timer
Paints with one paint switched on and not yet saved, Library and Session timer
Starting palettePaints
Standard studioTitanium White, Cadmium Yellow Light, Yellow Ochre, Cadmium Red Light, Alizarin Crimson, Ultramarine Blue, Burnt Sienna, Viridian, Ivory Black
Limited four-color (Zorn)Titanium White, Yellow Ochre, Cadmium Red Light, Ivory Black
Split primaryTitanium White, Cadmium Lemon, Cadmium Yellow Light, Cadmium Red Light, Quinacridone Rose, Ultramarine Blue, Phthalo Blue
Earth & ultramarineTitanium White, Yellow Ochre, Burnt Sienna, Burnt Umber, Ultramarine Blue, Cadmium Red Light
Expanded warm & coolTitanium White, Cadmium Lemon, Cadmium Yellow Light, Indian Yellow, Cadmium Red Light, Terra Rosa, Alizarin Crimson, Permanent Rose, Transparent Oxide Red, Viridian, Cobalt Blue, Ultramarine Blue

The full list has 26 paints, including Indian Yellow and Permanent Rose. To add a paint you own, use Add your own paint: a name in the form "Brand Name / Color Name", its color and its tinting strength. Strong paints such as phthalos and dioxazine are 2 to 3; earths are about 0.8. For the color, photograph a thick swatch, pick it in Color check and copy the hex code. Then tap Save changes.

Timer and saving

On a phone or tablet

The same app on an iPad and on a phone
The same app on an iPad and on a phone

The layout stacks: modules across the top, the stage, then the panel. Scroll down for the controls. The iPad shows Simplify's block-in layer with Paint thickness; the phone shows Notan with the lights in color.

The app runs in any modern browser on a phone, tablet or computer. Install it to open it full-screen from your home screen, paint offline, and use the live camera in Proportion check. The installed app includes this guide, so Guide opens it even offline. Open the app's web address first, then:

  1. On iPhone or iPad, in Safari, tap Share, then Add to Home Screen.

  2. On Android, in Chrome, choose Install app, or use the install button in Library.

  3. On a Mac or PC, click the install icon at the right of the Chrome or Edge address bar.

Keyboard shortcuts

KeyAction
Space (hold)Show the photo
MMirror
SSquint
+ / − / 0Zoom in, zoom out, fit
Alt + → / Alt + ←Next or previous module
Ctrl + Z or ⌘ + ZUndo the last measurement in Drawing
EscClose a dialog

1 · Reference

Reference crops your photo to the shape of your canvas and helps you judge whether the photo is worth painting from. Use it first on every project, because every other module works on this crop.

Reference: a 9 × 12 in (23 × 30 cm) landscape canvas, the crop at 90%, rule of thirds and armature lines
Reference: a 9 × 12 in (23 × 30 cm) landscape canvas, the crop at 90%, rule of thirds and armature lines

Start with a good reference. Alla prima leaves no time to invent what the photo doesn't show, so every decision at the easel rests on the reference. Choose a photo with defined light and shadow: one main light, a clear shadow side and readable cast shadows.

Then check the extremes. The darkest shadows should still hold some detail rather than solid black, and the brightest lights some texture rather than blank white. If either fails, go to Adjust, the next module, to recover the shadows and highlights, set exposure and contrast, and correct the color temperature.

When: at the start of each project, and again whenever you change canvas size or rethink the composition.

How:

  1. Open a photo, or tap Use the sample.

  2. Under Canvas, choose a Size. Every size shows inches and centimeters, such as 9 × 12 in (23 × 30 cm), and metric canvases such as 30 × 40 cm are listed too. Then choose Landscape or Portrait, or Photo proportions to keep the photo's own shape.

  3. Set Crop size and drag on the photo to move the crop. The label on the frame shows the canvas size.

  4. Under Guides, choose a Grid and read the note beneath it. It gives the grid positions on your real canvas, for example "the thirds fall at 4 in (10.2 cm) and 8 in (20.3 cm) across, 3 in (7.6 cm) and 6 in (15.2 cm) down."

  5. Turn on Show guides in every module to keep the grid while you work in other modules.

GuideUse it to
Rule of thirdsPlace the focal point near a third line or where two cross.
Golden sectionMake a quieter, more classical placement, at 38% and 62%.
SquaresTransfer the drawing square by square. The note gives the square size on your canvas.
Equal divisionsSplit both sides into 2 to 12 equal parts for transferring proportions.
Diagonals & armatureCheck the main diagonals and lines of movement through the rectangle.

Tips:

2 · Adjust

Adjust edits the reference before you plan the painting, so the photo shows defined light and shadow with detail left in the darks and the lights. The edits carry through every module.

Adjust on the sample: Highlights −60, Shadows +35, Clarity +20 and Temperature −10, with the value histogram
Adjust on the sample: Highlights −60, Shadows +35, Clarity +20 and Temperature −10, with the value histogram

When: right after you crop, before any planning. Come back if a later module shows a problem, such as a notan that breaks into specks or temperatures that don't match what you saw.

GroupToolWhat it does
LightExposureBrightens or darkens the whole photo, in camera stops from −2 to +2.
LightContrastSpreads the values apart, or pulls them closer together.
LightHighlightsPull left to bring back detail in the lights; push right to brighten them.
LightShadowsPush right to open the darks; pull left to deepen them.
ColorTemperatureWarms (right) or cools (left) the whole photo, to undo the camera's white balance.
ColorSaturationMutes (left) or intensifies (right) every color.
DetailClarityAdds or removes contrast in the midtones, so forms read with more or less punch.
DetailDetailSharpens fine texture (right), or smooths it away (left) when a photo is too busy to paint.

Every slider except Exposure runs from −100 to +100. Highlights and Shadows work locally, so edges and texture stay intact.

Check the range:

Before: clipped lights in red and clipped darks in blue. After Highlights −60, Shadows +35 and Clarity +20, nothing clips
Before: clipped lights in red and clipped darks in blue. After Highlights −60, Shadows +35 and Clarity +20, nothing clips
  1. Turn on Show clipped shadows (blue) and highlights (red). Pure black turns blue on the stage, and pure white turns red.

  2. Read the note under the histogram. For the sample it says "3% is pure white: pull Highlights down to recover the lights."

  3. Adjust until the note reads "The shadows and the highlights both hold detail, a good range to paint from." For the sample, Highlights −60 and Shadows +35 did it: the values now run from about 1.5 to 8.3 instead of 0.6 to 10.

Compare and reset: hold Hold to compare to see the photo as it was taken. Double-click a slider to set it back to zero, and Reset all clears every edit. The legend under the stage lists your edits.

Tips:

3 · Analyze

Analyze lists the colors that build the picture, with a starting mix for each, and lets you pick any color into your own palette.

Analyze: a color tapped on a lit petal of the bird of paradise, with its recipe in the panel
Analyze: a color tapped on a lit petal of the bird of paradise, with its recipe in the panel

When: before you squeeze out paint, to choose the palette and understand the key. Come back whenever you need to know what a color is and how to mix it.

What it tells you:

Every color shows its value (0 to 10), temperature, chroma, share of the picture and a recipe. Tap a swatch to see where that color sits in the picture; tap + to keep it.

The three Show views: Photo, Key colors and Color range
The three Show views: Photo, Key colors and Color range
ShowWhat you see
PhotoYour crop, with D and A labels where each dominant and accent color occurs.
Key colorsThe picture repainted in only the colors found. Colors to find sets how many (6 to 16).
Color rangeA color wheel: hue around the ring, chroma outward. The dashed line is the gamut of this reference, and D and A mark the dominant and accent colors. The key to these marks is under the Show buttons.

Extract a color:

  1. Tap the image. Drag to fine-tune with the magnifier.

  2. The card shows the color's name, value, hue, chroma, temperature and hex code, a value bar, and a starting recipe with up to two alternatives. For the lit petal: light vivid orange, value 7.6, "5½ parts Cadmium Yellow Light + 1½ parts Cadmium Red Light + 1 part Titanium White", an 88% match.

  3. Tap Add to my colors to collect it, or Copy hex.

  4. Under My colors, Save palette card saves a PNG of your picks with recipes. Save CSV saves them as a list. Clear needs a second tap.

Reading a recipe: parts are by volume on your knife, and "a touch" is a knife-tip. The percentage is the modeled match: 88% and up is a close match, 76% to 87% is near (adjust by eye), and 75% or less means the color is outside this palette's reach. Add a paint in Paints if a color you need keeps scoring low.

4 · Value

Value shows the reference in values only, from black to white, underneath the photo. It groups the values into as few steps as you like, and a 10-step chart finds any value on the picture.

Value: the sample with its full range of values underneath, and the lights (values 7 to 10) picked on the 10-step chart
Value: the sample with its full range of values underneath, and the lights (values 7 to 10) picked on the 10-step chart

When: after Adjust, before Notan. Value carries an alla prima painting: if the values are right, the colors can shift and the picture still reads.

ShowWhat you see
Photo + valuesThe photo with the same picture in values underneath, or beside it on a portrait canvas.
Values onlyThe values alone, filling the stage. Hold Hold to compare to flash the photo.

Value steps: the slider runs from 2 steps to full. At full you see every value in the picture, like a black-and-white photo. Slide left to group the picture into fewer values across its own range: few steps give a clear block-in, and more steps show how the forms turn.

The sample at full range, 10 values, 5 values and 3 values
The sample at full range, 10 values, 5 values and 3 values

10-step value chart: ten gray squares from 1 (darkest) to 10 (lightest), each marked with its share of the picture.

  1. Tap a square to see where that value sits: everything else on the stage darkens. Tap more squares to add them, and tap a lit square again to remove it.

  2. Lights, Halftones and Shadows pick every square in that value family of this picture at once. Clear shows the whole picture again.

  3. Tap the photo to read the value of any spot. Its square lights up on the chart.

The lights (values 7 to 10), halftones (4 to 6) and shadows (1 to 3) of the sample, each picked on the chart
The lights (values 7 to 10), halftones (4 to 6) and shadows (1 to 3) of the sample, each picked on the chart

How values describe light: the panel names where each family sits in your reference. For the sample, the shadows are in values 1–3 (23% of the picture), the halftones in 4–6 (66%) and the lights in 7–10 (11%).

Light falls on a form as a sequence of values. The planes facing the light are lightest, the planes turning away step down through the halftones, and the shadow side and cast shadows are darkest. Keep each family together when you mix, so the darkest light stays lighter than the lightest shadow.

Value range: the histogram shows how much of the picture sits at each value. The ochre lines mark where the shadows, halftones and lights divide.

Tips:

5 · Notan

Notan reduces the picture to two, three or five flat values, so you can judge the light-and-shadow design before you think about color.

Two, three and five values on the Yellowstone landscape
Two, three and five values on the Yellowstone landscape

When: after Value and before you draw. If the design doesn't read in two or three values, change the crop or the lighting before you paint. At the easel, use it to decide which value family a passage belongs to.

ValuesUse it for
TwoThe big design: light shapes against shadow shapes.
ThreePlanning the block-in as darks, middle values and lights.
FiveThe full value plan. 1 (black) and 5 (white) are reserved for small accents, 3 is middle gray (about Munsell 5), and the picture is built in 2, 3 and 4.

Views: three ways to see the same families.

Black & white, Lights in color and Shadows in color, at three values
Black & white, Lights in color and Shadows in color, at three values
ViewWhat you see
Black & whiteFlat grays, the classic notan.
Lights in colorThe photo's color only where the light falls; everything else flat.
Shadows in colorThe photo's color only in the shadows, so you can see the color shifts inside them.

Balance: where the splits fall.

  1. Leave Automatic on to start. It finds the best split for this photo.

  2. To change the design, move a split slider; this switches to manual. Two values have one slider, Light / shadow. Three values have Shadow edge and Light edge. Five values have 2 | 3 split and 3 | 4 split.

  3. With five values, Black accents and White accents set the most of the picture that may be pure black or pure white, from none to 10%.

Split values use the Munsell scale, 0 black to 10 white.

The five-value panel for the Yellowstone landscape: splits, accent limits, smoothing and the value bar
The five-value panel for the Yellowstone landscape: splits, accent limits, smoothing and the value bar

Smoothing: Off shows every speck of the photo, Subtle merges small fragments, and Strong gives big, simple shapes for the first block-in.

Reading the results:

Tips:

6 · Temperature

Temperature maps where the picture runs warm or cool, and compares the temperature of the lights, midtones and shadows. That relationship is what makes painted light believable.

The Yellowstone landscape in the three views: Warm / cool, By value family and Within each family
The Yellowstone landscape in the three views: Warm / cool, By value family and Within each family

When: after Notan, while you plan mixes and choose a toned ground. At the easel, use Spot check when a passage has the right value but still looks wrong; the temperature is often off.

ViewWhat you see
Warm / coolOrange is warm, blue is cool and gray is neutral. The stronger the color, the stronger the temperature. Values are kept, so the picture still reads.
By value familyShadows, midtones and lights, each painted in its average temperature: a temperature notan.
Within each familyWarmer (orange) or cooler (blue) than the average of its own family. This finds the subtle shifts that turn a form, such as a cool plane in the lights or warm reflected light in a shadow.

The All, Shadows, Midtones, Lights buttons show one family in color and gray out the rest. Strength exaggerates the display from subtle to strongest; it doesn't change the analysis.

Temperature by value for the Yellowstone landscape, with the toning suggestion below
Temperature by value for the Yellowstone landscape, with the toning suggestion below

Temperature by value names the pattern and what to do about it:

Below the summary, each family shows its value range, its share of the picture, its most common color, a warm-to-cool bar and its split of warm, neutral and cool.

Toning the canvas suggests a ground near your midtone value, with a recipe to thin into a wash. A warm picture gets a cool blue-gray ground so the warm notes glow where it shows through; a cool picture gets a warm sienna or ochre; a balanced one gets a warm neutral. For the cool Yellowstone landscape, it suggests a warm sienna or ochre ground at about value 6.2.

Spot check: tap any spot. The note tells you its family, its value and whether it's warmer or cooler than the rest of that family, such as "This spot is in the midtones (value 6.2) and reads cool — cooler than the average of the midtones."

Tips:

7 · Simplify

Simplify turns the reference into flat shapes you can block in, then splits them into three layers, each painted with its own brush and its own thickness of paint.

The three styles: Clusters, Poster and Geometric
The three styles: Clusters, Poster and Geometric

When: while planning the block-in, then at the easel through the session: layer 1 guides the block-in of the masses, layer 2 the modeling of the forms and layer 3 the details.

StyleWhat it doesGood for
ClustersSnaps every area to one of a few key colors, with smooth edges, like a flat illustration. The most faithful simplification.A color map of the whole picture, painted shape by shape.
PosterBold value steps crossed with hue families, like a screen print.Strong value grouping and design.
GeometricEvery shape reduced to a straight-sided polygon.An angular, constructive block-in.

Look: how the shapes are painted.

The same shapes as Flat and as Paint thickness
The same shapes as Flat and as Paint thickness
LookWhat you see
FlatClean, flat shapes, so you read the design before you think about paint.
Paint thicknessThin, transparent paint in the shadows, opaque paint in the midtones, and thick paint in the lights, thickest on the highlights.

Paint in layers:

Layer 1 block-in masses with a large flat, layer 2 modeling form with a medium filbert and layer 3 details with a small round, each layer's new shapes outlined
Layer 1 block-in masses with a large flat, layer 2 modeling form with a medium filbert and layer 3 details with a small round, each layer's new shapes outlined
  1. All shows every shape and counts them. The sample has 48: 13 to block in the masses, 12 to model the forms and 23 details.

  2. 1 · Block-in masses shows only the big shapes. Paint them with a large flat (square) brush, about ⅞ in (2 cm) wide on the sample's 12-inch-wide canvas, in thin, lean paint. Scrub the shadow shapes in with transparent color, and get the value and temperature of every big mass right before any detail.

  3. 2 · Modeling form outlines the new shapes and grays out the ones already done. Paint them with a medium filbert, about ⅜ in (1 cm) wide, in opaque paint: the halftones and the local color of each form, laid into the wet block-in where the form turns. The filbert's rounded tip blends one value into the next without a hard ridge. Keep the shadows thin.

  4. 3 · Details adds the last shapes with a small round, about ⅛ in (4 mm) wide, in thick, opaque paint for the lights, thickest on the highlights. Place the darkest accents last.

The brush widths scale with the canvas size you choose in Reference. Outline what's new in this layer draws a thin ochre line around the shapes each layer adds. Under the buttons, the layer list repeats each layer's brush and paint; with Paint thickness on, it adds a key: shadows thin and transparent so the toned ground shows through, midtones opaque, and lights thick enough to hold the brushmark.

Simplify with layer 2 · Modeling form selected: its new shapes outlined, and the layer list with a large flat, a medium filbert and a small round
Simplify with layer 2 · Modeling form selected: its new shapes outlined, and the layer list with a large flat, a medium filbert and a small round

Adjust:

ControlEffect
ColorsHow many colors the shapes use, 3 to 16 (not in Poster).
Value stepsPoster only: 3 to 8 value steps.
SimplifyMerges small shapes. Higher gives fewer, bigger shapes.
Big shapes ≥The smallest size, as a percentage of the picture, that still counts as a block-in shape. Raise it for fewer layer-1 shapes.
StraightnessGeometric only. Higher gives fewer, straighter sides.
Outline the shapesDraws an outline around every shape.

Colors in this view lists the swatches used, largest first. Tap a swatch or a shape to isolate it, and tap again to show everything. The readout under the stage gives the shape's value, hue and temperature.

Tips:

8 · Drawing

Drawing shows the reference in straight lines or as contour lines, in four stages: the envelope, the masses, the shadow map and the edges. It also has tools that measure angles and positions on your real canvas.

The two styles at stage 2: Straight-line and Contour line
The two styles at stage 2: Straight-line and Contour line

When: as you draw on the canvas, before any paint goes on. Keep the drawing light and simple: in alla prima the paint does the finishing.

StyleWhat it showsUse it for
Straight-lineEvery curve as a few long straight lines, the way you block in with a brush and thinned paint on a toned canvas. Straight lines are easy to measure against a plumb or level line.Drawing directly with the brush, and placing shapes with correct angles and proportions.
Contour lineClean, continuous contours, with heavier lines on the stronger edges.Tracing, or printing at canvas size.

Stages: both styles draw in four stages.

A straight-line drawing in four stages: envelope, masses, shadow map and edges
A straight-line drawing in four stages: envelope, masses, shadow map and edges
  1. 1 · Envelope: the outer shape of each big mass with as few lines as possible. Check its height against its width before you go on.

  2. 2 · Masses: the envelope divided into the big masses of light and shadow and the main color shapes. The envelope stays faint underneath.

  3. 3 · Shadow map: the shadow shapes alone, everything in the dark value family, as one design. They follow the photo closely, with a subtle smoothing that cleans up ragged edges but keeps thin shapes, so you still see the true shape of every shadow. Mass them in with a thin, transparent wash before you paint the lights.

  4. 4 · Edges: the finished drawing. The contours are corrected inside each mass; hard edges are firm and dark, soft edges light, and lost edges are left open so shapes can merge.

Outline shadow map appears with stage 3 and traces the edge of every shadow shape. Draw these outlines first with a small brush and thinned paint, then fill the shapes in. Mark measuring points (Straight-line, stages 1, 2 and 4) marks the corners where lines meet, as landmarks to measure between.

Stage 3, the shadow map, with Outline shadow map on
Stage 3, the shadow map, with Outline shadow map on

Line (Contour line): Follow traces color edges or value edges, Skip short lines drops fragments, and Line weight and Heavier lines on stronger edges set how the lines look.

Photo underneath fades the photo in beneath the drawing, up to 70%. Save PNG saves a large image. Save SVG — prints to size saves a drawing sized to your canvas: print it at 100% and transfer it.

Measure: choose a tool, then draw on the image.

Measuring: an angle line set as the unit, a second angle measured in units, a plumb line, a level line and a point, listed in the panel
Measuring: an angle line set as the unit, a second angle measured in units, a plumb line, a level line and a point, listed in the panel
ToolHowYou get
AngleDrag between two points.The angle, such as "rises 83° to the right (7° off vertical)", and the line's length on your canvas, such as 3.5 in (9 cm). Hold your brush handle at that angle to transfer it.
PlumbTap.A vertical line and its distance from the left edge. See what lines up above and below.
LevelTap.A horizontal line and its distance from the top. Compare heights across the picture.
PointTap a landmark.Its position on the canvas, such as "7.4 in (18.9 cm) across, 1.4 in (3.4 cm) down".

Tap Unit beside any angle line to make it the unit of measure. Every other line then shows its length in units, such as "0.68 units". This is comparative measuring, the painter's way to check proportions: in the sample, the flower stands about two-thirds as tall as its beak is long.

Undo removes the last mark, ✕ removes one, and Clear all starts again. With the tool set to Off, dragging moves around a zoomed picture.

Tips:

9 · Form & modeling

Form & modeling shows how the light models each form in three notes of its own local color, breaks the picture into value planes from flat to volume, and previews the picture painted with flat, filbert and round brushes.

Light & shadow on the singing flycatcher: each local color in three notes, with the lit sphere and the list of local colors
Light & shadow on the singing flycatcher: each local color in three notes, with the lit sphere and the list of local colors

When: after the drawing, before you load the brush. Decide how each form turns from light into shadow, plane by plane, and which brush lays each passage.

Light & shadow: every form turns from light into shadow. This view repaints each local color in three notes of its own: the light, the local color in the halftone, and the shadow. Lay in the shadows first with thin paint, then the local color, then the lights with thicker paint.

The sphere at the top of the panel shows the same turn on a simple form, painted in the reference's main local color:

On the sphereWhere it isHow to paint it
HighlightThe small spot that mirrors the light source.Last, in the thickest paint, in one touch.
LightThe planes facing the light.Thick, opaque paint, lighter than the local color.
Local colorThe halftone, where the form begins to turn.Opaque, the object's own color at its strongest.
Core shadowThe darkest band, where the form turns away from the light.Thin paint; it sets the edge between light and shadow.
Reflected lightLight bounced back into the shadow side.Thin, and always darker than any light.
Cast shadowThe shadow the form throws, darkest where it touches.Thin and transparent, with its hardest edge at the contact.

Value planes: look for the value changes, and treat each one as a flat plane. Slide Flat ↔ volume through eight steps: from two planes up to eight, then a smooth turn.

The flycatcher's value planes: flat, four planes, eight planes and volume
The flycatcher's value planes: flat, four planes, eight planes and volume
SettingWhat you see
FlatEvery form in two planes, light and shadow, like a poster. Get this right first; it carries the painting from across the room.
3 planesThe light, one halftone where the form turns, and the shadow.
4 planesThe light, two halftones and the shadow. The plane breaks show where each form turns.
5 planesThe light, three halftones and the shadow. Enough for most forms in a one-session painting.
6 planesA finer turn, like facets cut into a gem. Lay each plane as one stroke of one mixture.
7 planesThe halftones begin to read as a gradation. Save this many for the focal point, where a form turns slowly.
8 planesClose to a smooth turn. Few alla prima paintings need this many; study how the values change, then paint fewer, bigger planes.
VolumeThe planes melt into a smooth turn. Paint the planes first, then soften the breaks where the form is round and keep them where it is angular.

Brushwork preview: the picture painted in three passes: 1 · Big brush blocks in the masses, 2 · Medium models the forms, and 3 · Small does the finishing and details. It's a suggestion of how the strokes could go down, not a copy. Repaint with new strokes lays them down again.

The flycatcher in three passes with All: 1 · Big brush, block-in masses; 2 · Medium, modeling; 3 · Small, finishing and details
The flycatcher in three passes with All: 1 · Big brush, block-in masses; 2 · Medium, modeling; 3 · Small, finishing and details

Brush chooses the brush for every pass:

The flycatcher painted with each brush choice: Flat, Filbert, Round and All
The flycatcher painted with each brush choice: Flat, Filbert, Round and All
BrushStrokesUse it for
FlatStraight strokes with square ends and hard edges. Inside a plane they lie along the plane; on an edge they cut along it.Blocking in the masses, laying the planes and crisp edges.
FilbertA flat brush with an oval tip: broad strokes with a rounded start, softer corners and a streaky end where the brush lifts. They wrap around the form.Modeling the turn of a form and blending one plane into the next.
RoundCurving strokes that taper to a point as the brush lifts, with soft, feathered edges.Soft turns, lines and details.
AllA big flat blocks in the masses, a medium filbert models the forms (with a flat on the hard edges), and a small round finishes the details.Most alla prima paintings: the usual order of brushes, from big to small.
Close-ups of the first pass: the flat's square ends and hard edges, the filbert's rounded tip and softer corners, and the round's tapered, soft strokes
Close-ups of the first pass: the flat's square ends and hard edges, the filbert's rounded tip and softer corners, and the round's tapered, soft strokes
The Brushwork preview panel: the Brush choice, the three passes and the brushes for your canvas
The Brushwork preview panel: the Brush choice, the three passes and the brushes for your canvas

Tips:

10 · Edges

Edges traces the real edges of the photo and colors each one hard, firm, soft or lost, then circles the area where the hardest edges cluster: a natural focal point.

Edges on the bird of paradise, with the hard-edge cluster circled and the edge mix in the panel
Edges on the bird of paradise, with the hard-edge cluster circled and the edge mix in the panel

When: before you paint, to plan where edges stay crisp. Come back in the refining stage, the last third of the session, to decide where to soften or lose them.

Line on the imageEdgeHow to paint it
Orange-redHardA crisp break in value or color. Lay the stroke along the edge, or cut in with the next shape.
YellowFirmClear but not sharp. One light pass wet-into-wet.
Blue, with a soft glowSoftA gradual turn. Drag the brush across the edge, or blend once with a clean brush.
Gray, dottedLostTwo shapes of nearly the same value. Paint across them as one shape.

How it reads the photo: every line follows an edge traced in the photo, where the value or color changes. Each edge is graded by how quickly it changes: a sudden break is hard, a gradual turn is soft, and a change too small to see is lost.

The singing flycatcher and its edges
The singing flycatcher and its edges

On the flycatcher, hard edges run along the silhouette against the out-of-focus background, the branch and the tail. Firm edges mark turns inside the bird, such as where the white throat meets the yellow breast, and the background itself has no edges at all.

Controls:

Edge character shows the share of each type, with advice. For the sample (61% hard, 23% firm, 15% soft, 1% lost): "Mostly hard edges. Lots of hard edges can look cut-out: soften the ones away from the focal point."

How to use it: keep your hardest edges and strongest contrast at the focal point. Soften edges in shadow and toward the borders, and lose an edge where two shapes share a value. In alla prima, make the edge as you lay the stroke rather than blending afterwards.

Tips:

11 · Color mixing

Color mixing gives each color family a base midtone recipe, then tells you what to add to that base for its light and its shadow. Every mix in a family stays related, which is what holds an alla prima painting together.

Color mixing: the Orange family selected, with its light (L), base (B) and shadow (S) sample points on the flower
Color mixing: the Orange family selected, with its light (L), base (B) and shadow (S) sample points on the flower

When: while you set up the palette, to premix your bases as piles. At the easel, whenever you need the light or shadow version of a color.

Find the families:

Read a family card:

LineWhat it tells you
Light, Base, Shadow stripThe three colors measured from the photo.
Base · midtoneThe recipe for the base pile, with its match percentage.
LightWhat to add to 1 part base for the light, such as "2 parts Titanium White + 1 part Cadmium Yellow Light" for the orange petals.
ShadowWhat to add to 1 part base for the shadow, such as "a touch of Ivory Black + a touch of Viridian".
HalftoneMix the base and shadow piles about 1 : 1.
Closer without the shared mixtureAppears when Unify is on and this family's own addition would match better than the shared light or shadow mixture. Use it where the exact color matters more than unity.

Show where highlights the family on the image, with L, B and S where its light, base and shadow were sampled. Lock this base adds the family to your plan.

Mixing plan:

The mixing plan with Unify on: one light mixture and one shadow mixture for all three bases
The mixing plan with Unify on: one light mixture and one shadow mixture for all three bases
  1. Lock the base of every family that matters: the big masses and the main objects.

  2. Turn on Unify: one light mixture and one shadow mixture for every base. For the sample, the light mixture is Titanium White + Cadmium Yellow Light (2:1) and the shadow mixture is Ivory Black + Viridian (3:1).

  3. Premix the two mixtures, then each locked base as its own pile.

  4. Paint each area from its base pile. Add light mixture for the lights and shadow mixture for the shadows; mix base and shadow for the halftones.

  5. Save plan card saves the plan as an image to keep beside your palette. × removes a base; Clear plan needs a second tap.

Tips:

12 · Color check

Color check gives a recipe for any color, from your reference, another photo or a hex code. It can also borrow the color mood of another reference, and check the mix on your knife against the target.

Color check: a blue picked from the Yellowstone photo, added as a color reference, with its recipe
Color check: a blue picked from the Yellowstone photo, added as a color reference, with its recipe

When: at the easel, whenever you need one exact color. Also when another image has color you want to learn from: a color study, a landscape you painted from life, a sunset.

Match a color:

  1. Under Match from, choose My reference or a color reference. Add one with Add a color reference…, or Photograph a color with the camera. The × on a thumbnail removes it.

  2. Tap the image to pick a color, and drag to fine-tune with the magnifier. Or type a hex code under Or enter a color.

  3. The Matched color card gives the color's name, value, hue, chroma, temperature and hex code, with a recipe from your palette.

  4. Palette of this source lists the source's main colors with recipes. Add all to my colors copies them into My colors in Analyze.

In the illustration, the blue of the distant mountains in the Yellowstone photo is a mid, strong blue-violet at value 6.2. The best Standard studio mix, 9 parts Titanium White + 4 parts Ultramarine Blue + 1 part Viridian, scores only 55%, outside this palette's reach. That's the cue to add a paint in Paints.

Borrow its color harmony: shown when a color reference is selected.

My reference, the Yellowstone color reference, and the bird of paradise with that harmony borrowed at 80%
My reference, the Yellowstone color reference, and the bird of paradise with that harmony borrowed at 80%

Raise Strength to recolor your main reference in the other image's color mood. Every module then plans in the new colors, and a "Color harmony borrowed" badge shows on the stage. Set Strength back to off to return to the original colors.

Use it to audition a palette before you paint. In the illustration, the Yellowstone's pale, cool winter light turns the bird of paradise lighter and bluer.

Check my mix:

Check my mix: the target, the photographed mix and the verdict
Check my mix: the target, the photographed mix and the verdict
  1. Set a target by tapping the reference or entering a color.

  2. Put a dab of your mix on the palette knife, next to a white card, in your painting light.

  3. Turn on Tap a white card first, then tap Photograph my mix.

  4. Tap the white card, then tap the mix.

  5. Read the verdict: the match percentage, how many values too light or dark, whether it's too warm, too cool, too intense or too grayed, and what to add.

In the illustration, the target is the lit orange of a petal: "Your mix is 0.6 values too dark. It's too grayed (chroma 54 vs 73). Try adding a good amount of Cadmium Yellow Light." A good mix reads "That's a match — paint it."

Tips:

13 · Proportion check

Proportion check lines up a photo of your painting with the reference, then ghosts, flickers, wipes or differences the two so drawing and value mistakes stand out.

Align the corners, Ghost, Wipe and Difference. In this painting the flower head was painted too big and too far to the right
Align the corners, Ghost, Wipe and Difference. In this painting the flower head was painted too big and too far to the right

When: at natural pauses. Check after the drawing, after the block-in and before the final accents. A proportion error found at the drawing stage costs a minute; found at the end, it can cost the painting.

With a photo of your painting (the most precise way):

  1. Choose Photo of my painting, then Take photo or Choose photo…. Shoot straight on, in even light, with all four corners of the canvas in the frame.

  2. Drag the four handles (TL, TR, BR, BL) onto the corners of your canvas, using the magnifier. Tap Compare. Adjust corners brings the handles back.

  3. Choose how to compare.

CompareWhat it doesBest for
GhostLays the reference over your painting. The Reference slider sets how strongly it shows.Seeing shapes that don't line up.
FlickerSwaps painting and reference about every two-thirds of a second.Letting movement show you the shifts.
WipePainting on the left, reference on the right. Drag across the image to move the divide.Checking one edge or value side by side.
DifferenceLights up whatever differs; dark means it matches.Finding every mistake at once.

Difference options:

Difference in Shapes mode, with the numbered list of the biggest differences
Difference in Shapes mode, with the numbered list of the biggest differences

With the live camera (in the installed app, or wherever your browser allows the camera):

  1. Choose Live camera, tap Start camera and point it at your painting.

  2. The reference appears as a ghost over the live picture. Drag to move it, pinch or scroll to size it, and twist with two fingers to rotate it until it lines up.

  3. Set Compare to Difference. Mistakes light up and matching areas go dark, live, as you move.

  4. Freeze & align corners captures the frame and switches to the photo method for exact corner alignment.

Tips:

A painting session, start to finish

Plan with eight modules before you start the timer; at the easel, the Timer's four phases tell you which module to open next.

One session, module by modulePlanbefore the timerReference · AdjustAnalyze · ValueNotan · TemperatureSimplify · Color mixingBlock-infirst 20%Drawing stages 1–31 · Block-in massesLarge flat brushModeling20% to 70%2 · Modeling formMedium filbertColor checkRefine70% to 93%Edges3 · DetailsSmall round brushAccentslast 7%Values 1 and 10Analyze accentsThen stopCheck shapesCheck valuesCheck color
A painting session · 5 phases, 3 proportion checks

The diamonds are Proportion check stops: shapes after the block-in, values after the modeling, color before the accents.

Before you paint:

  1. Reference: choose the canvas size and crop, and check that the photo is a good reference.

  2. Adjust: recover clipped shadows and highlights, and correct the color.

  3. Analyze: note the key and the main colors; confirm your palette in Paints.

  4. Value: find the values of the lights, halftones and shadows.

  5. Notan: make sure the design reads in two or three values.

  6. Temperature: find the light-and-shadow pattern. Tone the canvas with the suggested ground, ideally ahead of time so it's touch-dry.

  7. Simplify: check that layer 1 is a handful of big shapes.

  8. Color mixing: lock the bases, turn on Unify, and premix the light mixture, the shadow mixture and a pile of each base. Save the plan card.

At the easel (start the Timer):

  1. Block-in, first 20%: draw the envelope and the masses (Drawing stages 1 and 2) in thin paint, then mass in the shadow map (stage 3) with a thin, transparent wash. Block in the masses with Simplify's layer 1 and a large flat brush. Run a Proportion check on Shapes and fix the drawing now.

  2. Modeling, to 70%: model the forms with Simplify's layer 2 and a medium filbert, in opaque paint laid into the wet block-in, taking every light and shadow from its base pile. Turn each form with its value planes. Use Color check and Check my mix for any color you're unsure of. Check Values.

  3. Refine, to 93%: sharpen edges at the focal point and soften or lose the rest, then add layer 3's details with a small round and thicker paint in the lights. Check Color.

  4. Accents, last 7%: place the darkest darks and brightest lights (values 1 and 10 on the value chart), the highlights in the thickest paint, and the accent colors at the focal point. Then stop.

At any point, hold Hold to compare to see the photo, tap Squint to see the big masses and how your strokes will blend, or tap Mirror to see your painting's design fresh.

Limits and troubleshooting

The app works from a photo, so treat its numbers as an informed starting point and let your eye make the final call.

What to keep in mind:

ProblemFix
The photo looks flat, or the lights or darks are blankIn Adjust, pull Highlights down and push Shadows up, then add Contrast. Turn on the clipping display to check.
Recipes use paints you don't haveOpen Paints and switch off what isn't on your palette.
One color always scores lowIt's outside your palette's reach. Add a paint that can get there, such as a stronger red or blue.
The notan breaks into small piecesSet Smoothing to Strong, or try Three values.
Simplify's layer 1 has too many shapesRaise Big shapes ≥ or Simplify.
Edges shows too many or too few linesChange Shapes (Big, Middle or Fine) or Sensitivity.
Measurements or brush widths show percentagesChoose a canvas size in Reference.
Difference lights up everywhereTap Adjust corners and realign, shoot straight on in even light, or lower Sensitivity.
Check my mix seems offTurn on Tap a white card first and keep the card in your painting light.
The live camera won't startAllow camera access in your browser settings. If it is still blocked, use Photo of my painting instead.
A save does nothingApprove the save prompt if your browser shows one, then look in your browser's downloads.
A project is missingOpen the same browser on the same device. Otherwise, reopen the photo to start again.