Camera and depth preview¶
The view elements on this page additionally accept the attributes common to all view elements.
View-Element: camera-gui¶added in 1.19
This is a preview and control for a camera input, showing a preview of the camera and allowing for selecting an acquisition area and several camera settings. Note that this only makes sense if you also use a camera input in the configuration.
exposure_adjustment_level and show_controls determine which controls are available to the user and when they are shown. In the default experiments of phyphox you typically see exposure_adjustment_level="3" and show_controls="full_view_only".
grayscale, markOverexposure and markUnderexposure are modifiers that influence the look of the image to make it easier to use for some measurements.
<camera-gui exposure_adjustment_level="INTEGER" grayscale="BOOLEAN"
markOverexposure="COLOR" markUnderexposure="COLOR"
show_controls="STRING"></camera-gui>
Attributes
- exposure_adjustment_level
- This determines which controls are available to the user in three different levels of how much control over the exposure is possible: Level 1 only allows for changing the camera and zoom, but no control over exposure settings. Level 2 is a simplified exposure control, allowing the same as level 1 and adding a toggle to turn auto exposure on or off as well as a simple exposure value control, adjusting for a slight over or underexposure from the auto exposure result. Level 3 finally offers all controls, replacing the exposure value control from level 2 with shutter speed (exposure time), ISO and aperture and also showing the white balance control.
- optional, integer, default:
1 - grayscale
- Show a grayscale image instead of colors
- optional, boolean, default:
false - markOverexposure
- Overexposed parts of the image are replaced by the given color
- optional, color
- markUnderexposure
- Underexposed parts of the image are replaced by the given color.
- optional, color
- show_controls
-
Determines when the camera controls are shown.
- always
- Controls are available even when only a small preview is shown.
- full_view_only
- Controls are only shown after the preview has been tapped and maximized.
- never
- Controls are never shown; the element is only a preview, with the option to select the measurement area.
-
optional, one of
always,full_view_only,never, default:full_view_only
View-Element: depth-gui¶added in 1.14
This is a preview and control for a depth input, showing a preview of the camera and allowing for selecting an acquisition area and an aggregation method, and for switching cameras. At the moment, you can only set the label. Note that this only makes sense if you also use a depth input in the configuration.
Attributes
- aspectRatio
- Width divided by height.
- optional, float, default:
2.5