Postshot User Guide

v0.5

2024-12-23

Download for Windows


Changes

After Effects

  • Show error message if Postshot file fails to load (io. just rendering empty output)
  • Fixed a crash when opening a Postshot scene file in some cases

CLI

  • Added --export-splat-ply option
  • Added sub-commands `train` and `export`. See `--help`, `train --help` and `export --help` for more details.
  • Added `--login` and `--password` option to allow for non-interactive login

Export

  • Exporting cameras without keyframes did not work
  • Fixed incorrect colors in .ply exports if Rdnc Field was rotated
  • Fixed: File/Export Splat Model did not show file selector if project filename had multiple extensions.

Framework

  • Fixed issues that occurred when username contains unicode characters. This included a "No Radiance Field selected" error
  • Fixed a Vulkan issue during startup on some systems with mixed vendor GPUs
  • Fixed a failure during startup on some systems

Import

  • Remove nested folders from import to prevent duplicates and errors when saving project

Image

  • Fixed an issue that caused image selection to hang or abort if a video contained dropped or corrupted frames
  • Fixed a sporadic crash during Camera Tracking stage 1
  • Fixed: incorrect colors when training on RGBA images with 16bit colors

Installer

  • Fixed an issue that could cause the installer to fail or the app to not start at all
  • Some types of errors were not shown when the installation fails

NeRF

  • Removed NeRF profiles

Render

  • Improved render performance
  • Fixed: output image/video resolution was incorrect in some cases
  • Fixed: render to video resulted in empty files in some cases
  • Fixed: stored render output was vertically flipped after recent change
  • Fixed: first frame of render output was not animated correctly in some cases

Scene

  • Support multiple Rdnc Field nodes in the scene
  • Support importing other .psht or .ply files into the scene
  • Added Viewport Camera node to control the implicit camera parameters
  • Moved some Rdnc Field/Render parameters to Camera/Rdnc Field
  • Support playback/render of splat model sequences

Loading Splat Model Sequences

Import (drag&drop) multiple .PSHT or .PLY files. Each file will correspond to one frame.

Splat

  • Added 'Treat Zero Alpha as Mask' training option
  • Allow to reduce the splat count during training in the Splat MCMC profile
  • Fixed broken training when RdncField transform was non-zero
  • Don't abort training when encountering degenerate training views, only log warning

UI

  • Importing animated cameras from .abc files did not work after recent changes
  • Added visbility toggles for Rdnc Field nodes in scene tree
  • Some failures during .psht scene loading did not show specific error messages
  • Translate viewport camera using left+right mouse button (alternative to middle button)
  • Transform handles were scaled incorrectly if Rdnc Field was scaled
  • Always popup message dialogs centered on main window io. following mouse
  • Fixed an issue that caused Recent Files menu to clear regularly
  • Fixed an issue that could cause a hang on startup in some cases
  • Fixed a crash in some cases during shutdown if no supported GPU was found
  • Fixed: render job hung on first frame in some cases until other UI activity released it
  • Fixed: import dialog displayed incorrect total image count in some cases if 'Use All Images' was selected
  • Fixed: Image Set/Locate Files button did not show if files went missing while project was open
  • Fixed hang in file dialogs (open/save) after rendering to video files
  • Fixed: changing file path parameters (e.g. Camera/Render Output) did not retain current path in file dialog
  • Fixed crash during shutdown in some cases
  • Fixed: Splat selection did not follow mouse correctly after recent change
  • Fixed: Camera/Track Target did not update correctly after recent change
  • Fixed: continuing training on project w/o train context did not show warning
  • Fixed an issue that could cause tabs to incorrectly remain in drag-mode
  • Fixed: render update during training did not activate immediately when continuing training
  • Fixed a crash when quitting the app from the login window
  • Fixed: Training could not be started after import if camera poses were dropped in a separate step from the images

Unreal Engine

  • Added plugin for Unreal Engine 5.4 and 5.5
  • Render Radiance Fields only in view modes Lit, Unlit, DetailLighting and if Show/Advanced/Heterogeneous Volumes is checked
  • Support multiple RdncFields per PSHT scene and multiple PSHT scenes per UE level
  • Support VR stereo rendering

Using Postshot projects in Unreal Engine

  • Drag&drop .psht files into the Content Browser tab of Unreal Editor.
  • Drag&drop the Asset into the viewport, creating an Actor that shows up in the Outliner tab.
  • Some RdncField rendering options are in Project Settings/Plugins/Postshot