ViewfinderSurfaceRequest.Builder

Builder(builder: ViewfinderSurfaceRequest.Builder)

Constructor for Builder.

Creates a builder with other builder instance. The returned builder will be pre-populated with the state of the provided builder.

Builder(resolution: Size)

Constructor for Builder.

Creates a builder with viewfinder resolution.

Builder(surfaceRequest: ViewfinderSurfaceRequest)

Constructor for Builder.

Creates a builder with other ViewfinderSurfaceRequest instance. The returned builder will be pre-populated with the state of the provided ViewfinderSurfaceRequest instance.

fun build(): ViewfinderSurfaceRequest

Builds the ViewfinderSurfaceRequest.

fun setImplementationMode(
    implementationMode: CameraViewfinder.ImplementationMode?
): ViewfinderSurfaceRequest.Builder

Sets the androidx.camera.viewfinder.CameraViewfinder.ImplementationMode.

Possible values:

• PERFORMANCE
• COMPATIBLE

If not set or setting to null, the androidx.camera.viewfinder.CameraViewfinder.ImplementationMode set via app :implementationMode in layout xml will be used for CameraViewfinder. If not set in the layout xml, the default value PERFORMANCE will be used in CameraViewfinder.

fun setLensFacing(lensFacing: Int): ViewfinderSurfaceRequest.Builder

Sets the lens facing.

Possible values:

• FRONT
• BACK
• EXTERNAL

The value can be retrieved from CameraCharacteristics by key LENS_FACING. If not set, LENS_FACING_BACK will be used by default.

fun setSensorOrientation(sensorOrientation: Int): ViewfinderSurfaceRequest.Builder

Sets the sensor orientation.

Range of valid values: 0, 90, 180, 270

The value can be retrieved from CameraCharacteristics by key SENSOR_ORIENTATION. If it is not set, 0 will be used by default.

fun ViewfinderSurfaceRequest.Builder.populateFromCharacteristics(
    cameraCharacteristics: CameraCharacteristics
): ViewfinderSurfaceRequest.Builder

Populates ViewfinderSurfaceRequest.Builder from CameraCharacteristics.

The CameraCharacteristics will be used to populate information including lens facing, sensor orientation and ImplementationMode. If the hardware level is legacy, the ImplementationMode will be set to ImplementationMode.COMPATIBLE.