Skip to content

slamlab-render

Renders a video of the results of slamlab-offline: the point clouds in the map frame and the trajectory. The camera either rides along the trajectory or orbits the clouds. Overlays show text, e.g. the traveled length, camera images, static images such as a logo, and a top view of the camera path.

Terminal window
slamlab-render <config_filepath>

The single required argument is the path to a YAML configuration file. The executable reads the slamlab_render section. --help prints the usage, --version the version.

The video is encoded by ffmpeg, which must be on PATH. With video.headless, the frames are rendered off-screen with EGL, without a window, e.g. on a server without a display.

InputDescription
Clouds.ply, .las or .laz files in the map frame with point stamps, e.g. the clouds_map_frame artifacts. Depending on the color mode, the points need the attributes intensity, pca (normals) or red, green and blue.
TrajectoryTUM file, e.g. the trajectory_tum.txt artifact
Images (optional)Camera images named <sec>.<nsec>.<jpg|jpeg|png>, e.g. the images of slamlab-offline-importer
ModeCameraFrames
trajectoryRides along the trajectory with a configurable pose relative to the base frame and viewing directionOne per trajectory pose; resample the trajectory for a constant camera speed
turntableOrbits the clouds on a cone, looking at the center; center and distance can fit the clouds automaticallycamera.turntable.num_frames

Before the rendering, the trajectory can be filtered by time, resampled to a uniform spacing along its length and smoothed. The processed trajectory is the camera path in trajectory mode and can be drawn as a curve.

One video file at video.filepath, e.g. an H.264 .mp4, with one frame per camera pose. The progress is printed per frame; at the end the number of written frames, e.g. Wrote 360 frames to "render.mp4".