Video Recorder
Overview and Key Concepts
The Video Recorder is an object that is added to the Tools folder of the model tree when the Video Recorder option is selected in the Tools menu. The Video Recorder is based on the FFmpeg video solution, and enables the user to record high quality videos of their model, utilizing camera flypaths, layers, and animations if desired. This functionality is obtained by use of output files, sequences, and layers.
The Video Recorder can be accessed from the Toolbox.
Output Files
The Video Recorder allows the user to record multiple output files at one time. Each output file can have a different size, framerate, codec, and file type. This can be especially useful for long recordings with complicated models, where it can take hours to record, since you can record all of the views you want in one run. By default, output files are encoded using a variant on MPEG-4 and written to the .mp4 file format.
Sequences
Each output is made up of sequences. Sequences are what defines when to start and stop recording during your model run. A single output can have as many different sequences as you want, so you can capture only the relevant points of your simulation. However, only one sequence is required to make one file, and by default only one sequence is used per output. If you want more than one sequence in a single output, select the Use Shared Sequences option.
Layers
Layers allow you to record multiple views of a model in a single video. You can customize the size and position of each layer to arrange the views of your model. By default, there is only one layer, and it is sized so that it matches the output size.
Recording a Video
The following sections explain how to record videos.
Recording a Simple Video
The Video Recorder is designed to make recording simple videos of your model as easy as possible. For example:
- Open the Video Recorder window (add an Video Recorder object to your model) by going to the Toolbox, then point to Visual, then select Video Recorder.
- Specify your output file path by clicking the browse button.
- Click the sampler button next to View and click on your model.
- Your video is now ready to record. If desired, set the size, FPS, codec, start and end times, speed, and flypath options to fit your needs.
- Press the Record button.
- Your model will reset and run, and you will see a popup in the top left corner displaying recording progress.
- When finished, the popup will disappear and your video file will appear at your specified path.
Recording a More Complex Video
In this example we will utilize Shared Sequences and some of the advanced layer options:
- Open the Video Recorder window and specify the output file path as above.
- Click the Shared Sequences tab.
- There should be one Sequence available to edit. Set the End field to 30 and the Speed to 2.
- The background of this video will be a solid color. Change the Type to Color and pick a dark blue.
- Add another layer by clicking the Add button above the Layers list.
- Make sure the Type of the new layer is View. Set the View to your model view by using the sampler button as above.
- Change the mode in Size to Custom, and set the length and width to be 20 pixels less than your output length and width.
- From the picklist in the X field, choose Slide In/Out. Change the first popup field to be 10, and have it slide in for 10 seconds. This will make it so that the model view will start off the screen, slide in for 10 seconds, and stop when the left edge of the model view is 10 pixels from the left edge of the video.
- Set the Y field to be 10.
- Switch back to the Output tab. Change the mode from Use Basic Sequence to Use Shared Sequences.
- Using the button, select your sequence from the drop down list.
- Press the Record button.
The recorded video should display the model view sliding in from the left, stopping centered in the blue background.
The Output Tab
The following image shows the Output tab of the Video Recorder dialog:
The following sections explain the properties found on this tab:
Output Files
This view lists the names of the output files that will be created when recording. To add another output file, click the Add button . To remove an output file, select the desired output in the list and press the Remove button . When an output is selected, details about that output are displayed in the right portion of the tab. If the box next to the output name is cleared, that file will not be produced during the next recording.
Record
Click this button to create the output files. The model will reset and run, allowing the Video Recorder to create the output files.
File Path
This specifies where the output file will be saved. The path can be set manually or by clicking the browse button. If you want to use a video container other than .mp4, you can specify the extension here. You can specify any container supported by FFmpeg.
Codec
This is the codec the video will record in. MPEG-4 is the default codec, and will record in high quality. H.264 is a widely accepted codec for recording high quality video in low file sizes. If you want to use a different codec, you can enter in the standard FFmpeg command line syntax for codec options here.
FPS
This field indicates how many frames per second will be recorded. You can save rendering time and output file size by lowering this number. However, values below 30 will cause your videos to look choppy.
Size
This is the size of the video, in pixels. Use the dropdown to select one of the presets, which are standard video sizes. You can also enter custom values.
Use Basic Sequence
Use this option to create simple videos. When you use this option, the following properties are available:
- Start - The start time (in model time) of the video
- End - The stop time (in model time) of the video
- Speed - The model speed
- Duration - The total length of the output video. This is calculated from the previous three properties.
- View - The view used to record the video. Please note that only some views may be recorded by the Video Recorder.
- Enable/Disable Preview - When selected, you will see your model running as the video is recorded. Disable this option to improve recording time.
- Flypath - The flypath to use. None by default.
Use Shared Sequences
This option allows you to create more complex videos, including videos with multiple layers. When you choose this option, you can add and remove sequences to the selected output file. You can create and edit sequences on the Shared Sequences tab.