Raw Recording

Record all video sources and have the ability to record custom data. For example, control signals in plugins. Single video sources can also be recorded.

Use Case

A raw recording can be used to playback scenarios that have been recorded. For example, if the developer does not have access to the vehicle for testing.

Recording

Start the recording by clicking the Start Recording button. The recording will be saved to the destination folder.

Single Entity Raw Recording

It is also the possibility to record a single entity. This will only produce a raw recording of that specific entity.

Destination folder: Folder where the recorded video and playback project will be saved to.
Create Folder: Create a folder on save containing the files of the raw recording.
Frameskip: Skips frames to reduce framerate in recording to save disk space
Use Ringbuffer: Set maximum disk space to be used for recording. When max disk space usage is reached the oldest frames are overwritten.
Use Time Based Ringbuffer: Changes the setting for max recording to be dependent on the time period of the recording instead of the disk space usage.

Playback

To play a raw recording, open the folder containing the raw recording project (.vproj) file and open it. Under Raw Recording Playback settings will now appear and the recording playback can be started.

Loop: Checkbox if the recording should loop.
Loop Start/Stop Time: Start and stop time of the loop sequence.
Min: Recording start time.
Max: Recording stop time.
Time: Date and time of when the recording was recorded.

Extract Frames to Disk

Extract frames in recording for a specific entity.

Start capture by selecting an entity in the drop down menu and pressing the start extraction button that appears. The captures are taken base on the intervals setting configuring the time between captures. If a delay between the frame captures is desired, the wait time setting can be used to delay the frame capture.

Destination Folder: Folder where the extracted frames will be saved to.
Interval: Time between frame captures.
Wait Time: Wait time between intervals.
Extraction Frames: Number of frames to be extracted.
Entity: Which entity the frames should be extracted from.

Important Notes (Corrupted Recording)

If the software crashes or is exited while the raw recording is started, the recording might result in corrupted video streams. Make sure to stop the recording before exiting.

If the software is started through the terminal and CTRL+C is used to stop, the recording might also be corrupted.

Conversion .vraw → Other Formats

Voysys raw (.vraw) recording format can be converted to other formats using ffmpeg by using the tool provided at https://github.com/voysys/vraw_convert.