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

Interface CameraName

All Known Subinterfaces:

BuiltinCameraName, WebcamName

public interface CameraName

CameraName identifies a HardwareDevice which is a camera.

Method Summary

Modifier and Type	Method and Description
void	asyncRequestCameraPermission(Context context, Deadline deadline, Continuation<? extends Consumer<java.lang.Boolean>> continuation) Requests from the user permission to use the camera if same has not already been granted.
CameraCharacteristics	getCameraCharacteristics() Query the capabilities of a camera device.
boolean	isCameraDirection() Returns whether or not this name is that of a builtin phone camera.
boolean	isSwitchable() Returns whether this name is one representing the ability to switch amongst a series of member cameras.
boolean	isUnknown() Returns whether or not this name represents that of an unknown or indeterminate camera.
boolean	isWebcam() Returns whether or not this name is that of a webcam.
boolean	requestCameraPermission(Deadline deadline) Requests from the user permission to use the camera if same has not already been granted.

Method Detail

isWebcam

boolean isWebcam()

Returns whether or not this name is that of a webcam. If true, then the CameraName can be cast to a WebcamName.

Returns:

whether or not this name is that of a webcam

See Also:

WebcamName

isCameraDirection

boolean isCameraDirection()

Returns whether or not this name is that of a builtin phone camera. If true, then the CameraName can be cast to a BuiltinCameraName.

Returns:

whether or not this name is that of a builtin phone camera

See Also:

BuiltinCameraName

isSwitchable

boolean isSwitchable()

Returns whether this name is one representing the ability to switch amongst a series of member cameras. If true, then the receiver can be cast to a SwitchableCameraName.

Returns:

whether this is a SwitchableCameraName

isUnknown

boolean isUnknown()

Returns whether or not this name represents that of an unknown or indeterminate camera.

Returns:

whether or not this name represents that of an unknown or indeterminate camera

asyncRequestCameraPermission

void asyncRequestCameraPermission(Context context,
                                  Deadline deadline,
                                  Continuation<? extends Consumer<java.lang.Boolean>> continuation)

Requests from the user permission to use the camera if same has not already been granted. This may take a long time, as interaction with the user may be necessary. When the outcome is known, the reportResult continuation is called with the result. The report may occur either before or after the call to asyncRequestCameraPermission(Context, Deadline, org.firstinspires.ftc.robotcore.external.function.Continuation<? extends org.firstinspires.ftc.robotcore.external.function.Consumer<java.lang.Boolean>>) has itself returned. The report will be delivered using the indicated Continuation

Parameters:

context - the context in which the permission request should run

deadline - the time by which the request must be honored or given up as ungranted. If this Deadline is cancelled while the request is outstanding, then the permission request will be aborted and false reported as the result of the request.

continuation - the dispatcher used to deliver results of the permission request

Throws:

java.lang.IllegalArgumentException - if the cameraName does not match any known camera device.

See Also:

requestCameraPermission(Deadline)

requestCameraPermission

boolean requestCameraPermission(Deadline deadline)

Requests from the user permission to use the camera if same has not already been granted. This may take a long time, as interaction with the user may be necessary. The call is made synchronously: the calling thread blocks until an answer is obtained.

Parameters:

deadline - the time by which the request must be honored or given up as ungranted

Returns:

whether or not permission to use the camera has been granted.

See Also:

asyncRequestCameraPermission(Context, Deadline, org.firstinspires.ftc.robotcore.external.function.Continuation<? extends org.firstinspires.ftc.robotcore.external.function.Consumer<java.lang.Boolean>>)

getCameraCharacteristics

CameraCharacteristics getCameraCharacteristics()

Query the capabilities of a camera device. These capabilities are immutable for a given camera.

Returns:

The properties of the given camera. A degenerate empty set of properties is returned on error.