ColourTunerOpMode

A tuning OpMode for calibrating the vision system's colour thresholding using controller input.

Note that if you want to tune a processor using FtcDashboard, you have to use the static fields offered by ColourTuner, not the processor (as it will be overridden and controlled by the controllers)

Author

Lucas Bubner, 2024

Since

3.4.0

Constructors

Link copied to clipboard
constructor()

Properties

Link copied to clipboard
The scalars used for the current processor.

Inherited properties

Link copied to clipboard
Link copied to clipboard

BunyipsLib Gamepad 1: Driver

Link copied to clipboard

BunyipsLib Gamepad 2: Operator

Link copied to clipboard
open var hardwareMap: HardwareMap
Link copied to clipboard
open val isStarted: Boolean
Link copied to clipboard

Set how fast the OpMode is able to loop in the activeLoop or onInitLoop methods in Loops per Time Unit. This will dynamically adjust to be the target speed of how fast loops should be executed. Measures of less than or equal to zero will be ignored, and the OpMode will run as fast as possible.

Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
open var t: DualTelemetry

Shorthand field alias for the telemetry (DualTelemetry) field. Sometimes, this field is required to be used as the Kotlin compiler might have trouble distinguishing between the overridden field and the base field. This method is a direct alias to the DualTelemetry field.

Link copied to clipboard

BunyipsLib Driver Station & FtcDashboard Telemetry

Link copied to clipboard
open var time: Double
Link copied to clipboard

The moving average timer for the OpMode, which is used to calculate time between hardware cycles. This is useful for debugging, performance monitoring, and calculating various time-based values (deltaTime, loopCount, elapsedTime, etc.)

Functions

Link copied to clipboard
protected fun activeLoop()
Code to run continuously after the START button is pressed on the Driver Station.
Link copied to clipboard
protected fun onInit()
Runs upon the pressing of the INIT button on the Driver Station.
Link copied to clipboard
protected abstract fun setCamera(): CameraName
The camera from HardwareMap to use for vision processing.
Link copied to clipboard
The processors to tune in this OpMode.

Inherited functions

Link copied to clipboard
fun detachActiveLoopRunnables(attachedRunnables: Array<Runnable>)

Removes a Runnable that was added to the active loop via onActiveLoop. Calling this method will no-op on runnables that can't be found on the currently attached runnables, and will stop executing runnables on the active loop that could be found.

Link copied to clipboard

Dangerous method: call to IMMEDIATELY terminate the OpMode. No further code will run, and this should only be used in emergencies.

Link copied to clipboard
fun exit()

Dangerous method: call to shut down the OpMode as soon as possible. This will run any BunyipsOpMode cleanup code, much as if the user pressed the STOP button.

Link copied to clipboard
fun finish(safeHaltHardwareOnStop: Boolean)

Call to manually finish the OpMode.

Link copied to clipboard

BunyipsLib Gamepad 1: Driver

Link copied to clipboard

BunyipsLib Gamepad 2: Operator

Link copied to clipboard

Get the currently respected init-task that will run during dynamic_init.

Link copied to clipboard

The instance of the current BunyipsOpMode. This is set automatically by the BunyipsOpMode lifecycle. This can be used instead of dependency injection to access the current OpMode, as it is a singleton.

Link copied to clipboard
fun getRobotControllers(): List<LynxModule>

A list of all LynxModules (Control + Expansion Hub) modules on the robot.

Link copied to clipboard
open fun getRuntime(): Double
Link copied to clipboard

Shorthand field alias for the telemetry (DualTelemetry) field. Sometimes, this field is required to be used as the Kotlin compiler might have trouble distinguishing between the overridden field and the base field. This method is a direct alias to the DualTelemetry field.

Link copied to clipboard

BunyipsLib Driver Station & FtcDashboard Telemetry

Link copied to clipboard

The moving average timer for the OpMode, which is used to calculate time between hardware cycles. This is useful for debugging, performance monitoring, and calculating various time-based values (deltaTime, loopCount, elapsedTime, etc.)

Link copied to clipboard
fun halt()

Call to temporarily halt all activeLoop-related updates from running. Note this will pause the entire activeLoop, but continue to update timers and telemetry. These events must be handled manually if needed, which include any conditional calls to resume.

Link copied to clipboard
fun idle()
Link copied to clipboard
fun ifRunning(opModeConsumer: Consumer<BunyipsOpMode>)

Run the supplied callback if a BunyipsOpMode is currently running. This chains an internal call to BunyipsOpMode with a lambda supplied with the non-null instance of BunyipsOpMode.

Link copied to clipboard
fun init()
Link copied to clipboard
fun init_loop()
Link copied to clipboard
Link copied to clipboard
open fun internalPostLoop()
Link copied to clipboard
open fun internalPreInit()
Link copied to clipboard
fun internalUpdateTelemetryNow(telemetry: TelemetryMessage)
Link copied to clipboard

Whether a BunyipsOpMode is currently running. This is useful for checking if the OpMode singleton can be accessed without raising an exception due to the field being null.

Link copied to clipboard
Link copied to clipboard
fun loop()
Link copied to clipboard
fun onActiveLoop(runnables: Array<Runnable>)

Add a Runnable to the list of runnables to be executed just before the activeLoop. This is useful for running code that needs to be executed on the main thread, but is not a subsystem or task.

Link copied to clipboard
protected open fun onFinish()

Perform one time clean-up operations after the activeLoop finishes all intentions gracefully.

Link copied to clipboard
protected open fun onInitDone()

Allow code to execute once after all initialisation has finished.

Link copied to clipboard
protected open fun onInitLoop(): Boolean

Run code in a loop AFTER onInit has completed, until start is pressed on the Driver Station and the init-task (setInitTask) is done. The boolean returned by this method will indicate the status of the imit-loop, if it returns true, the init-loop will finish early.

Link copied to clipboard
protected open fun onStart()

Perform one time operations after start is pressed.

Link copied to clipboard
protected open fun onStop()

Perform one time clean-up operations as the OpMode is stopping.

Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
open fun resetRuntime()
Link copied to clipboard
fun resume()

Call to resume the activeLoop after a halt call.

Link copied to clipboard
protected abstract fun runBunyipsOpMode()
Main BunyipsOpMode executor method.
protected fun runBunyipsOpMode()

This method is the entry point for the BunyipsLib framework, and is called by the FTC SDK.

Link copied to clipboard
open fun runOpMode()
Main OpMode thread method.
abstract fun runOpMode()
Link copied to clipboard

Dangerous method: Call to command all motors and servos on the robot to shut down. This is a method called by the SDK continuously when no OpMode is running. It is also automatically called via finish.

Link copied to clipboard
fun setGamepad1(<set-?>: Controller)

BunyipsLib Gamepad 1: Driver

Link copied to clipboard
fun setGamepad2(<set-?>: Controller)

BunyipsLib Gamepad 2: Operator

Link copied to clipboard

Set a task that will run as an init-task. This will run after your onInit has completed, allowing you to initialise hardware first. This is an optional method, and runs alongside onInitLoop.

Link copied to clipboard
fun setT(<set-?>: DualTelemetry)

Shorthand field alias for the telemetry (DualTelemetry) field. Sometimes, this field is required to be used as the Kotlin compiler might have trouble distinguishing between the overridden field and the base field. This method is a direct alias to the DualTelemetry field.

Link copied to clipboard

BunyipsLib Driver Station & FtcDashboard Telemetry

Link copied to clipboard

The moving average timer for the OpMode, which is used to calculate time between hardware cycles. This is useful for debugging, performance monitoring, and calculating various time-based values (deltaTime, loopCount, elapsedTime, etc.)

Link copied to clipboard
fun sleep(milliseconds: Long)
Link copied to clipboard
fun start()
Link copied to clipboard
fun stop()
Link copied to clipboard

Call to command all moving motors/CRServos to stop by method of setting their powers to zero. This does not impact normal servos.

Link copied to clipboard
Link copied to clipboard
open fun updateTelemetry(telemetry: Telemetry)
Link copied to clipboard
open fun waitForStart()