Make Vision pose estimation examples use all vision measurements (#1706)

Resolves https://github.com/PhotonVision/photonvision/issues/1634

---------

Signed-off-by: Jade Turner <spacey-sooty@proton.me>
Co-authored-by: Sam Freund <techguy763@gmail.com>

photonlib-java-examples/poseest/src/main/java/frc/robot/Robot.java

@@ -46,7 +46,7 @@ public class Robot extends TimedRobot {
     @Override
     public void robotInit() {
         drivetrain = new SwerveDrive();
-        vision = new Vision();
+        vision = new Vision(drivetrain::addVisionMeasurement);
 
         controller = new XboxController(0);
 
@@ -61,16 +61,8 @@ public class Robot extends TimedRobot {
         // Update drivetrain subsystem
         drivetrain.periodic();
 
-        // Correct pose estimate with vision measurements
-        var visionEst = vision.getEstimatedGlobalPose();
-        visionEst.ifPresent(
-                est -> {
-                    // Change our trust in the measurement based on the tags we can see
-                    var estStdDevs = vision.getEstimationStdDevs();
-
-                    drivetrain.addVisionMeasurement(
-                            est.estimatedPose.toPose2d(), est.timestampSeconds, estStdDevs);
-                });
+        // Update vision
+        vision.periodic();
 
         // Test/Example only!
         // Apply an offset to pose estimator to test vision correction

photonlib-java-examples/poseest/src/main/java/frc/robot/Vision.java

@@ -48,12 +48,18 @@ public class Vision {
     private final PhotonCamera camera;
     private final PhotonPoseEstimator photonEstimator;
     private Matrix<N3, N1> curStdDevs;
+    private final EstimateConsumer estConsumer;
 
     // Simulation
     private PhotonCameraSim cameraSim;
     private VisionSystemSim visionSim;
 
-    public Vision() {
+    /**
+     * @param estConsumer Lamba that will accept a pose estimate and pass it to your desired {@link
+     *     edu.wpi.first.math.estimator.SwerveDrivePoseEstimator}
+     */
+    public Vision(EstimateConsumer estConsumer) {
+        this.estConsumer = estConsumer;
         camera = new PhotonCamera(kCameraName);
 
         photonEstimator =
@@ -83,17 +89,7 @@ public class Vision {
         }
     }
 
-    /**
-     * The latest estimated robot pose on the field from vision data. This may be empty. This should
-     * only be called once per loop.
-     *
-     * <p>Also includes updates for the standard deviations, which can (optionally) be retrieved with
-     * {@link getEstimationStdDevs}
-     *
-     * @return An {@link EstimatedRobotPose} with an estimated pose, estimate timestamp, and targets
-     *     used for estimation.
-     */
-    public Optional<EstimatedRobotPose> getEstimatedGlobalPose() {
+    public void periodic() {
         Optional<EstimatedRobotPose> visionEst = Optional.empty();
         for (var change : camera.getAllUnreadResults()) {
             visionEst = photonEstimator.update(change);
@@ -109,8 +105,15 @@ public class Vision {
                             getSimDebugField().getObject("VisionEstimation").setPoses();
                         });
             }
+
+            visionEst.ifPresent(
+                    est -> {
+                        // Change our trust in the measurement based on the tags we can see
+                        var estStdDevs = getEstimationStdDevs();
+
+                        estConsumer.accept(est.estimatedPose.toPose2d(), est.timestampSeconds, estStdDevs);
+                    });
         }
-        return visionEst;
     }
 
     /**
@@ -188,4 +191,9 @@ public class Vision {
         if (!Robot.isSimulation()) return null;
         return visionSim.getDebugField();
     }
+
+    @FunctionalInterface
+    public static interface EstimateConsumer {
+        public void accept(Pose2d pose, double timestamp, Matrix<N3, N1> estimationStdDevs);
+    }
 }