Crosshair Calibration
The crosshair is the reference point tx/ty (LimelightTargetData.getHorizontalOffset() / getVerticalOffset()) are measured against. If you're driving directly off tx/ty (visual servoing, not a full 3D pose), calibrating it correctly is what makes "tx == 0" actually mean "aligned with where I want to score," instead of just "aligned with the sensor's optical center."
Single crosshair mode
Use this when your scoring position and camera angle don't vary.
Drive the robot to its ideal scoring location and rotation.
Click Calibrate in the Limelight web UI.
Verify:
tx/tyshould now read0/0when the robot is back in that exact position and rotation.Recalibrate whenever you change field setup or camera mounting. For example, if a practice match reveals a better scoring position, recalibrate during the next lull.
Dual crosshair mode
Use this for off-axis cameras or shooters that need real-time compensation as range changes. The effective crosshair interpolates between crosshair A and B based on target area.
Drive to the closest scoring position with ideal rotation, click Calibrate for crosshair A.
Drive to the farthest scoring position with ideal rotation, click Calibrate for crosshair B.
As the robot moves between those distances, the Limelight uses the target's area to interpolate between A and B automatically, with no additional code required.
See Also
Last updated
Was this helpful?