Contents
Manual home
Start here
Guides
Getting around
Making objects
Terrain, water and sky
Materials and light
Rendering and export
Loop Studio
Files and purchases
Concepts
Reference
Troubleshooting
Reference

Menus and palette commands

Orbit's commands sit in the menu bar, in the menus of the toolbar, in the menus that open with a right-click and in the command palette, which opens with ⌘K. Keys with no menu item are in Keyboard shortcuts and mouse gestures. For where each menu sits, see The window.

Menu shortcuts work even while the cursor is in a text field. Orbit adds nothing to the Edit, Window and Help menus, which hold the standard macOS items.

Orbit

ItemShortcutEffect
Welcome to OrbitOpens the WELCOME sheet, with the four ways to start and, in the free version, the purchase buttons
Settings…⌘,Opens the app settings in a separate window, which closes like any window. The SETTINGS button in the toolbar opens the same settings as a sheet with a DONE button.
Quit Orbit⌘QQuits. With unsaved changes, Orbit first offers Save…, Discard and Cancel.

The rest of the Orbit menu holds the standard macOS items.

File

ItemShortcutEffectAvailability
New Scene⌘NAsks about unsaved changes, then starts a new, empty scene
New from Scene Wizard…⇧⌘NKeeps a copy of the scene as one undo step, clears the stage and opens the SCENE WIZARD on its LANDSCAPE tab. Closes either browser if it is open.
Open Example…Opens the list of example scenes. Opening one asks about unsaved changes first.
Open Scene…⌘OAsks about unsaved changes, then opens a .orbit file
Open RecentUp to five scenes recently saved or opened, by file name, then Clear Menu. Holding the pointer over a name shows the full path.Clear Menu is dimmed when the list is empty
Save Scene⌘SSaves to the scene's file. A scene never saved asks for a name and a place.
Save Scene As…⌥⇧⌘SSaves under a new name or in a new place
Export Turntable…⇧⌘EOpens EXPORT TURNTABLE
Import Object…Adds the objects in a .orbitobj file to the scene
Import Wavefront OBJ…Adds a .obj file to the scene as an editable mesh
Export Selected as Object…Saves the selected objects as a .orbitobj fileDimmed in the free version. With nothing that can be exported selected, the Mac beeps.
Export Selected as OBJ…Saves the selected objects as a .obj fileAs above

The procedures that use these items are in Save, open and recover scenes and Import and export objects.

View

ItemShortcutEffect
Command Palette⌘KOpens the command palette, or closes it

Everything else in the View menu is standard in macOS.

Toolbar menus

A toolbar menu opens below its button, or above it when there is more room there, and scrolls when it is taller than the window. It closes when you choose an item or click outside it. The arrow keys do not move through these menus.

NEW

ItemEffect
NEW SCENESame as File ▸ New Scene
SCENE WIZARD…Same as File ▸ New from Scene Wizard…

IMPORT

ItemEffect
OBJECT (.ORBITOBJ)…Same as File ▸ Import Object…
WAVEFRONT OBJ (.OBJ)…Same as File ▸ Import Wavefront OBJ…

EXPORT

The EXPORT button is dimmed in the free version, and whenever no object or group is selected. Its tooltip says which.

ItemEffectAvailability
SELECTED AS OBJECT…Saves the selected objects as a .orbitobj file, which keeps their settings, deformers and materials
SELECTED AS OBJ (.OBJ)…Saves the selected objects as a .obj meshDimmed when only water and emitters are selected, since neither has a mesh

ADD OBJECT

SPHERE, TORUS, BOX, CYLINDER, CONE, PLATONIC, SPLINE TUBE, EXTRUDE, LATHE, HELIX, MÖBIUS, TORUS KNOT, METABALLS, TERRAIN, WATER, TEXT, SADDLE, HYPERBOLOID, PARABOLOID, GROWTH and EMITTER come first, in that order. Each adds that object at the center of the scene, resting on the ground and selected. The new object is named after its kind with a number, such as Torus 2. Object types describes each kind.

ItemEffect
LIGHTAdds a point light 6 m above the ground and 4 m from the center of the scene
PEN / LOFTStarts the pen. See Draw shapes with the pen.

LIGHTING

The menu holds THREE-POINT, DRAMATIC, STUDIO, NEON, BACKLIT and VOID. Choosing one replaces every light in the scene with that setup and clears the selection, in one undo step. See Light a scene.

TRANSFORM

The TRANSFORM button opens a panel headed with the number of objects it acts on, such as 1 OBJ. It is dimmed unless every selected item is an object. Each click acts on every selected object separately and records one undo step. The panel stays open until you click outside it.

SectionButtonsEffect
ROTATE+90° X, +90° Y, +90° Z, -90° X, -90° Y, -90° Z, 180° X, 180° Y, 180° ZAdds that turn to the object's rotation on that axis
RESET ROTATIONSets the rotation to 0° on every axis
SCALE2×, 0.5×Doubles or halves the scale on every axis
MIR X, MIR Y, MIR ZMirrors the object across that axis
RESET SCALESets the scale to 1 on every axis
POSITIONCENTER TO ORIGINMoves the object so the center of its bounding box sits at the center of the scene, 0 m on every axis
DROP TO GROUNDMoves the object up or down until its lowest point rests on the ground
ALIGN TO GRIDMoves the position to the nearest multiple of GRID CELL in SETTINGS, 1 m at the start
RESET POSITIONSets the position to 0 m on every axis, which can leave part of the object below the ground

See Move, rotate and scale objects.

BOOLEAN

The BOOLEAN button is dimmed until the selected objects are closed solids that touch. Its tooltip gives the reason when it is dimmed.

ItemEffectAvailability
UNIONJoins the selected objects into one
SUBTRACT · KEEP and the object's nameCuts the other selected objects out of the named one, the object selected lastListed when every other selected object overlaps the named one
INTERSECTKeeps only the space the objects shareAs for SUBTRACT

See Combine and cut objects with booleans.

Right-click menus

In the viewport, right-clicking an object that is not selected selects it alone before the menu opens. Right-clicking one of several selected items keeps the selection, and a header such as 3 OBJECTS SELECTED tops the menu. These menus close the same way as the toolbar menus.

An object in the viewport

The items appear in this order, divided into groups by lines.

ItemEffectAvailability
HIDEHides the selected items
ISOLATE or EXIT ISOLATEShows only the selected objects, or ends isolation
FOCUSFrames the selected objects or the light. The camera then circles around what it framed.
SET DOF FOCUSSets FOCUS DIST in RENDER SETTINGS to the distance from the camera to the objects, and turns on DEPTH OF FIELDAlways listed. Does nothing for a light alone.
DUPLICATESame as ⌘D
DROP TO GROUND, CENTER TO ORIGINAs in the TRANSFORM panelObjects selected
BOOLEAN UNIONAs UNION in the BOOLEAN menuTwo or more objects that can be combined
BOOLEAN SUBTRACT, BOOLEAN INTERSECTAs in the BOOLEAN menuEvery other object overlaps the one selected last
SPLIT X, SPLIT Y, SPLIT ZCuts the object in two through the middle of its bounding box, across that axisOne closed solid selected
MAKE EDITABLE, ENTER POLY EDIT or EXIT POLY EDITTurns the object into a mesh and starts poly edit, or enters or leaves poly editOne object selected. MAKE EDITABLE is listed only for kinds that can become a mesh.
EDIT MATERIALOpens the MATERIAL BROWSERObjects selected, other than a lone emitter
LOCK or UNLOCKLocks or unlocks every selected item
NEW GROUPPuts the selected items in a new groupThe right-clicked item is in no group
ADD TO and a group's nameAdds the selected items to that groupThe right-clicked item is in no group, once a group exists
SELECT GROUPSelects the group the object belongs toThe right-clicked item is in a group
REMOVE FROM GROUPTakes the selected items out of their groupsThe right-clicked item is in a group
MOVE TO and a group's nameMoves the selected items to that groupThe right-clicked item is in a group, once another group exists
DELETEDeletes the selected items. A selected group is dissolved and its members stay.

Empty space in the viewport

Right-clicking water opens this menu too, since water counts as empty space here. The menu of a water object opens from its row in OBJECTS.

ItemEffect
ADD and a kind of object, such as ADD SPHEREAdds the object at the point on the ground under the pointer, or at the center of the scene when the pointer is over the sky. The 21 kinds follow the order of the ADD OBJECT menu.
ADD LIGHTAdds a light 6 m above the point under the pointer
PEN / LOFTStarts the pen
FRAME SCENEFrames the whole scene
SAVE CAMERA SNAPSHOTSaves the camera angle as a snapshot

A row in OBJECTS

RowItems
ObjectDUPLICATE, LOCK or UNLOCK, HIDE, ISOLATE or EXIT ISOLATE, the group items, DELETE
LightDUPLICATE, LOCK or UNLOCK, HIDE, the group items, DELETE
GroupLOCK GROUP or UNLOCK GROUP, DISSOLVE

The group items are NEW GROUP and ADD TO a group for a row outside any group, and REMOVE FROM GROUP and MOVE TO another group for a row inside one. On an object or light row, each item acts on the whole selection when the row is part of it, and on the row alone otherwise. DISSOLVE removes the group and keeps its members. The OBJECTS menus have no item for renaming; the name field at the top of the INSPECTOR renames. See Organize a scene.

ORBIT in the controls panel

Right-clicking ORBIT, or clicking the arrow beside it, opens 3 SECONDS / ROTATION, 6 SECONDS / ROTATION, 10 SECONDS / ROTATION, 15 SECONDS / ROTATION and 30 SECONDS / ROTATION, each of which sets the speed and starts the camera circling, then EXPORT TURNTABLE….

A snapshot in the dock

ItemEffect
RENAMEEdits the snapshot's name in place
UPDATESaves the current camera angle into this snapshot, with a new picture
DELETERemoves the snapshot

See Save camera angles.

Command palette

⌘K opens the palette over the window. Type part of a command's name to narrow the list, then press Return or click a command to run it; Run any command by name shows how. The palette shows no group names, and its list holds at most nine commands. With the field empty, the list starts with the last eight commands run since Orbit started, then continues in the order of the groups below. Where a command has a shortcut, the palette shows it at the right of the line, written as in the Hint column. A few hints list the modifier keys in a different order from the menus, such as ⌘⇧E for ⇧⌘E, but the keys are the same.

Adding, hiding and isolating

Always listed.

CommandHintEffect
ADD and a kind of object, such as ADD TORUSAdds the object at the center of the scene, as the ADD OBJECT menu does. All 21 kinds are listed.
ADD LIGHTAs LIGHT in the ADD OBJECT menu
PEN: DRAW STROKESStarts the pen
HIDE SELECTIONHHides the selected items
UNHIDE ALL⇧HShows everything that is hidden
ISOLATE SELECTIONIShows only the selected objects, or ends isolation

Views

Always listed.

CommandHintEffect
VIEW PERSPECTIVE1Perspective view
VIEW TOP2View from the top
VIEW FRONT3View from the front
VIEW SIDE4View from the side
FRAME SELECTIONFFrames the selected objects, or the whole scene when no object is selected

Render looks and lighting

Always listed.

CommandEffect
LOOK: RAY '95, LOOK: TERRA '96, LOOK: GLIDE '99, LOOK: CHROME 2000, LOOK: RADIOSITY '96Sets the render look. The look is a render setting, so ⌘Z does not reverse it. See Choose a render look.
LIGHTING: THREE-POINT, LIGHTING: DRAMATIC, LIGHTING: STUDIO, LIGHTING: NEON, LIGHTING: BACKLIT, LIGHTING: VOIDAs the LIGHTING menu

Selection

CommandHintListed whenEffect
DUPLICATE⌘DSomething is selectedDuplicates the selected objects and lights
DELETE⌫Something is selectedDeletes the selection
DROP TO GROUNDSomething is selectedAs in the TRANSFORM panel, for the selected objects
CENTER TO ORIGINSomething is selectedAs in the TRANSFORM panel, for the selected objects
LOCK / UNLOCK⌘LSomething is selectedLocks or unlocks every selected item. The ⌘L key acts on the item selected last only.
TOGGLE ORGANICOSomething is selectedTurns ORGANIC on or off for the object selected last
EXPORT SELECTED AS OBJECT…, EXPORT SELECTED AS OBJ…Something is selectedAs the File menu items. In the free version, a message explains that geometry export needs the full version.
ALIGN TO GRID, RESET POSITION, RESET ROTATION, RESET SCALEAn object is selectedAs in the TRANSFORM panel
MAKE EDITABLE⇥The object selected last can become a mesh and is not one yetTurns it into a mesh and starts poly edit
ENTER POLY EDIT or EXIT POLY EDIT⇥The object selected last is already a meshEnters or leaves poly edit
GROUP⌘GTwo or more items are selectedPuts the selected items that are in no group into a new group
UNGROUP⌘⇧GA group is selectedTakes the selected items out of their groups, and dissolves a selected group
BOOLEAN UNIONThe selected objects can be combinedAs UNION in the BOOLEAN menu
BOOLEAN SUBTRACT, BOOLEAN INTERSECTEvery other selected object overlaps the one selected lastAs in the BOOLEAN menu
SPLIT X, SPLIT Y, SPLIT ZOne closed solid is selectedAs in the right-click menu of an object

Materials and skies

CommandListed whenEffect
MATERIAL: and a preset's name, such as MATERIAL: BRUSHED METALSomething is selectedGives the material to every selected object, in one undo step. The presets that come with Orbit are listed first, then saved ones.
SKY: and a preset's name, such as SKY: SUNSETAlwaysReplaces the scene's environment with the preset, in one undo step. The presets that come with Orbit are listed first, then saved ones.

Poly edit

Listed only in poly edit. Most of these act on the selected points, edges or faces of the current mode, as the matching buttons in the INSPECTOR do. Where the button takes its amount from a slider, the palette uses a fixed amount, given in the table; the sliders are described in Mesh editing tools.

CommandListed inEffect
SELECT ALL, DESELECTEvery modeSelects or deselects everything in the current mode
GROW SELECTION, SHRINK SELECTIONEvery modeAs GROW and SHRINK, which widen or narrow the selection by one ring
INVERT SELECTIONEvery modeAs INVERT, which swaps selected and unselected elements
SELECT TOUCHINGEvery modeAs TOUCHING, which adds everything connected to the selection
WELD or COLLAPSEWELD in point mode, COLLAPSE in edge and face modeWELD fuses the selected points into one at their center. COLLAPSE shrinks each selected edge or face to a single point.
FLATTENEvery modeMoves the selection onto its best fitting plane
RELAXEvery modeSmooths the selection toward its neighbors, at the strength of one click of RELAX
JITTEREvery modeMoves the points of the selection by random amounts, with JITTER AMT at 0.1
MERGE POINTSEvery modeFuses points anywhere in the mesh that are closer together than a MERGE DIST of 0.02
OPTIMIZEEvery modeRebuilds the whole mesh with fewer faces, with REDUCE % at 50. Unlike the button, it ignores the selection.
SUBDIVIDE, SPIKEY, BRIDGEFace modeAs the buttons, with SPIKE HT at 1.0 for SPIKEY
SPIN EDGE, SELECT LOOP, LOOP CUTEdge modeAs SPIN, LOOP and LOOP CUT
BEVEL EDGESEdge modeAs BEVEL, with BEVEL W at 0.1 and one segment
ARM KNIFEEdge modeAs KNIFE. The next drag across the mesh cuts it.
TOGGLE SOFT MAGNETPoint and edge modeTurns SOFT MAGNET on or off

See Edit a mesh point by point.

View modes and switches

Always listed.

CommandHintEffect
VIEW MODE: SHADED, VIEW MODE: WIREFRAME, VIEW MODE: FLAT, VIEW MODE: MATERIALChooses what the viewport draws, as the four icons in the controls panel do
TOGGLE GRIDSwitches SHOW GRID in SETTINGS
TOGGLE INFINITE GRIDSwitches INFINITE GRID in SETTINGS
TOGGLE WORLD AXISSwitches WORLD AXIS in SETTINGS
TOGGLE FPS READOUTSwitches FPS READOUT in SETTINGS
TOGGLE LIVE PREVIEWOpens or closes the LIVE preview
TOGGLE SNAPSwitches SNAP in the controls panel
PIVOT: MEDIAN / EACHSwitches between MEDIAN and EACH in the controls panel
TOGGLE AUTO ORBITStarts or stops ORBIT
TOGGLE BOTTOM DOCK⌘JHides or shows the dock
EXPAND / COLLAPSE VIEWPORT⌘0Hides or shows the column of object buttons, OBJECTS and INSPECTOR

Sheets and panels

Always listed.

CommandHintEffect
OPEN SETTINGSOpens the app settings as a sheet
OPEN RENDER SETTINGSOpens RENDER SETTINGS
WELCOME SCREENOpens the WELCOME sheet
EXPORT RENDEROpens EXPORT RENDER
EXPORT TURNTABLE⌘⇧EOpens EXPORT TURNTABLE
MATERIAL BROWSERMOpens the MATERIAL BROWSER
ENVIRONMENT BROWSER⌘EOpens the ENVIRONMENT BROWSER
SCENE WIZARD⌘⇧NOpens the SCENE WIZARD panel without keeping a copy of the scene. CANCEL then undoes the last change made before the panel opened, and the scene does not come back. Its hint, ⌘⇧N, is the shortcut of File ▸ New from Scene Wizard…, which opens the wizard with that copy. See Open the Scene Wizard from the File menu.

Files

Always listed.

CommandHintEffect
NEW SCENEAs File ▸ New Scene
OPEN EXAMPLE…As File ▸ Open Example…
IMPORT OBJECT (.ORBITOBJ)…As File ▸ Import Object…
IMPORT WAVEFRONT OBJ…As File ▸ Import Wavefront OBJ…
SAVE SCENE⌘SAs File ▸ Save Scene
SAVE SCENE AS…⌥⇧⌘SAs File ▸ Save Scene As…
OPEN SCENE…⌘OAs File ▸ Open Scene…
OPEN: and a file name, such as OPEN: DUNES.ORBITOpens that recent scene, after asking about unsaved changes. Listed for each scene in Open Recent whose file still exists.

Related: Run any command by name, The window, Keyboard shortcuts and mouse gestures and What undo covers.