org.firstinspires.ftc.robotcore.external.hardware.camera

Interface CameraManager

public interface CameraManager

THIS INTERFACE IS EXPERIMENTAL. Its form and function may change in whole or in part before being finalized for production use. Caveat emptor. CameraManager is the main entrypoint for accessing USB Video Class (UVC) webcams. Modelled after android.hardware.camera2.CameraManager

Method Summary

Modifier and Type	Method and Description
void	asyncOpenCameraAssumingPermission(CameraName cameraName, Continuation<? extends Camera.StateCallback> continuation, long reopenDuration, java.util.concurrent.TimeUnit reopenTimeUnit) Asynchronously opens a connection to a camera with the given name.
java.util.List<WebcamName>	getAllWebcams() Return the list of currently connected camera devices which are USB webcams.
SwitchableCameraName	nameForSwitchableCamera(CameraName... cameraNames) Returns a name of a virtual camera comprised of a sequence of other camera.
CameraName	nameForUnknownCamera() Returns a CameraName which is guaranteed never to represent that of an actual camera.
CameraName	nameFromCameraDirection(VuforiaLocalizer.CameraDirection cameraDirection) Returns a camera name indicating a particular VuforiaLocalizer.CameraDirection.
Camera	requestPermissionAndOpenCamera(Deadline deadline, CameraName cameraName, Continuation<? extends Camera.StateCallback> continuation) Synchronously requests permission to opens the camera of the indicated name, then opens that camera.

Method Detail

getAllWebcams

java.util.List<WebcamName> getAllWebcams()

Return the list of currently connected camera devices which are USB webcams. Note: this list may contain duplicates if more than once instance of a serialnumberless webcam is attached.

Returns:

The list of currently connected USB webcams.

nameFromCameraDirection

CameraName nameFromCameraDirection(VuforiaLocalizer.CameraDirection cameraDirection)

Returns a camera name indicating a particular VuforiaLocalizer.CameraDirection. Using this method, both camera directions and webcam names can be indicated with a uniform name representation.

Returns:

a camera name indicating a particular VuforiaLocalizer.CameraDirection

nameForUnknownCamera

CameraName nameForUnknownCamera()

Returns a CameraName which is guaranteed never to represent that of an actual camera. This can be useful in situations where a value distinguished from null and actual camera names is desired.

Returns:

a CameraName which is guaranteed never to represent that of an actual camera

nameForSwitchableCamera

SwitchableCameraName nameForSwitchableCamera(CameraName... cameraNames)

Returns a name of a virtual camera comprised of a sequence of other camera. Only one of the member cameras is opened at a time, but which one is in use can be switched on the fly.

See Also:

SwitchableCamera

requestPermissionAndOpenCamera

Camera requestPermissionAndOpenCamera(Deadline deadline,
                                      CameraName cameraName,
                                      Continuation<? extends Camera.StateCallback> continuation)

Synchronously requests permission to opens the camera of the indicated name, then opens that camera. The calling thread blocks until the open attempt is complete. If successful, the newly opened Camera is returned. It is the caller's responsibility to ultimately call Camera.close() when they are done using the camera. If unsuccessful, then null is returned. If a Camera.StateCallback continuation is provided, that callback is notified of life-cycle events of the camera. In particular, it is guaranteed that one of Camera.StateCallback.onOpened(Camera) or Camera.StateCallback.onOpenFailed(org.firstinspires.ftc.robotcore.external.hardware.camera.CameraName, org.firstinspires.ftc.robotcore.external.hardware.camera.Camera.OpenFailure) will be called.

See Also:

asyncOpenCameraAssumingPermission(org.firstinspires.ftc.robotcore.external.hardware.camera.CameraName, org.firstinspires.ftc.robotcore.external.function.Continuation<? extends org.firstinspires.ftc.robotcore.external.hardware.camera.Camera.StateCallback>, long, java.util.concurrent.TimeUnit), CameraName.asyncRequestCameraPermission(Context, Deadline, org.firstinspires.ftc.robotcore.external.function.Continuation<? extends org.firstinspires.ftc.robotcore.external.function.Consumer<java.lang.Boolean>>), CameraName.requestCameraPermission(Deadline)

asyncOpenCameraAssumingPermission

void asyncOpenCameraAssumingPermission(CameraName cameraName,
                                       Continuation<? extends Camera.StateCallback> continuation,
                                       long reopenDuration,
                                       java.util.concurrent.TimeUnit reopenTimeUnit)

Asynchronously opens a connection to a camera with the given name. Assumes that permissions have already been obtained to do so.

If the camera is successfully opened, Camera.StateCallback.onOpened(org.firstinspires.ftc.robotcore.external.hardware.camera.Camera) will be invoked with the newly opened Camera. The camera device can then be set up for operation by calling Camera.createCaptureSession(org.firstinspires.ftc.robotcore.external.function.Continuation<? extends org.firstinspires.ftc.robotcore.external.hardware.camera.CameraCaptureSession.StateCallback>)

If the camera fails to open, then Camera.StateCallback.onOpenFailed(org.firstinspires.ftc.robotcore.external.hardware.camera.CameraName, org.firstinspires.ftc.robotcore.external.hardware.camera.Camera.OpenFailure) is called.

Parameters:

cameraName - The name of the camera device to open

continuation - The code to be invoked to handle callback notifications

See Also:

requestPermissionAndOpenCamera(Deadline, org.firstinspires.ftc.robotcore.external.hardware.camera.CameraName, org.firstinspires.ftc.robotcore.external.function.Continuation<? extends org.firstinspires.ftc.robotcore.external.hardware.camera.Camera.StateCallback>), CameraName.asyncRequestCameraPermission(Context, Deadline, org.firstinspires.ftc.robotcore.external.function.Continuation<? extends org.firstinspires.ftc.robotcore.external.function.Consumer<java.lang.Boolean>>), CameraName.requestCameraPermission(Deadline)