- 15 Jan 2025
- 6 Minutes to read
- Print
- DarkLight
- PDF
Performance and Options (7)
- Updated on 15 Jan 2025
- 6 Minutes to read
- Print
- DarkLight
- PDF
You will find the Performance and Options sections on the right side of the Scene view window. Here, you find information on processing time (the time it takes for Composer to render one frame), uptime, errors and warnings since the application started, etc. The most important thing to keep track of (from a performance perspective) is the processing time. Other KPIs:s and functions are more useful when debugging or tracking issues.
The performance of Composer is dependent on the server hardware. Find more information about tuning your server.
The panel contains two tabs, Performance and Options.
Performance tab
The performance tab contains the most essential information about your project and system performance.
Live Preview
Using the Live Preview feature, you can share your live stream of the Scene view using Vindral CDN. The Live Preview feature aims to make it possible to share your creation with stakeholders, customers, or colleagues. The output of the Live Preview has a limitation of 10 simultaneous viewers and is not designed to broadcast to a broader audience. Contact RealSprint to get access to an unlimited Vindral channel, with global access, for thousands of viewers all over the globe.
Click "Start" to start the Live Preview broadcast. Click "View in Browser" to open up a Vindral QoS player where you can watch the live stream. To share the stream, copy and share the URL of the QoS player.
The Live Preview section is only available if enabled in Settings, and requires a valid production- or evaluation license.
Performance
Below the FPS dropdown, you will see the current processing time (in ms) and an average processing time over the last 10,000 frames. The nominal value represents the number of milliseconds available when rendering a single frame. We recommend that your processing time should not exceed 80-90% of the nominal time. More information on performance can be found in the Performance and Optimization chapter.
Framerate
In the circle's center, you set your setup's frame rate (FPS). To change the framerate, unlock the setting using the Lock icon. Note that inputs will be stopped when unlocking. Restart the inputs after the frame rate has been changed.
For camera inputs (Blackmagic capture), the frame rate must match your project's frame rate.
In general, it is preferred to use media files and input sources that have the same framerate as your project.
The red dot in the top-right corner of the performance indicator appears when the "Processing Queue Length" exceeds 0. This indicates that Composer is "overloaded" and unable to process all frames in real-time.
The available processing time for each frame is dependent on the framerate. A setup running at 50 FPS has 1/50 of a second available for processing (=20ms), while a setup running at 25 FPS has 1/25 of a second available (=40 ms). Using higher frame rates requires more GPU power compared to lower frame rates. The most common frame rates are 50, 29.97, and 25 FPS.
Project Statistics
- Project: Filename of the current running project. If the running project is stored in the Projects folder, the information will only contain the filename (not the full file path)
- Congestive frames: The number of frames where the processing time has exceeded the available time. For example, if the project runs at 50 frames per second, the available processing time is 20ms for each frame. Thus, if the processing time for a single frame exceeds 20 ms, the number of congestive frames will increase. If you have a high number of congestive frames, your system might be overloaded or not optimized.
- Processing queue length: The number of frames waiting in the queue for processing. If the number exceeds 50, Composer will restart the rendering engine and an error will be logged. In a normal, healthy setup, the processing queue is 0, or close to.
- Max processing time (ms): This property will show the max processing time from the last 50 frames.
- Application started: Date/time for application start
- Session started: Date/time for session start
- Session uptime: Uptime since the application was started
- Reported errors: Total errors since the application was started.
- Last error: Date/time and message of the latest error
- Reported warnings: Total warnings since the application was started.
- Last warning: Date/time and message of the latest warning.
- Alarm activated: Date/time when the last alarm was triggered.
- Alarm counter: Number of alarms triggered.
- Alarm cleared: Date/time when last alarm was cleared.
- Alarm active: The alarm has been triggered. Press the button to clear the alarm manually. The alarm will be automatically cleared after the configured time (configured in Settings/Alarms).
- Authorized Api calls: The number of authorized (accepted) Api calls
- Last authorized Api call: Date/time of the last API call
- Open log window - opens the log window :)
CPU and GPU performance
- CPU usage: Current CPU Utilization.
- RAM Usage: Current memory utilization
- GPU Power usage: Current power utilization
- GPU Power usage: Current Power consumption of the GPU
- GPU Power Management: Nvidia "Prefer maximum Performance" enabled
- GPU Power State (0-8): In what Power state is the GPU running in. (0 = fastest, 8 = slowest)
- GPU Utilization: Current GPU Utilization. (This is dependent on the GPU Power state)
- GPU temperature: The current temperature of the GPU. NVIDIA GPUs should typically not exceed 83°C or thereabouts. To achieve maximum boost clocks and the best performance, it is usually beneficial to keep the temperature at or below 60°C.
- NVENC Utilization: NVENC utilization (Nvidia encoding)
- NVDEC Utilization: NVDEC utilization (Nvidia decoding)
- GPU PCIe Link Width: PCIe width determines the number of PCIe lanes that can be used by the GPU for memory I/O. For a Nvidia GPU, it is recommended to use an x16 PCIe slot.
- GPU Memory (Total/Used/Free): Current GPU memory usage: total, used and free.
Audio meters
The 2-channel peak meter displays the audio peak levels of the currently active scene. The peak value is stored and displayed on the right side of the audio meter. The peak value indicator will turn red if the value is above 0dbfs (above the accepted level). To reset the value, press the red indicator.
Options
Sync source
The sync source determines which input is used to synchronize the internal rendering clock/timer in Composer. By default, this is set to the System Clock (CPU), meaning Composer operates its internal clock independently of any external inputs. This setting is the most common and works in 99 out of 100 setups. It should only be changed if you're experiencing issues with skipped or duplicated frames.
If you're using camera inputs and need precise synchronization between the camera and Composer, it may be beneficial to sync Composer with an external input. This ensures that timing variations or fluctuations in either the camera or Composer won't cause glitches like skipped or duplicated frames. It's important to note that the primary cause of skipped frames is often system overload, rather than sync source issues.
When a Decklink input is used as the sync source, Composer’s internal rendering clock becomes dependent on the sync source (the camera). Frame processing in Composer is triggered as soon as a new frame is received from the Decklink capture input.
If there are several Decklink inputs, use the Decklink input with audio as the sync source.
Script Engine
- Engine Status: Status of the Script Engine.
- Script: Filename of the script that is running.
- Execution time: Time to execute the script in ticks and ms.
- Error message: Error log message
- Reload button: Reloads the script
- Edit button: Opens the script in the default editor.
More information on the Script Engine can be found here.
Autostart
- Autostart inputs - enable this option to automatically start all inputs when the application is started (or project loaded). In most production scenarios, this option should be enabled.
- Autostart targets - enable this option to automatically start all targets when the application is started (or project loaded). In most production scenarios, this option should be enabled.
Scene view overlay
Composer offers a built-in feature to create and save reference images of scenes. This enables you to capture and store an image that represents the intended appearance of the scene output.
This feature is especially helpful for alignment or comparing the current setup with the scene's original state when the project was first created.
In live casino studios, where cameras or tables might accidentally be moved, this functionality proves particularly useful.
To use it, simply Save a Reference Image, and activate Show Project Reference Image option.
The example above illustrates a scenario where the camera has been slightly moved. By enabling the "show project reference image" option, the changed camera position can be easily be detected.