Skip to content

Projectors

Each projector in Moonshine stands for a real projector in your venue. This page covers adding projectors and what each setting means for the hardware you're aiming.

The closer these settings are to your actual install, the less correction you'll need later. With the right position, rotation and throw ratio, you can trust the preview, and your first alignment is already close.

Stage Left selected in the viewport with the move gizmo, its name label and its throw cone, and the Projector section of the Properties panel

Adding a projector

You can add a projector from four places:

  1. Click + Add at the left end of the Scene toolbar, or right-click empty space in the viewport and open Add.
  2. Choose Projector. Added from the right-click menu, it lands where you clicked. See Adding projectors and surfaces.
  1. Click the projector name in the top bar to open the Projectors view.
  2. Click + Add Projector at the bottom of the list.
  1. Press G to open the scene graph.
  2. Right-click empty space (or the Scene node), open Add and choose Projector.
  1. Press / to open the command palette.
  2. Choose Add Projector.

The Add Projector window with Epson typed in Make and Model, four matches each with its resolution, brightness, lens count and what is known of its lens, and Can't find it? Request it, Cancel and Enter manually

Each of these opens the Add Projector window, which lists every projector model Moonshine knows, A to Z. Scroll to load more, or type part of the make and model to narrow the list: epson l630 finds the Epson EB-L630U. Each result shows the resolution, the brightness and what Moonshine knows about the lens:

Label Meaning
throw and shift The lens's throw ratio range and shift range, from the manufacturer's documents
throw only The throw ratio range. The manufacturer publishes no shift range, so Moonshine assumes a common one: ±50% horizontal and ±100% vertical, in an ellipse
no lens data The manufacturer publishes neither. The lens starts with no limits

Pick a model and the new projector gets its name, resolution, Lumens (ANSI) and Native Contrast, with its lens limits switched on. The throw ratio starts in the middle of the zoom range, and lens shift starts centered (or at the lens's fixed offset, if it has one). You can still edit all of these.

If the projector takes interchangeable lenses, you're asked which lens is fitted. Each lens shows its throw range and whether its manufacturer publishes its shift. Choose the lens later adds the projector without one.

Enter manually adds a projector with the defaults below, for when you'd rather enter the details yourself.

A model that is not in the list

Choose Can't find it? Request it, check the make and model, and add a link to its spec sheet if you have one. The request comes to us, and we add the model to the list. If Moonshine can't reach the internet, the window offers to send the request by email instead.

The model list ships with the Moonshine server. If your server doesn't have the list, or is older than it, the window says so. Enter manually still works.

New projectors are named Projector 1, Projector 2 and so on, or after their make and model when picked from the list. Each gets its own color from a set of eight. The color is used for its throw cone, its name label under the projector body (long names are shortened with …) and its dot in every list.

A new projector starts with the values below. A projector picked from the list uses its own throw ratio, lens shift, Lumens (ANSI), Native Contrast and resolution wherever the list has them. Brightness, Contrast and Gamma start at 1 either way.

Setting Value
Position 0, 0, 12
Rotation 0, 0, 0
Throw Ratio 1.5
Focus Distance 12
Lens Shift 0, 0
Lumens (ANSI) 3000
Native Contrast 0 (not set)
Brightness / Contrast / Gamma 1
Resolution Copied from your first projector, or 1920 × 1080 if this is the first
Output A Display output, switched off, placed in the first free space on your displays. See Outputs

Most installs use identical projectors, so copying the resolution means the second projector onward usually arrives with the right one.

The projector selector

The top bar shows a projector icon and the name of the selected projector, or Projectors when none is selected. Hover over the name for a dropdown that lists every projector under Select Projector, with its color dot and a check mark on the current one. Manage Projectors, at the bottom, opens the Projectors view, as does clicking the name. Clicking the icon, which turns into a gear on hover, opens Manage Projectors directly.

The top-bar projector selector open under Select Projector: Stage Left with its lock and a check mark, Stage Right, and Manage Projectors

Press 1 to 9 anywhere in the app to select a projector by its position in the list. It's the quickest way to step through projectors while you compare their coverage.

The Properties panel, the settings form, keystone and warp, and the projector-eye view all work on the projector selected here.

The Projectors view

The Projectors view has a list of projector cards on the left and sub-tabs on the right:

Sub-tab Contents
Settings Every setting for the selected projector, described on the rest of this page
Outputs Where this projector's render goes on a physical display. See Outputs
PJLink Network control of the projector: its address, and the power, input and sound state it reports. See Projector health
Test Pattern An alignment pattern on this projector or on all of them, with a preview. See Test patterns
Proof Camera calibration. It's in development, and the sub-tab doesn't appear in this version

Each card shows the projector's color swatch, its name, its output type (Display, NDI, SDI or ST 2110), a connection status, and an Output pill you can click to switch that projector's output on or off. Drag a card to reorder the list, or right-click it for Move Up and Move Down. The order sets which projector 1–9 select and which projectors count first in the preview.

To rename a projector, double-click its name on the card, or right-click the card and choose Rename. Selection sets still named after the projector are renamed with it (see Rename a node). Delete is on the same menu and asks for confirmation first. Hovering over a card also shows pencil and trash buttons, except on a card someone is holding, which includes the projector you have selected.

The status line at the bottom of each card shows whether Moonshine can reach the projector over PJLink:

Card label When Dot
No PJLink The projector has no PJLink address Gray, dimmed
Checking… A PJLink address is set and the first poll hasn't answered yet Gray
Online The last PJLink poll reached it Green
Unreachable The last PJLink poll didn't reach it Red

Power state, lamp hours and faults come from the same connection. See Projector health.

The settings form

Open Projectors → Settings with a projector selected.

The Projectors view on its Settings sub-tab: the projector list on the left, then Model, Projection Surface, Resolution, Position, Rotation, Lens Shift, Throw Ratio, Lens, Lumens and Native Contrast, with Shutter and the image controls on the right

In a wide window, the form has two columns: placement and lens on the left, and the shutter and image adjustments on the right.

The Projection Surface picker does nothing

The Projection Surface picker near the top of the form has no effect in this version. You create and choose surfaces in the scene graph. See Surfaces and models.

Model

A dropdown showing the make and model the projector was picked as, or Specified by hand. Open it for the same list as when adding a projector, with a search field at the top. Picking a model replaces the projector's figures and lens limits and keeps its name. Specified by hand, at the top of the list, clears the model and keeps the figures as they are. Can't find it? Request it, at the bottom, asks us to add a missing model.

If the projector takes interchangeable lenses, a Lens dropdown appears below, listing each lens with its throw range. Choosing one sets the lens limits. A projector with a single lens has it chosen automatically.

Resolution

Width and Height in pixels, minimum 1.

Set this to the projector's native resolution. Two things depend on it:

  • The aspect ratio. Moonshine works out the projector's field of view from the throw ratio and the aspect ratio, so a 16:10 projector entered as 16:9 covers the wrong area.
  • The projector-eye view, which is letterboxed to exactly this aspect ratio so you see the frame the projector produces.

Position

X, Y and Z in scene units: where the lens is in the room. Y is up.

Measure to the lens, not the case, and from the same origin you used for your surfaces. Five minutes with a tape measure here saves an hour of nudging later.

Rotation

X, Y and Z in degrees: the direction the projector is aimed.

  • Y is pan: turning left and right.
  • X is tilt: aiming up or down.
  • Z is roll: rotating the image, for a projector mounted on its side or upside down.

Tip

Don't aim by typing rotation values. Select the projector and click Frame Scene Model in the Scene tab's Properties panel to point it at your surface, then refine. See Aiming quickly.

Lens Shift

X and Y in percent, from -150 to 150.

Lens shift moves the image up, down, left or right without tilting the projector, as a real projector's lens shift does. Tilting a projector keystones the image into a trapezoid; shifting the lens keeps it rectangular. A projector hung near the ceiling and shifted down puts a clean rectangle on the wall below. Tilted down, it doesn't.

Moonshine measures shift as a percentage of half the image size:

Value Meaning
0 The image is centered on the lens axis
+100 Shifted by half the image height (or width), so its edge is on the lens axis
+50 Shifted by a quarter of the image height (or width)

Positive X shifts the image right; positive Y shifts it up.

Note

Manufacturers quote lens shift in different ways: some as a percentage of the full image height, some as a percentage of half. Check your projector's spec sheet and convert if needed before you type its number in.

Lens shift skews the throw cone in the Scene and the projector-eye view by the same amount, so both show the frame the shifted lens throws. Moonshine renders the projector's output through the same off-axis view. Set the shift to match the physical projector, and your content lands where that projector's light falls.

Lens

Switch on Keep to the lens's limits and enter what the lens can do, from its spec sheet. Lens Shift and Throw Ratio then stay within the lens's range, and image lock works within the same limits.

Field What to enter
Throw Min, Throw Max The zoom's throw ratio range. Enter the same number twice for a fixed lens
Shift X Min, Shift X Max The horizontal shift range, in percent of half the image
Shift Y Min, Shift Y Max The vertical shift range, in the same unit
Shift Envelope How the two ranges combine: see below

Few lenses can reach full horizontal and full vertical shift at the same time. Ellipse is the shape most manufacturers publish. Diamond is a straight trade-off between the two, as Sony quotes it. Rectangle is for a lens whose two ranges are independent.

Note

The unit is the same as for Lens Shift. If the manufacturer quotes percent of the full image, as Epson and Sony do, double it: a quoted ±50% vertical is ±100 here. If it quotes percent of half the image, as Christie does, enter it as is.

For a projector with a fixed offset and no shift, as most home-cinema DLP projectors have, enter the same number as minimum and maximum.

A projector picked from the list has these filled in and switched on, where its manufacturer publishes them. Otherwise, take the numbers from your lens's spec sheet.

Throw Ratio

A slider from 0.3 to 5, in steps of 0.01.

Throw ratio is the most useful number on a projector's spec sheet:

throw ratio = throw distance ÷ image width

A 1.5 throw ratio at 15 m from the wall gives a 10 m wide image. At 6 m, the same lens gives 4 m. Lower ratios are short-throw lenses that fill a wide area from close in. Higher ratios are long-throw lenses that put a narrower image on a distant surface.

Read it from the lens, not the projector body. A zoom lens covers a range (say 1.2–1.8), and the value you want is where the zoom is set. If you haven't decided yet, use Frame Scene Model to pick a ratio that fits your surface, then check that the result is within your lens's range.

Note

The Throw Ratio field in the Scene tab's Properties panel accepts values up to 8, for long-throw lenses beyond this slider's range.

Lumens (ANSI)

A slider from 0 to 30000, in steps of 100, default 3000.

The projector's rated light output in ANSI lumens, at full brightness on full white. Take it from the spec sheet.

Lux view mode uses this figure, with each projector's position, angle and distance, to draw a heatmap of the light on your surfaces. The heatmap is only as accurate as the lumen figure. With the right one, it shows whether a surface will read from the back of the room and where two projectors double up. See View modes.

Tip

If the projector runs in an economy or eco mode, enter the rated output for that mode, not the headline figure. The difference is often 30%.

Native Contrast

A slider from 0 to 50000, in steps of 100. The default, 0, means not set.

The projector's native contrast ratio, the x in x:1. At black, a projector still gives off 1/x of its white light, so black is brighter wherever projectors overlap. Moonblend uses this figure to even that out.

Use the native figure from the spec sheet, not the dynamic one. Dynamic contrast comes from dimming the whole picture, which doesn't help black next to white.

Brightness, Contrast and Gamma

Three sliders that adjust this projector's output:

Control Range Neutral
Brightness 0 – 1 1
Contrast 0 – 1 1
Gamma 0.1 – 3 1

They're most often used to match projectors. A projector with 4000 hours on its lamp puts out less light than a new one of the same model. Bring the brighter projectors down to match it, since no projector can go above its own maximum. Always work down from 1.

Together with the color gains, these set how much light the projector gives at full white. That's what Lux shows and what Moonblend blends by. Light falls faster than the Brightness value: at 0.7, a projector gives a little under half its light. Moonblend works on the adjusted picture, so these settings don't throw off the blend. A blend calculated in an earlier version of Moonshine ignored them: if a projector's levels were already set then, press Calculate on the Moonblend layer once.

Use Gamma when two projectors match on a white field but differ in the midtones, which is common with different panel technologies or picture presets. Values above 1 lift the midtones; values below 1 lower them.

Red Gain, Green Gain, Blue Gain

Three sliders from 0 to 2, in steps of 0.01, neutral 1. Each multiplies one color channel of the projector's output.

Use them to white-balance. Point two projectors at the same white surface and their whites rarely match: one leans green, another magenta. Correct the odd one out by lowering its strongest channel rather than raising the other two, so you keep headroom.

To match two projectors:

  1. Put a white field on the surface from both. The quickest way is Test Pattern → Solid with the White swatch, on All Projectors, drawn on Surface. (The Mesh view mode's fill only changes your own 3D view and sends nothing to the projectors.)
  2. Pick the projector whose white you like least and find which channel is too strong.
  3. Lower that channel's gain in small steps until the two whites match.
  4. Check the midtones afterwards and adjust Gamma if needed. A gain change can shift them.

Shutter

Shutter blacks out this projector. It sits above the image sliders because it overrides them. Closing it does two things:

  • Moonshine sends black, immediately. This works with every output type and doesn't need a network.
  • The projector's own shutter closes, if the projector has a PJLink address. A projector sent black still glows faintly at its black level, a gray rectangle in a dark room. A closed shutter shows nothing.

Closing the shutter leaves every image setting alone, so opening it restores the same look. The shutter state is saved with the projector. While it's closed, Moonshine closes the projector's own shutter again whenever the projector reports it open: for example, if the projector was off when you closed it, or has been switched off and on since.

The label beside the switch shows the state:

Label Meaning
Open The picture is being sent
Closed The picture is black, and the projector reports its own shutter closed
Closed · signal only The picture is black, but the projector's own shutter isn't known to be closed. You'll see this briefly after closing, and always on a projector with no PJLink address, one that refused the command, or one set to leave its own shutter alone
Open · projector shutter closed, in amber The picture is being sent, but the projector reports its own shutter closed, at the projector or by its remote. Close and open the switch to open it

Rehearse it on your projectors

Projectors respond to a mute command in different ways. Some show a color or a logo instead of closing a shutter, some switch themselves off after a while muted, and a laser projector can take a moment to come back. Close and open each one during load-in and watch what it does. To make the switch black out the picture only, switch off Shutter closes the projector's own shutter in that projector's PJLink section.

Nothing on the wall?

Check the shutter and the test pattern first. A closed shutter is black, and a test pattern replaces your content.

Label Color

The color that marks this projector throughout the interface: its card swatch, its throw cone in the Scene and its output rectangle. When you identify the projectors, the projector's edge, corners and name are drawn in this color on its own output. New projectors take the next color from a set of eight; change it here.

The last section of the form takes a Host, Port and Password for projectors that support PJLink network control. Find projectors searches the network and fills in Host from the projectors that answer. Once a password is saved, Moonshine never shows it again, not even to you: the field says one is set. Type a new one to replace it, or press Clear password. Leave Host blank for projectors you don't control over the network. See Projector health.

Once a host is set, Shutter closes the projector's own shutter sets whether the Shutter switch also closes the projector's shutter or only blacks out the picture. It's on by default.

Test patterns

Open Projectors → Test Pattern with a projector selected. A test pattern replaces your content, drawn where Drawn On says:

  • Projector, the default, draws the pattern across the projector's own pixels. Use it to check the projector itself: its levels, its focus and where its image lands. The pattern fills the projector's whole image, whatever the surface, and keystone, warping, masks and blending don't affect it. A ramp runs from black to full across the image, and a grid's cells are square-cornered with upright labels.
  • Surface lays the pattern on the surface the way your media is, through keystone, warping, masks and blending. Use it to check a blend, or to show a card made for the whole surface, such as the moon test card a new project keeps in custom slot 1. A ramp or grid follows the surface's shape, so a projector that covers part of the surface shows its part.

Either way, the projector's own Brightness, Contrast, Gamma and gains apply, so a white field shows their effect while you match projectors.

The Test Pattern tab: Off, Solid, Ramp, Grid and Custom, Applies To with This Projector chosen, Drawn On with Projector chosen, a preview of a labeled white grid on black, and Foreground, Background, Cells and Labels in one row

Pattern What it shows
Off Your content
Solid A flat field in the Color you pick: red, green, blue, white, black, or any color from the last swatch
Ramp A gradient from black to that color across the projector's image (or the surface), brightest in the Direction you choose
Grid A grid of Cells across and down the projector's image (or the surface). With Labels on, rows are lettered and columns numbered, so every cell has a name you can call out. Lines and labels are drawn in the Foreground color on the Background color, black unless you change it
Lunar The Moonshine test card, described below
Custom An image or video from the project, held in one of five Slots, stretched over the projector's image or laid on the surface

Applies To sets which projectors show the pattern:

  • This Projector, the default: the selected projector only.
  • Machine Projectors: every projector on the same show machine as the selected one. With one show machine, that's every projector.
  • All Projectors: every projector on every show machine in the show.

Showing one projector at a time is how you tell projectors apart. Select the next projector and choose its pattern, and the one you left goes back to its content.

The preview below the controls shows the pattern as the projector shows it, in its shape. When the pattern is drawn on the surface, the preview says so, since each projector shows only its part.

A projector whose shutter is closed stays dark, pattern or not.

Test patterns are shared with everyone connected but aren't saved: after a reload or a restart, every projector starts at Off. The five custom slots are saved with the project.

Lunar

Lunar is the Moonshine test card. It checks everything at once, in the colors of the show machine's own screen.

Cell sets the cell size in the projector's pixels. The default, 120, gives 16 cells across a 1080p projector, with lines through the center. The Show row switches each part of the card on or off. Every part except Motion starts on.

Part What it shows
Tiles A checker of cells
Lines The cell lines
Labels A row letter and column number in every cell, so "C7 is soft" means the same cell to everyone
Crosshair Center lines
Diagonals Lines from corner to corner
Circle A circle as tall as the frame, round only when the aspect ratio is right
Corners Corner triangles
Edge A border along the edge of the raster, where the image ends
Focus Fine stripes near each corner that turn gray as soon as the lens is out of focus
Levels Gray steps and colors along the bottom, for matching levels
Identity The moon, the Moonshine name, and the projector's name and resolution in the middle
Motion A bar sweeping one cell per second and a frame counter. Use it to spot dropped frames, or photograph two projectors together to see how many frames apart they are

Line sets the weight of the cell lines, and Edge the width of the border. Palette changes the card's colors: choose one of 32, or Auto. Auto gives every projector you light at once its own palette, with neighboring projectors as different as possible, so two fields meeting on a wall are easy to tell apart. The gray steps and the labels keep their colors in every palette.

Preset saves a set of these choices with the project under a name, for the whole crew. Choose a preset to apply it, Save to add the current settings as a preset, or Delete to remove the chosen one.

The Scene tab's projector panel

Select a projector on the Scene tab and the Properties panel shows the settings you adjust most while watching the result. Its lock appears at the top right of the 3D view, level with the toolbar: green while you hold it, or an orange padlock with an initial while someone else does.

The Scene tab's Properties panel with a projector selected: Projection Preview and Frustum Preview, Throw Ratio, Focus Distance, Lens Shift, Position, Rotation, Frame Scene Model, Image Lock and Projector Settings

Control What it does
Projection Preview Includes or mutes this projector in the Beams and Lux previews
Frustum Preview Shows or hides this projector's throw-cone wireframe in the viewport
Throw Ratio As above; this field accepts 0.3 to 8
Focus Distance How far out the throw cone is drawn (see below)
Lens Shift X and Y in percent, as above
Position X, Y, Z
Rotation (degrees) X, Y, Z
Frame Scene Model Aims this projector at the active surface and fits it
Image Lock Keeps the picture in place when you move the projector: see Image lock
Projector Settings Opens the full settings form

Use Projection Preview to track down which projector causes a hot spot: mute them one at a time and watch what disappears. It only affects the preview; the projector's output stays on.

Focus Distance

From 0.5 to 50, default 12.

Sets how far into the scene the throw cone is drawn: the distance to the outlined rectangle at the end of the cone. Together with the throw ratio, it sets that rectangle's width:

rectangle width = focus distance ÷ throw ratio

Set it to roughly the distance from the projector to the surface, and the cone ends on your geometry. You can then see at a glance whether the projector is aimed correctly and whether its image falls short.

Note

Focus Distance only affects how the cone is drawn. It doesn't change the brightness of the projection, so adjust it freely while you aim.

Aiming quickly

Frame Scene Model does the math for you. Select a projector on the Scene tab and click it. Moonshine:

  1. Rotates the projector to point at the center of the active surface, with roll set to zero.
  2. Sets the focus distance to the distance between them.
  3. Picks a throw ratio that fits the surface in the frame with about 10% margin, between 0.4 and 8, and within the lens limits when they're on.

It measures the surface at its current scale, so if you rescale the model and frame again, the ratio matches what you see. Ctrl+Z (Cmd+Z on macOS) restores the rotation, throw ratio and focus distance.

Treat the result as a starting point. Check that the throw ratio is one your real lens can reach, then adjust position and rotation to match where the projector hangs.

Note

The Frame Scene Model item on a projector's right-click menu in the scene graph does something different: it frames the viewport camera on the surface, like Home. Only the button in the Scene tab's Properties panel aims the projector.

Moving a projector in the viewport

In Object mode, click a projector's body or name label in the viewport. A gizmo appears, and the throw cone follows as you drag, so you can aim against a live Beams preview.

Key Gizmo
M Move the projector
R Rotate: aim the projector
L Pivot: move the point it rotates around, not the projector
O Switch between World and Local
  • Hold Shift while dragging to move at a tenth of the speed, which helps when a degree matters.
  • Hold Ctrl (Cmd on macOS) as you start a drag to move the projector and keep its picture where it is: see Image lock.
  • Hold Alt (Option on macOS) as you start a drag to move a copy and leave the projector where it is: see Duplicating.
  • Ctrl+Z (Cmd+Z on macOS) undoes a whole drag; Ctrl+Shift+Z redoes it.
  • Esc deselects the projector and removes the gizmo.
  • A projector stores only position and rotation; it has no scale.

World, the default, keeps the gizmo on the world axes, so pan stays on the world vertical and tilt on the world horizontal, the way you'd describe aiming a real projector. Local aligns the gizmo with the projector's own axes. Switch with the button beside the tools in the toolbar, or press O.

Several projectors at once

Ctrl-click (Cmd-click on macOS) a projector's body or label to add it to the selection, and Ctrl-click it again to remove it. Shift-click adds and never removes. Surfaces can join the same selection. This works the same way on projector nodes in the scene graph and on the projector cards, where Shift-click selects every card from the one you last clicked.

Drag the gizmo and every selected projector moves or rotates with it. In World, they rotate as one group around their center; in Local, each rotates around its own pivot. With image lock, each projector keeps its own picture in place. The Properties panel shows the settings they share, and a value you type there applies to all of them, each within its own lens limits. Delete on any of them removes them all: see Duplicating and deleting. For the rest, see Several at once and Pivots.

A projector another operator is working on can still join the selection. It shows in orange, and moves, edits and deletes skip it: Moved 2 of 3 — Projector C is held by Dana. See Locks.

The selection lasts until you click something else without Ctrl or Shift, switch to a tab other than Scene or Projectors, change tool, or reload the page.

Image lock

You can move a projector in two ways. A plain move takes the picture with it. A move with image lock keeps the picture where it is on the surface, as if you'd moved a real projector and corrected with the lens:

  1. The lens shifts when the projector moves sideways or up and down.
  2. The lens zooms when it moves nearer or further.
  3. The projector turns once the lens has no range left.
To Do this
Keep the picture in place for one drag Hold Ctrl (Cmd on macOS) as you start dragging
Keep it in place for every drag Switch on Image Lock in the Properties panel
Move plainly while the switch is on Hold Ctrl (Cmd) as you start dragging. It reverses the switch

A Ctrl-click without a drag still adds to or removes from the selection. Before October 2026, image lock used Alt, which now duplicates.

The gizmo's handle shows what the next drag will do: indigo when it will keep the picture in place, yellow when it won't. While you hold Ctrl (Cmd on a Mac), it turns sky blue, to show that the drag reverses the Image Lock switch.

Image lock works on surfaces too. Move a surface with image lock and every projector whose picture lands on it follows, using the lens first and then turning.

Lens Shift, Throw Ratio, Focus Distance and Rotation update as you drag. One Ctrl+Z undoes all of it.

What to expect:

  • The lens's reach comes from the lens limits. With none entered, Moonshine assumes a lens with no zoom and a shift of ±100% vertical and ±50% horizontal.
  • The center of the picture stays put. On a flat surface square to the projector, the whole picture stays. Once the projector has turned, the picture becomes a trapezoid, as it would from a real projector that has been tilted.
  • It applies to moving only. Rotating and scaling work as usual.
  • It doesn't move the real lens. Set the resulting shift and zoom on the projector yourself.

The projector-eye view

Press P, or click PJ View in the Scene toolbar, to look through the selected projector. To look through any projector, right-click it and choose View. Press P or PJ View again, or Esc, to come back. Home also comes back, framing the scene.

The camera flies into the projector's lens and back out to where you were, and from one projector to the next if you select another while looking through one. The flight takes under a second, and dragging doesn't move the camera during it. With reduced motion turned on in your system, the camera cuts instead.

The viewport shows exactly what that projector sees:

  • The frame is letterboxed or pillarboxed to the projector's Resolution aspect ratio.
  • Lens shift skews the view as it skews the real lens.
  • The grid is hidden, since a real projector doesn't show it.
  • Camera controls are disabled; the view is locked to the projector's viewpoint.
  • Changes to position, rotation, throw ratio, resolution or lens shift update the view live.
  • A Projector view material shows as the projector throws it: its own across its whole frame, another projector's not at all.

The viewport in projector view: the camera at Stage Left's lens, letterboxed to its aspect, with the screen filling the frame

Selecting a different projector in this view switches to that projector's viewpoint, so stepping through with 1–9 is a quick way to check every frame.

The selected projector's node in the scene graph also has an eye button that enters and leaves this view.

Tip

Use this view to answer "does my content fit the surface from this projector?" The Scene camera can make a bad aim look fine from a flattering angle; the projector's own frame can't.

Duplicating and deleting

Right-click a projector's body in the viewport for four items above the usual scene menu:

Item What it does
View Looks through the projector. It reads Exit View while you're looking through it
Projector Settings Opens the settings form for the projector
Duplicate Copies the projector half a meter above it. If it's one of several selected, it reads Duplicate 3 items and copies them all. Ctrl+D does the same
Delete Removes the projector after a confirmation. If it's one of several selected, it reads Delete 3 projectors (or Delete 3 items if surfaces are included) and removes them all. Del does the same

Duplicate copies the lens and image settings (resolution, throw ratio, lens shift, lumens, image adjustments, color gains and output type) and the position, rotation and pivot. The copy gets a new color and the name <original> copy (then <original> copy 2), and sits above the original so the two bodies don't overlap. To place the copy somewhere else in one step, hold Alt (Option on macOS) and drag the gizmo instead: see Duplicating. A display output goes in the next free space on the same display. Keystone and warp corrections, the mask and the PJLink settings aren't copied: the copy starts clean, like a new projector.

That makes duplicating the best way to add the second, third and fourth projectors of a matched rig. Set one up fully, then duplicate and reposition.

You can also delete a projector from its card, with Delete on its scene graph node, or with Del or Backspace on the selection (see Deleting). Its settings go with it. Ctrl+Z brings it back, until you switch projects or reload the page.

Deleting several selected projectors asks once, and one Ctrl+Z brings them all back. A selected projector that another operator is working on is skipped, and the confirmation says so. Duplicate on one of the selection copies them all, and one Ctrl+Z removes the copies.

Where to go next