ViewfinderSurfaceRequest

Artifact: androidx.camera.viewfinder:viewfinder-view

View Source

Added in 1.4.0-alpha10

Deprecated in 1.4.0-alpha10

---

Kotlin |Java

public class ViewfinderSurfaceRequest

---

This class is deprecated.

Use androidx.camera.viewfinder.surface.ViewfinderSurfaceRequest instead.

The request to get a Surface to display camera feed.

This request contains requirements for the surface resolution and camera device information from CameraCharacteristics.

Calling requestSurfaceAsync with this request will send the request to the surface provider, which is either a TextureView or SurfaceView and get a ListenableFuture of Surface.

Calling markSurfaceSafeToRelease will notify the surface provider that the surface is not needed and related resources can be released.

Summary

Nested types
public final class ViewfinderSurfaceRequest.Builder This class is deprecated. Use androidx.camera.viewfinder.surface.ViewfinderSurfaceRequest.Builder instead.

Public methods
@Nullable CameraViewfinder.ImplementationMode	getImplementationMode() Returns the androidx.camera.viewfinder.CameraViewfinder.ImplementationMode.
int	getLensFacing() Returns the camera lens facing.
@NonNull Size	getResolution() Returns the resolution of the requested Surface.
int	getSensorOrientation() Returns the sensor orientation.
void	markSurfaceSafeToRelease() Closes the viewfinder surface to mark it as safe to release.

Protected methods
void	finalize()

Public methods

getImplementationMode

Added in 1.4.0-alpha10

Deprecated in 1.4.0-alpha10

public @Nullable CameraViewfinder.ImplementationMode getImplementationMode()

Returns the androidx.camera.viewfinder.CameraViewfinder.ImplementationMode.

The value is set by setImplementationMode.

Returns
@Nullable CameraViewfinder.ImplementationMode	androidx.camera.viewfinder.CameraViewfinder.ImplementationMode. The value will be null if it's not set via setImplementationMode.

getLensFacing

Added in 1.4.0-alpha10

Deprecated in 1.4.0-alpha10

public int getLensFacing()

Returns the camera lens facing.

The value is set by setLensFacing, which can be retrieved from CameraCharacteristics by key LENS_FACING.

Returns
int	The lens facing.

getResolution

Added in 1.4.0-alpha10

Deprecated in 1.4.0-alpha10

public @NonNull Size getResolution()

Returns the resolution of the requested Surface.

The value is set by Builder. The surface which fulfills this request must have the resolution specified here in order to fulfill the resource requirements of the camera.

Returns
@NonNull Size	The guaranteed supported resolution.

See also
setDefaultBufferSize

getSensorOrientation

Added in 1.4.0-alpha10

Deprecated in 1.4.0-alpha10

public int getSensorOrientation()

Returns the sensor orientation.

The value is set by setSensorOrientation, which can be retrieved from CameraCharacteristics by key SENSOR_ORIENTATION.

Returns
int	The sensor orientation.

markSurfaceSafeToRelease

Added in 1.4.0-alpha10

Deprecated in 1.4.0-alpha10

public void markSurfaceSafeToRelease()

Closes the viewfinder surface to mark it as safe to release.

This method should be called by the user when the requested surface is not needed and related resources can be released.

Protected methods

finalize

protected void finalize()

Throws
java.lang.Throwable