Camera Settings
Defined under the namespace Scandit.Datacapture.Core
- CameraPosition
Added in version 6.13.0
- WorldFacing
Added in version 6.13.0
The camera is attached at the back of the device and is facing away from the user.
- UserFacing
Added in version 6.13.0
The camera is attached on the front of the device and facing towards the user.
- VideoResolution
Added in version 6.13.0
- HD
Added in version 6.13.0
Resolution is 1280x720.
- FullHD
Added in version 6.13.0
Resolution is 1920x1080.
- UHD4K
Added in version 6.13.0
Resolution is 3840x2160. Please note: Usage of this resolution is not part of every license. If you encounter issues, please contact us at support@scandit.com.
- FocusGestureStrategy
Added in version 6.13.0
Enumeration of possible focus gesture strategies to use.
- None
Added in version 6.13.0
No effect when performing a focus gesture.
- Manual
Added in version 6.13.0
Focus on PoI and only change with next focus gesture.
- ManualUntilCapture
Added in version 6.13.0
Focus on PoI and reset to previous focus strategy on capture.
- AutoOnLocation
Added in version 6.13.0
Continuously focus on the location of the gesture and only change with next focus gesture.
- CameraSettings
class CameraSettings
Added in version 6.13.0
Holds camera-specific settings such as preferred resolution, maximum frame rate etc. The defaults are chosen such that they work for a wide variety of use cases. You may apply custom settings to further optimize scan performance for your particular use case. There is typically no need to customize the camera settings beyond changing the preferred resolution.
For best performance use the camera settings returned by the capture mode you are using, e.g. BarcodeCapture.recommendedCameraSettings().
- constructor()
constructor()
Added in version 6.13.0
Creates new default camera settings. zoomFactor is set to 1 and preferredResolution is set to VideoResolution.Auto.
- constructor(settings)
constructor(settings: CameraSettings)
Added in version 6.13.0
Creates a copy of the provided settings.
Holds camera related settings such as preview resolution and maximum frame rate to use.
- preferredResolution
preferredResolution: VideoResolution
Added in version 6.13.0
The preferred resolution to use for the camera. The camera will use the resolution that is closests to the resolution preference. For example, if only lower resolutions than the preferred resolution are available, the highest available resolution will be used.
The resolution chosen by the camera only takes the preferredResolution into account, it does not consider the resolution limit of your license key. When the device selects a resolution that is larger than what you have licensed, the data capture context will report a license status error.
The default value is VideoResolution.Auto.
- zoomFactor
zoomFactor: number
Added in version 6.13.0
The zoom factor to use for the camera. This value is a multiplier, a value of 1.0 means no zoom, while a value of 2.0 doubles the size of the image, but halves the field of view.
Values less than 1.0 are treated as 1.0. Values greater than the maximum available zoom factor are clamped to the maximum accepted value.
The default zoom factor is 1.0.
- focusGestureStrategy
focusGestureStrategy: FocusGestureStrategy
Added in version 6.13.0
The focus gesture strategy to use.
- zoomGestureZoomFactor
zoomGestureZoomFactor: number
Added in version 6.13.0
The zoom factor to move to when the zoom in gesture was performed. This value is a multiplier, a value of 1.0 means no zoom, while a value of 2.0 doubles the size of the image, but halves the field of view. See also zoomFactor.
The default zoom factor for the zoom in gesture is 2.0.