MandatoryStreamCombination.MandatoryStreamInformation

equals

public boolean equals (Object obj)

Check if this MandatoryStreamInformation is equal to another MandatoryStreamInformation.

Two vectors are only equal if and only if each of the respective elements is equal.

get10BitFormat

public int get10BitFormat ()

Retrieve the mandatory stream 10-bit format for 10-bit capable streams.

In case is10BitCapable() returns true, then this method will return the corresponding 10-bit output Surface pixel format. Depending on the stream type it will be either ImageFormat.PRIVATE or ImageFormat.YCBCR_P010.

getAvailableSizes

public List<Size> getAvailableSizes ()

Return the list of available sizes for this mandatory stream.

Per documented guideline the largest resolution in the result will be tested and guaranteed to work. If clients want to use smaller sizes, then the resulting session configuration can be tested either by calling CameraDevice.createCaptureSession or CameraDevice.CameraDeviceSetup.isSessionConfigurationSupported.

getFormat

public int getFormat ()

Retrieve the mandatory stream format.

getStreamUseCase

public long getStreamUseCase ()

Retrieve the mandatory stream use case.

If this MandatoryStreamInformation is part of a mandatory stream combination for stream use cases, the return value will be a non-DEFAULT value. For MandatoryStreamInformation belonging to other mandatory stream combinations, the return value will be DEFAULT.

hashCode

public int hashCode ()

Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by HashMap.

The general contract of hashCode is:

• Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
• If two objects are equal according to the equals method, then calling the hashCode method on each of the two objects must produce the same integer result.
• It is not required that if two objects are unequal according to the equals method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

is10BitCapable

public boolean is10BitCapable ()

Indicates whether this stream is able to support 10-bit output.

10-bit capable streams can be configured to output 10-bit sample data via calls to OutputConfiguration.setDynamicRangeProfile(long) and selecting the appropriate output Surface pixel format which can be queried via get10BitFormat() and will be either ImageFormat.PRIVATE (the default for Surfaces initialized by SurfaceView, TextureView, MediaRecorder, MediaCodec etc.) or ImageFormat.YCBCR_P010.

isInput

public boolean isInput ()

Confirms whether or not this is an input stream.

isMaximumSize

public boolean isMaximumSize ()

Confirms whether or not this is a maximum size stream.

A stream with maximum size is one with the camera device's maximum resolution for the stream's format as appears in CameraCharacteristics.SCALER_STREAM_CONFIGURATION_MAP. This maximum size has the same meaning as the 'MAXIMUM' target size documented in the camera capture session guideline.

The application can use a MultiResolutionImageReader for a maximum size output stream if the camera device supports multi-resolution outputs for the stream's format. See CameraCharacteristics.SCALER_MULTI_RESOLUTION_STREAM_CONFIGURATION_MAP for details.

This is different from the ultra high resolution flag, which applies only to ultra high resolution sensor camera devices and refers to a stream in CameraCharacteristics.SCALER_STREAM_CONFIGURATION_MAP_MAXIMUM_RESOLUTION instead.

isUltraHighResolution

public boolean isUltraHighResolution ()

Confirms whether or not this is an ultra high resolution stream.

An 'ultra high resolution' stream is one which has a configuration which appears in CameraCharacteristics.SCALER_STREAM_CONFIGURATION_MAP_MAXIMUM_RESOLUTION, Streams which are ultra high resolution must not be included with streams which are not ultra high resolution in the same CaptureRequest.