CameraEdgeFollower Class Reference

Simple edge-following algorithm for grayscale camera images. More...

#include <CameraEdgeFollower.h>

Inheritance diagram for CameraEdgeFollower:

Collaboration diagram for CameraEdgeFollower:

Classes
struct	Result

Public Member Functions
	CameraEdgeFollower (uint8_t threshold=20)
Result	process (const uint8_t *image, size_t width, size_t height)
Public Member Functions inherited from MessageSource
void	subscribe (MessageHandler &handler, MessageOrigin origin=MessageOrigin::Undefined, MessageContent content=MessageContent::Undefined)
	Subscribe a message handler to this source, with optional filtering.
void	unsubscribeAll ()
	Remove all registered message handlers.
void	sendMessage (Message< float > &msg)
	Publish a message to all registered handlers.
void	sendMessage (const Message< Coordinate< float > > &msg)
	Publish a message to all registered handlers.
void	sendMessage (const Message< GPSCoordinate > &msg)
	Publish a message to all registered handlers.
void	sendMessage (const Message< MotionState3D > &msg)
	Overload for MotionState3D messages.

Protected Attributes
uint8_t	_threshold
Protected Attributes inherited from MessageSource
std::vector< MessageHandlerEntry >	messageHandlers_

Detailed Description

Simple edge-following algorithm for grayscale camera images.

This class scans a horizontal row of a grayscale image (e.g., from a line or edge sensor) to detect the strongest edge (sharpest intensity change) using a threshold. It is useful for basic line-following or edge-detection robots.

Features:

• Scans a row near the bottom of the image for the most prominent edge
• Returns the x position of the detected edge and error from image center
• Configurable edge threshold for noise rejection
• Lightweight, suitable for embedded/Arduino use

Note

Expected format:

• The input image should be a grayscale buffer (uint8_t*)
• The pixel intensity is expected to be in the range 0 (black) to 255 (white).
• The layout of the image buffer should be row-major (i.e., pixel at (x,y) is at index y*width + x).
• on ESP32 e.g. PIXFORMAT_GRAYSCALE, FRAMESIZE_QVGA (320 x 240)

Usage Example:

CameraEdgeFollower follower(30); // threshold = 30
auto result = follower.process(image, width, height);
if (result.found) {
  // Use result.position or result.error for steering
}

---

The documentation for this class was generated from the following file:

• src/TinyRobotics/sensors/CameraEdgeFollower.h