CameraCharacteristics.ScalerAvailableStreamUseCases Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
The stream use cases supported by this camera device.
[Android.Runtime.Register("SCALER_AVAILABLE_STREAM_USE_CASES", ApiSince=33)]
public static Android.Hardware.Camera2.CameraCharacteristics.Key ScalerAvailableStreamUseCases { get; }[<Android.Runtime.Register("SCALER_AVAILABLE_STREAM_USE_CASES", ApiSince=33)>]
static member ScalerAvailableStreamUseCases : Android.Hardware.Camera2.CameraCharacteristics.KeyProperty Value
The stream use cases supported by this camera device.
- Attributes
Remarks
The stream use cases supported by this camera device.
The stream use case indicates the purpose of a particular camera stream from the end-user perspective. Some examples of camera use cases are: preview stream for live viewfinder shown to the user, still capture for generating high quality photo capture, video record for encoding the camera output for the purpose of future playback, and video call for live realtime video conferencing.
With this flag, the camera device can optimize the image processing pipeline parameters, such as tuning, sensor mode, and ISP settings, independent of the properties of the immediate camera output surface. For example, if the output surface is a SurfaceTexture, the stream use case flag can be used to indicate whether the camera frames eventually go to display, video encoder, still image capture, or all of them combined.
The application sets the use case of a camera stream by calling OutputConfiguration.setStreamUseCase(long).
A camera device with CameraMetadata.REQUEST_AVAILABLE_CAPABILITIES_STREAM_USE_CASE capability must support the following stream use cases: DEFAULT; PREVIEW; STILL_CAPTURE; VIDEO_RECORD; PREVIEW_VIDEO_STILL; VIDEO_CALL
The guaranteed stream combinations related to stream use case for a camera device with CameraMetadata.REQUEST_AVAILABLE_CAPABILITIES_STREAM_USE_CASE capability is documented in the camera device guideline. The application is strongly recommended to use one of the guaranteed stream combinations. If the application creates a session with a stream combination not in the guaranteed list, or with mixed DEFAULT and non-DEFAULT use cases within the same session, the camera device may ignore some stream use cases due to hardware constraints and implementation details.
For stream combinations not covered by the stream use case mandatory lists, such as reprocessable session, constrained high speed session, or RAW stream combinations, the application should leave stream use cases within the session as DEFAULT.
Possible values: DEFAULT; PREVIEW; STILL_CAPTURE; VIDEO_RECORD; PREVIEW_VIDEO_STILL; VIDEO_CALL; CROPPED_RAW
Optional - The value for this key may be null on some devices.
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.