prism docs · Designing · The canvas

The canvas

The canvas is the big picture in the middle of Design. It shows your surfaces as the projector sends them out, or over the photo of your room after a scan. You select, move and reshape surfaces here, zoom in to line edges up to the pixel, and undo anything with Ctrl + Z.

WhereDesign, the middle of the screen
Two viewsCamera (after a scan) and Projector
Zoom25 % to 1600 %: the mouse wheel, + and -
ModeSimple everything on this page
Advanced the projector switch and +, the Input view
1 · The Design screen 2 · Camera view and Projector view 3 · Zoom and pan 4 · Select surfaces 5 · Move and reshape 6 · A surface under another one 7 · Nudge with the arrow keys 8 · Outlines, masks and names 9 · Undo and redo 10 · Right-click menus 11 · Hints and tips 12 · When something looks wrong 13 · Mouse and keyboard

1The Design screen

Design has four parts. You work on the canvas in the middle; everything else is about what you select there.

The Design screen with the surfaces list, the canvas and the inspector
Left: the Surfaces list. Middle: the canvas with its tool bar on top and the strip for scenes and cues underneath. Right: the inspector, here showing the selected Poster. The lime outline and round corner handles mark the selection.

The canvas tool bar

The canvas tool bar: Add, P1 and plus, Camera and Projector, Input, Outlines and the zoom control
From the left: Add, the projector switch P1 and +, the Camera | Projector switch (after a scan), Input, Outlines and the zoom control.
ButtonWhat it does
AddAdds a shape at once, ready to drag onto your object. See Shapes.
P1 +Advanced Chooses which projector you are designing for, or adds one. Simple mode shows the switch only when a project has two or more projectors. See Several projectors.
Camera ProjectorSwitches the view (next section). Only there after a scan.
InputAdvanced Opens the Input view: which part of a picture each surface shows. See Position, fit and input mapping.
OutlinesShows or hides the faint outlines of the surfaces (section 8).
MasksOnly there when this projector has masks. Shows or hides the masks' dashed outlines.
− 68% +Zooms out and in. The percentage opens a menu with Fit to window, 100 % and Zoom to selection.

2Camera view and Projector view

The canvas can show your design two ways.

  1. Press Camera or Projector in the canvas tool bar. You can also right-click the canvas ▸ View ▸ Camera view or Projector view.
  2. Edit in either view: a corner dragged in the camera view lands on the same spot of the real object in the projector view.
The camera view: the scan photo with the surfaces over it and a hatch outside the projector's picture
Camera view: the room as the phone saw it. The selected face of a box has lime corners; the hatch shows where the projector can't reach.
The projector view of the same surfaces
Projector view of the same scene: the picture the projector sends, straight on.
Which view when? Use the camera view to see your surfaces on the real objects without walking to the wall. Use the projector view to line up edges to the pixel, and for 3D objects: their handles only show in the projector view.
Remembered. Your choice of view is kept in this browser. Each view also keeps its own zoom and position while the project is open.

3Zoom and pan

Zoom in to place corners exactly; zoom out to see the whole picture. Handles, labels and outlines keep their size on screen at any zoom, and edges stay sharp.

To…Do this
Zoom in or outTurn the mouse wheel over the canvas: it zooms about the pointer. Or press + and -, or use the − and + buttons.
Zoom on a trackpadPinch, or hold Ctrl while you scroll. (Ctrl + wheel always zooms.)
Pan (slide the picture)Hold Space and drag, or drag with the middle mouse button. On a trackpad, scroll with two fingers. Shift + wheel pans sideways.
See everythingCtrl + 0 or Shift + 1 (Fit to window).
Zoom to what you selectedShift + 2 (Zoom to selection).
One pixel per pixelCtrl + 1 (100 %): one projector pixel (camera view: one camera pixel) per screen pixel.
Touch screenPinch and pan with two fingers.
The zoom control's menu
Click the percentage for Fit to window, 100 %, Zoom to selection, Zoom in and Zoom out.
The canvas zoomed in on a surface's corner
Zoomed in on a corner: the handle keeps its size, and the edge is drawn at screen resolution.
A quick tap of Space is GO. In Design, Space plays the next scene or cue (unless a button or tab has the focus: then Space presses it). Over the canvas it only turns into the hand when you hold it and drag; a quick tap still fires GO when you let go.
You can't lose the picture. Zoom runs from 25 % to 1600 %, and at least a strip of the picture always stays in view. Press Ctrl + 0 to fit it back.

4Select surfaces

  1. Click a surface to select it. Its outline turns lime, its corners or points get handles, and the inspector shows its settings.
  2. Shift-click or Ctrl-click (⌘-click on a Mac) another surface to add it to the selection. Do it again to take it out.
  3. Click an empty spot or press Esc to select nothing. The inspector then shows the project's settings.
Two surfaces selected, with a dashed box and corner squares around them
Two surfaces selected: a dashed lime box surrounds them, the list shows 2 selected with buttons for both, and the inspector sets the blend of both at once (2 surfaces).

5Move and reshape

To…Do this
Move a surfaceDrag inside it. Hold Shift to keep the move straight (across or up and down).
Reshape itDrag a corner or point handle. Shift keeps the handle's move straight (a circle's box stays square). See Shapes.
Move severalSelect them, then drag any one of them. They move together as one undo step.
Scale severalDrag a corner square of the dashed box. They scale about the opposite corner; Shift keeps their proportions.
Surfaces are independent. Moving one never moves another, even where they touch or overlap. Group them when you want them to move together (Surfaces list and groups).

6A surface under another one

A big surface, such as a wall, often sits under smaller ones. You can still drag it by pressing on a spot that another surface covers.

  1. Select the lower surface: click its row in the Surfaces list, or click it where nothing covers it.
  2. Hover over it. Where another surface is on top, the canvas shows the name of the surface a drag would move: the selected one.
  3. Press inside it and drag. The selected surface moves, not the one on top.
The Wall selected while the pointer is over the Poster on top of it
The Wall is selected (lime outline). The pointer is over the Poster, which sits on top, yet the label reads WALL: a drag here moves the Wall.
A click still picks the top one. Press and let go without dragging and you select the surface on top instead. To pick from a stack, right-click ▸ Select ▸ Under the cursor: it lists every surface under the pointer.

7Nudge with the arrow keys

The arrow keys move the selection by 1 projector pixel; Shift + arrows move it by 10. The step is the same at any zoom, so zoom in to watch small moves.

8Outlines, masks and names

The canvas marks your surfaces so you can find their edges even when their looks are dark. These switches change what it marks; none of them changes what the projector shows.

9Undo and redo

Almost everything you do in prism can be undone: moves, shapes, looks, settings, groups, deletes. Each gesture is one step, so a whole drag undoes in one go.

  1. Press Ctrl + Z to undo, and Ctrl + Shift + Z (or Ctrl + Y) to redo. Or use the curved arrows in the top bar.
  2. Hover an arrow to see what it will undo, for example Undo: move Door (Ctrl+Z).
  3. A note at the top of the canvas says what was undone.
The note Undone: move Door at the top of the canvas
The undo and redo arrows sit next to the project name; the note Undone: move Door confirms the step.
History. prism keeps the last 150 steps while a project is open, and starts afresh when you open it again. While you type in a text field, Ctrl + Z undoes the typing instead.

Right-click anything for what you can do with it: the empty canvas, a surface, a point, an edge, a row of the list, a layer. On a touch screen, press and hold. From the keyboard, press Shift + F10 or the Menu key.

The canvas menu with its View submenu open
Right-click an empty spot: Add shape, Add mask, 3D object, Group selection, Align the projection…, Paste here, Select all, View, undo, redo and the keyboard shortcuts. View holds zoom, the two views, Outlines, Surface names and the preview quality.

11Hints and tips

12When something looks wrong

You seeWhyFix
The wheel slides the picture instead of zoomingA trackpad, or a smooth-scrolling mouse, scrolls rather than clicks, so prism pans.Hold Ctrl while you scroll, pinch, or press + and -.
A surface can't be clickedIt is locked, or in a locked group: clicks go through it.Unlock it with the padlock in its row of the list.
A click selects the wrong surfaceAnother surface is on top there.Select the one you want in the list, then drag; or right-click ▸ Select ▸ Under the cursor.
Pressing Space played a cueSpace is GO in Design. Over the canvas a quick tap still fires it.Hold Space and drag to pan, or drag with the middle mouse button.
There's no Camera buttonThe camera view needs a scan; projects drawn by hand only have the projector view.Scan the room (Setup ▸ Scan), or keep working in the projector view.
The arrow keys move one corner, not the shapeA point has the focus since you last pressed it.Press inside the shape, or press Esc once.
The picture is off to one side or tinyYou zoomed or panned away.Ctrl + 0 fits it back.
Ctrl + Z changed some text insteadThe cursor was in a text field.Click the canvas, then undo.

13Mouse and keyboard

ActionHow
SelectClick · Shift- or Ctrl-click to add or remove · Ctrl + A all · Esc none
Select a groupAlt-click a member (keep holding to drag the group)
MoveDrag inside · Shift keeps it straight · arrows 1 px · Shift + arrows 10 px
ZoomMouse wheel · Ctrl + wheel or pinch · + = in · - out
Fit · 100 % · selectionCtrl + 0 or Shift + 1 · Ctrl + 1 · Shift + 2
PanSpace + drag · middle-button drag · two-finger scroll · Shift + wheel sideways
Undo · redoCtrl + Z · Ctrl + Shift + Z or Ctrl + Y
MenusRight-click · press and hold · Shift + F10
Input viewI Advanced
All shortcuts?