SessionConfiguration

SESSION_HIGH_SPEED

public static final int SESSION_HIGH_SPEED

A high speed session type that can only contain instances of OutputConfiguration. The outputs can run using high speed FPS ranges. Calls to setInputConfiguration(InputConfiguration) are not supported.

When using this type, the CameraCaptureSession returned by CameraCaptureSession.StateCallback can be cast to a CameraConstrainedHighSpeedCaptureSession to access the extra methods for constrained high speed recording.

Constant Value: 1 (0x00000001)

SESSION_REGULAR

public static final int SESSION_REGULAR

A regular session type containing instances of OutputConfiguration running at regular non high speed FPS ranges and optionally InputConfiguration for reprocessable sessions.

Constant Value: 0 (0x00000000)

CREATOR

public static final Creator<SessionConfiguration> CREATOR

SessionConfiguration

public SessionConfiguration (int sessionType, 
                List<OutputConfiguration> outputs, 
                Executor executor, 
                CameraCaptureSession.StateCallback cb)

Create a new SessionConfiguration.

SessionConfiguration

public SessionConfiguration (int sessionType, 
                List<OutputConfiguration> outputs)

Create a new SessionConfiguration with sessionType and output configurations.

The SessionConfiguration objects created by this constructor can be used by CameraDeviceSetup#isSessionConfigurationSupported and CameraDevice.CameraDeviceSetup.getSessionCharacteristics(SessionConfiguration) to query a camera device's feature combination support and session specific characteristics. For the SessionConfiguration object to be used to create a capture session, setStateCallback(Executor, StateCallback) must be called to specify the state callback function, and any incomplete OutputConfigurations must be completed via OutputConfiguration#addSurface or OutputConfiguration#setSurfacesForMultiResolutionOutput as appropriate.

clearColorSpace

public void clearColorSpace ()

Clear the color space, such that the default color space will be used.

describeContents

public int describeContents ()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. For example, if the object will include a file descriptor in the output of writeToParcel(android.os.Parcel, int), the return value of this method must include the CONTENTS_FILE_DESCRIPTOR bit.

equals

public boolean equals (Object obj)

Check if this SessionConfiguration is equal to another SessionConfiguration.

Two output session configurations are only equal if and only if the underlying input configuration, output configurations, and session type are equal.

getColorSpace

public ColorSpace getColorSpace ()

Return the current color space.

getExecutor

public Executor getExecutor ()

Retrieve the Executor for the capture session.

getInputConfiguration

public InputConfiguration getInputConfiguration ()

Retrieve the InputConfiguration.

getOutputConfigurations

public List<OutputConfiguration> getOutputConfigurations ()

Retrieve the OutputConfiguration list for the capture session.

getSessionParameters

public CaptureRequest getSessionParameters ()

Retrieve the session wide camera parameters (see CaptureRequest).

getSessionType

public int getSessionType ()

Retrieve the type of the capture session.

getStateCallback

public CameraCaptureSession.StateCallback getStateCallback ()

Retrieve the CameraCaptureSession.StateCallback for the capture session.

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.

setColorSpace

public void setColorSpace (ColorSpace.Named colorSpace)

Set a specific device-supported color space.

Clients can choose from any profile advertised as supported in CameraCharacteristics#REQUEST_AVAILABLE_COLOR_SPACE_PROFILES queried using ColorSpaceProfiles#getSupportedColorSpaces. When set, the colorSpace will override the default color spaces of the output targets, or the color space implied by the dataSpace passed into an ImageReader's constructor.

setInputConfiguration

public void setInputConfiguration (InputConfiguration input)

Sets the InputConfiguration for a reprocessable session. Input configuration are not supported for SESSION_HIGH_SPEED.

setSessionParameters

public void setSessionParameters (CaptureRequest params)

Sets the session wide camera parameters (see CaptureRequest). This argument can be set for every supported session type and will be passed to the camera device as part of the capture session initialization. Session parameters are a subset of the available capture request parameters (see CameraCharacteristics#getAvailableSessionKeys) and their application can introduce internal camera delays. To improve camera performance it is suggested to change them sparingly within the lifetime of the capture session and to pass their initial values as part of this method.

setStateCallback

public void setStateCallback (Executor executor, 
                CameraCaptureSession.StateCallback cb)

Set the state callback and executor.

This function must be called for the SessionConfiguration object created via SessionConfiguration(int, List<OutputConfiguration>) before it's used to create a capture session.

writeToParcel

public void writeToParcel (Parcel dest, 
                int flags)

Flatten this object in to a Parcel.