prism docs · Designing · 3D objects

3D objects

Map a real box, a plinth, a speaker or a doorway as one solid object instead of separate flat shapes. You place a virtual shape over the real one, pin its corners to the real corners, and prism works out every face exactly as your projector sees it. Each face then gets its own look, or one picture that wraps all the way round.

WhereDesign ▸ Add ▸ 3D object
ShapesBox, Plane, Pyramid, Wedge. Cylinder, cone, sphere and imported models are coming.
Two stepsPlace roughly, then Align exactly
ModeSimple placing, pinning, size, hidden sides
Advanced numbers, lens, lock and fine-tune, content mapping
1 · Before you start 2 · Add a 3D object 3 · Place it 4 · Align it to the real object 5 · Lock it and fine-tune 6 · Give it a look 7 · See-through: the glass-box effect 8 · More than one projector 9 · Hints and tips 10 · When something looks wrong 11 · Mouse and keyboard

1Before you start

How it works. A projector is like a camera in reverse. Once prism knows where your object is, which way it's turned and how the projector's lens throws light, it can draw each face exactly where that face really is, in perfect perspective. The pins you place are how it learns this.

2Add a 3D object

  1. In Design, press Add in the canvas tool bar and choose 3D object. (Right-click the canvas ▸ 3D object puts it where you clicked.)
  2. Pick the shape closest to your real object: Box (6 faces), Plane (a flat panel), Pyramid (5 faces) or Wedge (a ramp).
  3. The object appears in the middle of the picture, already selected and turned three-quarters towards you. In the Surfaces list it's a group named after it (Box 1), with one surface per face (Box 1 front, Box 1 top…). The canvas switches to the projector view, where the object's handles are.
  4. If you measured the object, type its size in the card on the right (Size, cm).
The Add menu with the 3D object submenu open
Design ▸ Add ▸ 3D object. Box, Plane, Pyramid and Wedge are ready; the curved shapes and imported models are marked “soon”.

3Place it

A new object starts in Place, where you move it roughly over the real object. Watch the projector window as you go.

To…Do this
Move itDrag anywhere on its body. It slides across the picture and keeps its size.
Resize itDrag a corner square. The opposite corner stays put; hold Alt to grow from the centre, and Shift to step in 5 % jumps. (With a measured size, it moves nearer or further instead: on the projector that looks the same.)
Turn itDrag a ring: red tips it forward and back (X), green swings it left and right (Y), blue rolls it (Z), and the outer ivory ring spins it flat, like a steering wheel. Hold Shift to snap to 15°.
Nudge itArrow keys move it 1 px; Shift + arrows move it 10 px.
Start overReset rotation returns it to how it was added; Face the projector turns its front squarely towards the projector.
A box with its rotation rings and corner squares, and the object card
Place: the red, green and blue rings turn the box around its own axes; the outer ivory ring spins it flat. The corner squares resize it. The card on the right shows its position, rotation and size; the numbers are Advanced.
Get close, not perfect. Placing only needs to be roughly right. Aligning (the next step) snaps it exactly onto the real object, so don't spend long lining up edges here.
Every move is one undo step, named after what you did (“Rotate Box 1 around X by 30°”), so Ctrl + Z takes back exactly one gesture.

4Align it to the real object

Now tell prism where the real corners are. Press Align to the real object in the card (or switch the card to Align). The rings disappear and every visible corner becomes a handle you can pin.

  1. Zoom in on the canvas (mouse wheel, or Shift + 2 to zoom to the selection). Precision matters here.
  2. Drag a corner and watch the projector: move it until the corner of the projected picture sits exactly on the real corner. The corner is now pinned (a solid lime dot), and the object fits itself to its pins.
  3. Pin more corners, on at least two faces. Four pins place the object; six or seven (every corner you can see) make it exact and let prism learn your projector's lens.
  4. Watch Error in the card: green below 1.5 px is excellent, amber (below 4 px) is close, red means something doesn't match (see When something looks wrong).
  5. Press Done aligning to go back to placing, or Lock alignment when you're happy (next section).
Align with five corners pinned and the Alignment card
Align: Pins 5 of 6, an error of 2.8 px (amber), the lens still a guess, and the hint “Pin 1 more corner, on two faces or more.”
Snapping to your scan. If you scanned the room with your phone, a corner dragged near a scanned corner snaps onto it (lime rings show). Hold Alt to place it freely.
The dotted lines are your friends. From 4 pins on, each pin gets a thin dotted line to where the fitted shape puts that corner. Short lines mean a good fit; one long line usually means that pin is on the wrong corner. Hover a line to see its length.

Size and lens

5Lock it and fine-tune Advanced

Lock alignment freezes the object exactly as it looks now: nothing moves when you press it. After locking, dragging a corner no longer re-fits the whole shape; it moves just that corner, and the faces bend smoothly to follow. Use this to correct the last pixel where a real box is slightly squashed or its edges aren't quite straight.

Lock last. Pin every corner you can see first. Locking a rough fit and then bending lots of corners gives a wobbly result; re-fitting is quicker.

6Give it a look

Each face is an ordinary surface, so everything you know from other surfaces works: click a face to select it, then pick a look from the library, change its settings in the look panel, set a blend mode, make it react to music, save it in scenes and cues. A new object's faces share one Test Grid look named after the object.

Advanced Map content

SettingWhat happensGood for
Each face (default)Every face shows its own copy of its look, in correct perspective.Different colours per face, test grids, edge looks
Wrap aroundOne picture wraps round the sides like a label on a tin; top and bottom show the whole picture.A video or pattern that flows round the object
ProjectorOne flat picture across the whole object, as the projector sees it.Big reveals, projected text, “it's just light” illusions
The Map content choice in the object card
Map content: Each face, Wrap around or Projector.
The Input view showing how the sides unwrap
With Wrap around, the Input view (I) shows the strip each side takes.

7See-through: the glass-box effect

Normally prism hides the sides that face away from the projector, because on a real box the light can't reach them. Turn on Show the hidden sides and those sides are drawn underneath the front faces. Then set a front face's blend mode to Multiply, Screen or Add, or lower its opacity, and the back of the box shows through, as if it were glass.

  1. Select the object and turn on Show the hidden sides in the card (or right-click ▸ Box 1 ▸ Show the hidden sides).
  2. Give the hidden sides looks: select them in the Surfaces list (they can't be clicked on the canvas; they're behind).
  3. Select a front face and set its blend mode to Multiply (or Screen or Add), or lower its opacity. See Blend modes.
See-through off: the multiplied front face is black
Off: the front face on Multiply has nothing behind it, so it looks black.
See-through on: the back, left and bottom show through the front face
On: the blue back, magenta left side and amber floor show through the front face.
Sell the illusion. Keep the top and one side on Normal with a solid colour, so the box still reads as solid, and only let the front face go “glass”. Slow looks inside (Smoke, God Rays, Metaballs) make it feel like there's something alive in the box.

8More than one projector Advanced

An object can be lit by several projectors. In the card's Projectors list, press Add here for another projector. The object gets its own faces there, with the same looks, and you pin its corners again from that projector's point of view. Each projector keeps its own pins, position and lens; the object's size is shared. See Several projectors.

9Hints and tips

10When something looks wrong

You seeWhyFix
Error stays amber or redThe shape doesn't match the real object (wrong proportions), or a pin sits on the wrong corner.Type the measured size or press Estimate size; check for one long dotted line and re-pin that corner.
The object jumps when you pinWith only 1–3 pins prism has to guess the rest.Keep pinning: from 4 pins (on 2 or more faces) it settles.
A face is missingIt faces away from the projector, so it's hidden (the light can't reach it).That's expected; for the glass effect turn on Show the hidden sides.
Can't drag the objectIts alignment is locked.Unlock it in the card, move it, then lock again.
No rings or handles on the canvasThe canvas is in the camera view; the object's handles are in the projector view only.Press Projector in the canvas tool bar.
Edges are a pixel off after lockingThe real object isn't perfectly square.Drag that corner: after Lock, corners move exactly and the faces bend to follow.
Multiply on a face goes blackNothing is drawn underneath it.Turn on Show the hidden sides, or put another surface behind it.

11Mouse and keyboard

ActionHow
Move the objectDrag its body · arrows (1 px) · Shift + arrows (10 px)
ResizeDrag a corner square · Alt from the centre · Shift in 5 % steps
TurnDrag a ring · Shift snaps to 15°
Pin a corner (Align)Drag it · Alt places it without snapping · arrows nudge a selected corner · Delete unpins it
Zoom to itShift + 2 · mouse wheel to zoom
Object menuRight-click a face or the object's row ▸ Box 1: Align to the real object or Back to placing, Reset rotation, Face the projector, Show the hidden sides, Unpin all corners
UndoCtrl + Z: one gesture at a time
The right-click menu of a face with the Box 1 submenu open
Right-click a face: the object's own submenu (Box 1 ▸) sits among the face's usual surface items.