Skip to content

Rendering Profiles

FormerLurker edited this page Mar 21, 2018 · 9 revisions

These profiles determine how your series of snapshots will be turned into a timelapse. You can set the timelapse to have a fixed length (say 5 seconds) or use a constant FPS. You can add pre or post-roll frames so that your timelapses don't start or stop abruptly. The default output is MP4, which is required in order to (optionally) synchronize with the default timelapse plugin. When synchronizing with the default plugin, your timelapses will appear in the native timelapse plugin tab after rendering is complete.

click to see the tab The main settings tab

You can get to the rendering profiles by opening the Octolapse settings and clicking on the 'Rendering' tab.

click to see the profile The main settings tab

Timelapse Generation

Enable or disable rendering completely if you only want to take snapshots.

Output and Sync

Output File Format

Choose the output format. Pick MP4 if you want your timelapses to synchronize correctly with the build-in plugin. Let me know if you have any format requests. If they are easy to implement and there is demand, I'll consider adding them. Be sure to create an issue in the repository for your feature request. This is a really good idea because Octolapse currently has no native file browser for timelapse video.

Sync Output

This only works when using MP4 video (need to look into this), but is HIGHLY recommended since Octolapse has no built in file browser.

Quality and Duration

FPS Type - Fixed Run Length

Fixed run length video features a calculated FPS so that your timelapses have the proper duration. Please note that pre and post roll time is NOT included, and that the Minimum and Maximum FPS will be applied if the calculated FPS is higher or lower than these settings.

For example, a 10 second fixed length video with 1 second of pre roll and 1 second of post roll and 100 frames will be 12 seconds long at 10 FPS

that will fit to the Choose from Fixed Run Length or Fixed FPS (Frames per Second).

FPS Type - Fixed FPS

The entered FPS will be used regardless of the number of snapshots taken.

Bitrate

This determines how much data is packed into every second of video. In general a higher bitrate video will be better quality than a lower one. However there are diminishing returns for higher (and lower) bitrates, and your final video will never exceed the quality of the snapshots used.

Advanced Rendering Options

Filename Template

This is a beta feature, but I've tested the default template extensively.

You can use several available tokens to build your output filename. The extension is automatically added, and the plugin will not overwrite any existing videos. If a duplicate is detected, octolapse will append the filename with the lowest number possible that will make the file name unique. For example, Video.mp4 would turn into Video2.mp4 if there is already a Video.mp4, Video1.mp4 and Video3.mp4

Here is the list of available tokens

  • {FAILEDFLAG} - Will be replaced with FAILED if the print does not complete successfully
  • {FAILEDSTATE} - Will be replaced with the failed state, or will be empty of the print is successful
  • {FAILEDSEPARATOR} - If the print fails, this will be replaced with an underscore (_), else it will be empty
  • {PRINTSTATE} - The end state of the print, whether it fails or succeeds
  • {GCODEFILENAME} - The name of the gcode file without the extension
  • {DATETIMESTAMP} - Unix epoch of the rendering time.
  • {PRINTENDTIME} - YYYYMMDDHHMMSS formatted print end time, the same format used in the default timelapse plugin
  • {PRINTENDTIMESTAMP} - Unix epoch representation of the print end time
  • {PRINTSTARTTIME} - YYYYMMDDHHMMSS formatted print start time, the same format used in the default timelapse plugin
  • {PRINTSTARTTIMESTAMP} - Unix epoch representation of the print start time
  • {SNAPSHOTCOUNT} - The number of snapshots captured, excluding pre and post roll (I think)
  • {FPS} - Frames Per Second of the rendered video as an integer (no decimal points)

The plugin attempts to verify the resulting filename, but there are some potential hazards. If the template fails for some reason your timelapse will be given the following name: RenderingFilenameTemplateError

If you have a failure, please send me an error report, and be sure to include the template you used!

Flip Horizontal

Flip the resulting video along the horizontal axis.

Flip Vertical

Flip the resulting video along the vertical axis.

Rotate 90 Degrees

Rotate the resulting video 90 degrees

Embed Watermark

There are issues with this option, please do not use for now, else your renderings may fail.

Clone this wiki locally