BunyipsLib/org.murraybridgebunyips.bunyipslib.vision/Processor

Processor

abstract class Processor<T : VisionData?> : VisionProcessor, CameraStreamSource

Base class for all vision processors using the Vision system.

A processor will be attached to a Vision instance and will be called to process frames, allowing you to access your data here using the .getData() method. This makes it useful for tasks to access the latest data from the vision system, without needing to directly interface with the Vision instance.

Author

Lucas Bubner, 2023

Since

1.0.0-pre

Parameters

<T>

the type of VisionData to be processed

Inheritors

ColourThreshold

MultiColourThreshold

Constructors

constructor()

Properties

cameraDimensions

protected open val cameraDimensions: Size

protected val data: List<T>

List of all vision data detected since the last stateful update

open var isFlipped: Boolean

open val isRunning: Boolean

Functions

open fun clearData()

Manually clear the data list.

open fun delegate(@NonNull delegateTo: Processor)

Delegate this processor to another processor.

open fun getData(): ArrayList<T>

Get the list of vision data.

open fun getFrameBitmap(continuation: Continuation<out Consumer<Bitmap>>)

open fun init(width: Int, height: Int, calibration: CameraCalibration)

open fun isAttached(): Boolean

Determine whether the processor is attached to a Vision instance.

protected open fun onAttach()

Override this method to run any additional code that will be executed when this processor is attached (via init()) by a Vision instance.

fun onDrawFrame(canvas: Canvas, onscreenWidth: Int, onscreenHeight: Int, scaleBmpPxToCanvasPx: Float, scaleCanvasDensity: Float, userContext: Any)

Use onFrameDraw instead, which passes a canvas.

protected abstract fun onFrameDraw(canvas: Canvas)

Called by the vision system to draw on the frame.

protected abstract fun onProcessFrame(frame: Mat, captureTimeNanos: Long)

Called by the vision system to process a frame

protected open fun onRunning()

Override this method to run any additional code that will be executed when this processor starts streaming (via start()) on a Vision instance.

fun processFrame(f: Mat, captureTimeNanos: Long): Any

abstract fun toString(): String

Unique identifier for the processor.

protected abstract fun update()

Called to update new data from the vision system, which involves interpreting, collecting, or otherwise processing new vision data per frame.