Properties Pane: Camera
When a camera, or a camera group, is selected from the Devices pane, related camera settings will be displayed in the Properties pane. From the Properties pane, you can configure the camera settings so that it is optimized for your capture application. You can enable/disable IR LEDs, change exposure length of the cameras, set the video mode, apply gain to the capture frames, and more. This page lists out properties of the cameras and what they are used for.
Advanced Settings
The Properties: Camera contains advanced settings that are hidden by default. Access these settings by going to the menu on the top-right corner of the pane and clicking Show Advanced and all of the settings, including the advanced settings, will be listed under the pane.
The list of advanced settings can also be customized to show only the settings that are needed specifically for your capture application. To do so, go the pane menu and click Edit Advanced, and uncheck the settings that you wish to be listed in the pane by default. One all desired settings are unchecked, click Done Editing to apply the customized configurations.
![](https://docs.optitrack.com/~gitbook/image?url=https%3A%2F%2F2498944597-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F5yEhrhQepNQfhsDzAh6n%252Fuploads%252Fgit-blob-bc94d0abff26838260a68c690b3ad86dcb4c9c72%252Fimage%2520%281007%29%2520%281%29%2520%281%29%2520%281%29%2520%284%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=ed11e731&sv=1)
General Settings
![](https://docs.optitrack.com/~gitbook/image?url=https%3A%2F%2F2498944597-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F5yEhrhQepNQfhsDzAh6n%252Fuploads%252FOdpiHSOlr8qIyg0CDcRD%252Fimage.png%3Falt%3Dmedia%26token%3D50f8e028-ac20-4c84-8d2e-5ee8dbc36765&width=768&dpr=4&quality=100&sign=42943bb6&sv=1)
Enabled
Enables/disables selected cameras. When cameras are disabled, they don't record any data nor contribute to the reconstruction of 3d data.
Rate
Shows the frame rate of the camera. The camera frame rate can only be changed within the devices pane.
Reconstruction
This setting determines whether or not selected cameras contribute to the real-time reconstruction.
Rate Multiplier
Shows the rate multiplier or divider applied to the master frame rate. The master frame rate depends on the sync configuration.
Exposure
Sets the amount of time that the camera exposes per frame. The minimum and maximum values will depend on both the type of camera and the frame rate. Higher exposure will allow more light in, creating a brighter image that can increase visibility for small and dim markers. However, setting exposure too high can introduce false markers, larger marker blooms, and marker blurring--all of which can negatively impact marker data quality. Exposure value is measured in scanlines for tracking bars and Flex3 series cameras, and in microseconds for Flex13, S250e, Slim13E, and Prime Series cameras.
Threshold
Defines the minimum brightness for a pixel to be seen by a camera, with all pixels below the threshold being ignored. Increasing the threshold can help filter interference by non-markers (e.g. reflections and external light sources), while lowering the threshold can allow dimmer markers to be seen by the system (e.g. smaller markers at longer distances from the camera).
Partition ID
[Advanced] When calibrating multi-room spaces, you can partition select cameras to allow for Continuous Calibration to collect samples from each room and calibrate even when there is no camera overlap between spaces. This creates the ability to have several capture volumes tied to a single system while maintaining continuously calibrated cameras for each space.
LED
This setting enables or disables the IR LED ring on selected cameras. For tracking passive retro-reflective markers, this setting must be set to true to illuminate the IR LED rings for tracking. If the IR illumination is too bright for the capture, you can decrease the camera exposure setting to decrease the amount of light received by the imager; dimming the overall captured frames.
Video Mode
Sets the video type of the selected camera.
IR Filter
Sets the camera to view either visible or IR spectrum on cameras equipped with a Filter Switcher. When enabled, the camera captures in IR spectrum, and when disabled, the camera captures in visible spectrum.Infrared Spectrum should be selected when the camera is being used for marker tracking applications. Visible Spectrum can optionally be selected for full frame video applications, where external, visible spectrum lighting will be used to illuminate the environment instead of the camera’s IR LEDs. Common applications include reference video and external calibration methods that use images projected in the visible spectrum.
Gain
Sets the imager gain level for the selected cameras. Gain settings can be adjusted to amplify or diminish the brightness of the image. This setting can be beneficial when tracking at long ranges. However, note that increasing the gain level will also increase the noise in the image data and may introduce false reconstructions. Thus, before deciding to change the gain level, adjust the camera settings first to optimize the image clarity.
Calibrated
[Advanced] This property indicates whether the selected camera has been calibrated or not. This is just an indication of whether the camera has been processed through the calibration wanding, but it does not validate the quality of the camera calibration.
Details
Basic information about the selected camera gets listed in the Details section
Number
Displays the camera number assigned by Motive.
Camera Type
Displays the model of a selected camera.
Serial Number
Displays the serial nubmer of a selected camera.
Focal Length
Displays focal length of the lens on the selected camera.
Display
Show Field of View
When this is enabled, the estimated field of view (FOV) of the selected camera will be shown in the perspective viewport.
![](https://docs.optitrack.com/~gitbook/image?url=https%3A%2F%2F2498944597-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F5yEhrhQepNQfhsDzAh6n%252Fuploads%252Fgit-blob-e0c3839d74e9a60063e0d0ca1ade3edf6501b672%252Fimage.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=519025d7&sv=1)
Show Frame Delivery Info
Show of hide frame delivery information from the selected camera. The frame delivery information is used for diagnosing how fast each camera is delivering its frame packets. When enabled, the frame delivery information will be shown in the camera views.
Show Aim Assist Reticle
Show or hide the guide reticle when using the Aim Assist button for aiming the cameras.
Prime Color Camera
Prime color cameras also have the following properties that can be configured:
![](https://docs.optitrack.com/~gitbook/image?url=https%3A%2F%2F2498944597-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F5yEhrhQepNQfhsDzAh6n%252Fuploads%252Fgit-blob-ac23e28f841cb7bbd80957d16a3a5b04e070d1d9%252Fimage.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=aaae9449&sv=1)
Resolution
Default: 1920, 1080
This property sets the resolution of the images that are captured by selected cameras. Since the amount of data increases with higher resolution, depending on which resolution is selected, the maximum allowable frame rate will vary. Below is the maximum allowed frame rates for each respective resolution setting.
Resolution | Max Frame Rate |
---|---|
960 x 540 (540p) | 500 FPS |
1280 x 720 (720p) | 360 FPS |
1920 x 1080 (1080p) | 250 FPS |
Compression Mode
Default: Constant Bit Rate.
This property determines how much the captured images will be compressed. The Constant Bit-Rate mode is used by default and recommended because it is easier to control the data transfer rate and efficiently utilize the available network bandwidth.
Constant Bit-Rate
In the Constant Bit-Rate mode, Prime Color cameras vary the degree of image compression to match the data transmission rate given under the Bit Rate settings. At a higher bit-rate setting, the captured image will be compressed less. At a lower bit-rate setting, the captured image will be compressed more to meet the given data transfer rate, but compression artifacts may be introduced if it is set too low.
Variable Bit-Rate
Variable Bit-Rate setting is also available for keeping the amount of the compression constant and allowing the data transfer rate to vary. This mode can be beneficial when capturing images with objects that have detailed textures because it keeps the amount of compression same on all frames. However, this may introduce dropped frames whenever the camera tries to compress highly detailed images because it will increase the data transfer rate; which may overflow the network bandwidth as a result. For this reason, we recommend using the Constant Bit-Rate setting in most applications.
Bit Rate
Default: 50
Available only while using Constant Bit-rate Mode
Bit-rate setting determines the transmission rate outputted from the selected color camera. The value given under this setting is measured in percentage (100%) of the maximum data transmission speed, and each color camera can output up to ~100 MBps. In other words, the configured value will indirectly represent the transmission rate in Megabytes per second (MBps). At bit-rate setting of 100, the camera will capture the best quality image, however, it could overload the network if there is not enough bandwidth to handle the transmitted data.
Since the bit-rate controls the amount of data outputted from each color camera, this is one of the most important settings when properly configuring the system. If your system is experiencing 2D frame drops, it means one of the system requirements is not met; either network bandwidth, CPU processing, or RAM/disk memory. In such cases, you could decrease the bit-rate setting and reduce the amount of data output from the color cameras.
Image Quality
The image quality will increase at a higher bit-rate setting because it records a larger amount of data, but this will result in large file sizes and possible frame drops due to data bandwidth bottleneck. Often, the desired result is different depending on the capture application and what it is used for. The below graph illustrates how the image quality varies depending on the camera framerate and bit-rate settings.
![](https://docs.optitrack.com/~gitbook/image?url=https%3A%2F%2F2498944597-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F5yEhrhQepNQfhsDzAh6n%252Fuploads%252Fgit-blob-d3294424fce2e4968d0d839ad9b369a73c5dc7dd%252Fimage.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=15b3ff87&sv=1)
![](https://docs.optitrack.com/~gitbook/image?url=https%3A%2F%2F2498944597-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F5yEhrhQepNQfhsDzAh6n%252Fuploads%252Fgit-blob-ddaeef4993e5caad00f13341f8a7fdfd754f68f9%252Fimage.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=5326a734&sv=1)
Gamma
Default : 24
Gamma correction is a non-linear amplification of the output image. The gamma setting will adjust the brightness of dark pixels, mid-tone pixels, and bright pixels differently, affecting both brightness and contrast of the image. Depending on the capture environment, especially with a dark background, you may need to adjust the gamma setting to get best quality images.
![](https://docs.optitrack.com/~gitbook/image?url=https%3A%2F%2F2498944597-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F5yEhrhQepNQfhsDzAh6n%252Fuploads%252Fgit-blob-fe01f2b4f1cd85d5a7f9b7828c661d71101dd854%252Fimage.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=64acbb23&sv=1)
![](https://docs.optitrack.com/~gitbook/image?url=https%3A%2F%2F2498944597-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F5yEhrhQepNQfhsDzAh6n%252Fuploads%252Fgit-blob-e136992c5160098dfa652d0476ea1ea6c5c0ff68%252Fimage.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=8b81eab2&sv=1)
Last updated