Version 12.0 (20260907-090034)
Breaking Changes
- The new AprilTag Cluster capability breaks legacy AprilTag OpModes resulting in compile errors for software that uses AprilTagDetection objects in both Android Studio and OnBot Java.
-
Legacy AprilTag OpModes must be updated to check whether the returned AprilTag is a cluster or singleton, and cast the returned detection into the correct type to access its elements. See below:
Old method for AprilTag processing
for (AprilTagDetection detection : currentDetections) { // Do single Tag processing here }New method for AprilTag Singleton/Cluster processing
for (AprilTagDetection detection : currentDetections) { if (detection instanceof AprilTagSingleDetection) { AprilTagSingleDetection singleDet = (AprilTagSingleDetection) detection; // Do single Tag processing here } else { AprilTagClusterDetection clusterDet = (AprilTagClusterDetection) detection; // Do cluster Tag processing here } }For more information about how to update your OpModes to fix the breaking change see: https://ftc-docs.firstinspires.org/apriltag-clusters
-
About AprilTag clusters:
- Clusters are co-planar groups of two or more AprilTags wherein the position of each member tag is defined relative to a common origin
- This origin may be placed outside the bounds of the tags themselves to provide a more suitable "aiming" target
- Clusters are resilient to partial occlusion. Full 6DOF pose can be estimated from a cluster even if only a single member tag is visible. Of course, the more tags that are visible, the better and more stable the pose estimate will be
- All AprilTag samples have been updated to differentiate between standalone tags and clusters
-
Enhancements
- Adds a tree view for robot configurations issue 1821
- Gamepad indicators on the Driver Station are now colored orange if the respective gamepads are connected to the Android generic gamepad driver instead of the Driver Station's usermode USB driver
- Updated AprilTag Library for BIOBUZZ. Notably, getCurrentGameTagLibrary() now returns BIOBUZZ tags.
- In BIOBUZZ, the Origin of each cluster is located in the center of the Cell opening for easy aiming.
- The Origin X,Y & Z Axes are now displayed by default on the preview image.
- Unfortunately, since BIOBUZZ AprilTags move, they are not suitable for absolute Field Localization.
- Supports OctoQuad MK2 firmware v3.1.0, which adds diagnostics parameters for the IMU and MCU uptime
Bug Fixes
- Fixes issue 2078 where battery voltage was not updated on driver station if OpMode did not send any telemetry.
