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.
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.
| Input | Description |
|---|---|
| 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. |
| Trajectory | TUM 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 |
Camera modes
Section titled “Camera modes”| Mode | Camera | Frames |
|---|---|---|
trajectory | Rides along the trajectory with a configurable pose relative to the base frame and viewing direction | One per trajectory pose; resample the trajectory for a constant camera speed |
turntable | Orbits the clouds on a cone, looking at the center; center and distance can fit the clouds automatically | camera.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.
Output
Section titled “Output”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".