Skip to main content

Lightfielder Viewport | Hotkeys

Viewport

General​

KeyAction
TabToggle camera mode (Orbit / FPS)
QSelection mode
ETransform mode
FFrame all geometry in viewport
HReturn camera to home position
RCycle render style
F6Toggle History Stack window
F7Toggle Outliner window
F8Toggle Attributes window

Display Toggles​

KeyAction
GToggle grid
VToggle vertex markers
NToggle face normals
XToggle X-Ray overlay
[ / ]Decrease / increase normal length
/Toggle HUD visibility

Edit​

ShortcutAction
⌘ + ZUndo
⌘ + Shift + ZRedo
⌘ + XCut
⌘ + CCopy
⌘ + VPaste
⌘ + ASelect All
⌘ + Shift + ADeselect All
⌘ + DDuplicate selected object
⌘ + GGroup selected objects
⌘ + Shift + GUngroup selected objects
⌫Delete selected objects
⌘ + HHide / Show selected object

File​

ShortcutAction
⌘ + NNew Scene
⌘ + OOpen Scene
⌘ + SSave Scene
⌘ + Shift + SSave Scene As

Mouse Controls (Orbit mode)​

ActionInput
OrbitLeft drag
PanRight drag or middle drag
ZoomScroll wheel
Select objectLeft click (in Selection mode)

Mouse Controls (FPS mode)​

ActionInput
LookLeft drag
MoveWASD / Arrow keys
Move up/downSpace / Shift
Move forward/backScroll wheel

File​

Menu

ItemShortcut
New > New Document⌘ + N
Open…⌘ + O
Open Recent >
Save⌘ + S
Duplicate⌘ + Shift + S
Rename
Move To…
Revert To…
Share

Edit​

Menu

ItemShortcut
Undo⌘ + Z
Redo⌘ + Shift + Z
Cut⌘ + X
Copy⌘ + C
Paste⌘ + V
Select All⌘ + A
Deselect All⌘ + Shift + A
Duplicate⌘ + D
Group⌘ + G
Ungroup⌘ + Shift + G
Local Transform(checkmark)
World Transform(checkmark)
Delete⌫
Delete Meshes(no shortcut)
Delete Lights(no shortcut)
Delete Cameras(no shortcut)

View​

Menu

ItemShortcut
Show Tab Bar
Show All TabsShift + ⌘ + \
Selection ModeQ
Transform ModeE
Shaded
Bounding Box
Points
Wireframe
None
GridG
Cameras
Lights
Locators
VerticesV
NormalsN
Edges
X-RayX
Hide Selected⌘ + H
Look Through Selected
HUD/
FPS
Details
Distance
Render
123
Selected
Camera View
Enter Full ScreenFunc + F

Create​

Menu

ItemShortcut
Camera
Locator
Group
Reference
Cube Mesh
Cone Mesh
Sphere Mesh
Cylinder Mesh
Pyramid Mesh
Torus Mesh
Ambient Light
Area Light
Directional Light
Dome Light
Point Light
Spot Light
Sphere Light
Tube Light

Scripts​

Menu

ItemShortcut
Open Scripts Folder
Hello CPython World.py
Hello LuaJIT World.py
  • The Open Scripts Folder menu item uses the OS native folder browsing window to show the ~/Library/Application Support/com.Lightfielder.Viewport/Scripts/ folder in Finder.
  • The Listed scripts .py and .lua files in the Scripts folder appear as menu items

Window​

Menu

ItemShortcut
Bring All to Front
Save Window Layout
Open Layouts Folder
Compact Layout
Default Layout
LG Ultrawide
MacBook Air Laptop Layout
MacBook Air Outliner History Persp Attributes Layout
Skinny Layout
Wide Monitor Layout
History StackF6)
OutlinerF7
AttributesF8
  • Save Window Layout menu item saves the current window positions/sizes as a .jsonc layout file
  • Open Layouts Folder menu item opens the Layouts directory in Finder
  • Saved layouts menu item shows the previously saved layouts as loadable menu items

History Stack​

The History Stack window (F6) displays a three level hierarchy of all undoable actions in collapsible speech-bubble capsules. Each event block shows a timestamp, duration, and category color. Events of the same category are automatically grouped into a parent capsule with dynamically appended children.

History Stack

Three-Level Hierarchy​

  1. Exploration Blocks (root level)
    Each creative iteration is wrapped in an "Exploration N" block. When you undo then perform new actions, a new exploration block is automatically created, preserving old history as inactive (diagonal stripe overlay). Click the + button in the toolbar to manually create a new exploration branch. Click an exploration block's title to inline-rename it.

  2. Category Groups (children of exploration blocks)
    Auto-grouped by event category (Navigation, Display Toggles, Selection, Create, etc.). Each category group composites its undo/redo across all its individual operations. Undo/redo at this level is ⌘+Z/⌘+Shift+Z within the current block (within-block undo), or jumps between entire exploration blocks (block-level undo when at block boundaries).

  3. Individual Operations (children of category groups)
    Atomic events like "Zoom", "Pan", "Toggle Wireframe", "Adjust Up". Always undone/redone as part of their parent category group.

Undo/Redo Behavior​

  • Within-block
    ⌘+Z undoes the last category group in the current exploration block. ⌘+Shift+Z redoes the last undone category group. Each category group's children are undone/redone together.

  • Block-level
    When at the first category group of a block, ⌘+Z jumps to the previous exploration block (undoing all its events). ⌘+Shift+Z from a fully-active block jumps to the next exploration block. Block-level navigation is also available via the ↩/↪ buttons on each block.

  • Exploration branching
    If you undo to a previous block and perform new actions, a new "Exploration N" block is created with those actions, while the old future blocks remain visible as inactive history. You can always navigate back to them.

Save / Load​

The Load and Save toolbar buttons default to the History/ subfolder under ~/Library/Application Support/com.Lightfielder.Viewport/. Saved JSONC files store the full event tree including event IDs, categories, timestamps, elapsed times, the current undo/redo position, within-block undone event IDs, and per-event fold/unfold states. Loading a file fully restores the History Stack UI to its saved state.

Toolbar​

ButtonAction
Open EventsLoad .jsonc history file from disk
Save EventsSave history to .jsonc file
TrashClear all events and start fresh
+ (orange)Create a new exploration block manually
CompressFold all group capsules
ExpandUnfold all group capsules

Event Categories​

CategoryColorIconExamples
ExplorationOrangepoint.topleft.down.curvedto.point.bottomright.upExploration 1, Exploration 2
EditRedpencilDelete, Delete Meshes, Delete Lights, Delete Cameras, Duplicate
SelectionPinkcheckmark.circleSelect All, Deselect All, Solo On/Off
NavigationCyanmove.3dOrbit, Pan, Zoom, Move, Frame All, Go Home
Nav GroupCyansquare.stack.3d.forward.dottedlineNavigation (grouped)
ModePurplearrow.triangle.swapSwitch to orbit/fps
DisplayGreeneyeGrid, Wireframe, X-Ray, HUD, Vertices, Normals toggles
Normal LengthOrangearrow.up.arrow.downAdjust Up/Down
CreateBlueplus.squareCreate Cube, Sphere, Camera, Locator
LightYellowlightbulbSet Light
SceneWhitedocNew/Open/Save Scene
VisibilityTealeye.fillShow/Hide object, Enable/Disable light, Solo
TransformMintarrow.triangle.2.circlepathSelection Mode, Transform Mode
Reparent(default)(default)Group, Ungroup, Reparented