[photon-lib] Add PhotonPoseEstimator.resetHeadingData()

[bryceroethel]

Description

When using PNP_DISTANCE_TRIG_SOLVE, heading data provided prior to a pose or rotation reset (examples including resetting odometry at the start of autonomous, or zeroing the robot's gyro) may be utilized when calculating future pose estimates, which can cause unpredictable behavior in some scenarios. This PR adds PhotonPoseEstimator.resetHeadingData(), giving users the option to manually clear the heading buffer to avoid the aforementioned issue.

Here's a log from one of my team's practice matches, where we observed irregular vision measurements at the start of autonomous, after the robot's pose was reset. Afterwards, we copied PhotonPoseEstimator into our robot code and implemented the method added by this PR, which resolved the problem. Green ghosts are the poses given by Photon, the solid model is our estimated pose.

2025-04-25.17-07-09.mp4

Meta

Merge checklist:

• Pull Request title is short, imperative summary of proposed changes
• The description documents the what and why
• If this PR changes behavior or adds a feature, user documentation is updated
• If this PR touches photon-serde, all messages have been regenerated and hashes have not changed unexpectedly
• If this PR touches configuration, this is backwards compatible with settings back to v2024.3.1
• If this PR touches pipeline settings or anything related to data exchange, the frontend typing is updated
• If this PR addresses a bug, a regression test for it is added

[samfreund]

LGTM, but as I'm not that familiar with the pose estimator, I'll leave it to someone else to approve.