Class LimelightHelpers

java.lang.Object
frc.spectrumLib.vision.LimelightHelpers
public class LimelightHelpers extends Object
LimelightHelpers provides static methods and classes for interfacing with Limelight vision cameras in FRC. This library supports all Limelight features including AprilTag tracking, Neural Networks, and standard color/retroreflective tracking.

  • Constructor Details

    • LimelightHelpers

      public LimelightHelpers()

  • Method Details

    • toPose3D

      public static Pose3d toPose3D(double[] inData)
      Takes a 6-length array of pose data and converts it to a Pose3d object. Array format: [x, y, z, roll, pitch, yaw] where angles are in degrees.
      Parameters:
      inData - Array containing pose data [x, y, z, roll, pitch, yaw]
      Returns:
      Pose3d object representing the pose, or empty Pose3d if invalid data

    • toPose2D

      public static Pose2d toPose2D(double[] inData)
      Takes a 6-length array of pose data and converts it to a Pose2d object. Uses only x, y, and yaw components, ignoring z, roll, and pitch. Array format: [x, y, z, roll, pitch, yaw] where angles are in degrees.
      Parameters:
      inData - Array containing pose data [x, y, z, roll, pitch, yaw]
      Returns:
      Pose2d object representing the pose, or empty Pose2d if invalid data

    • pose3dToArray

      public static double[] pose3dToArray(Pose3d pose)
      Converts a Pose3d object to an array of doubles in the format [x, y, z, roll, pitch, yaw]. Translation components are in meters, rotation components are in degrees.
      Parameters:
      pose - The Pose3d object to convert
      Returns:
      A 6-element array containing [x, y, z, roll, pitch, yaw]

    • pose2dToArray

      public static double[] pose2dToArray(Pose2d pose)
      Converts a Pose2d object to an array of doubles in the format [x, y, z, roll, pitch, yaw]. Translation components are in meters, rotation components are in degrees. Note: z, roll, and pitch will be 0 since Pose2d only contains x, y, and yaw.
      Parameters:
      pose - The Pose2d object to convert
      Returns:
      A 6-element array containing [x, y, 0, 0, 0, yaw]

    • parsePoseEstimate

      public static LimelightHelpers.PoseEstimate parsePoseEstimate(double[] poseArray, long timestampMicros, boolean isMegaTag2)
      Parses a raw botpose array (as published on botpose_wpiblue or botpose_orb_wpiblue) into a LimelightHelpers.PoseEstimate. Pure function; performs no NetworkTables access, so callers that already hold a sample can derive an estimate without a second read.
      Parameters:
      poseArray - raw pose array; null or empty yields a default LimelightHelpers.PoseEstimate
      timestampMicros - NetworkTables server timestamp of the sample, in microseconds
      isMegaTag2 - whether the array came from a MegaTag2 topic
      Returns:
      the parsed estimate (never null)

    • getRawFiducials

      public static LimelightHelpers.RawFiducial[] getRawFiducials(String limelightName)
      Gets the latest raw fiducial/AprilTag detection results from NetworkTables.
      Parameters:
      limelightName - Name/identifier of the Limelight
      Returns:
      Array of RawFiducial objects containing detection details

    • getRawDetections

      public static LimelightHelpers.RawDetection[] getRawDetections(String limelightName)
      Gets the latest raw neural detector results from NetworkTables
      Parameters:
      limelightName - Name/identifier of the Limelight
      Returns:
      Array of RawDetection objects containing detection details

    • getRawTargets

      public static LimelightHelpers.RawTarget[] getRawTargets(String limelightName)
      Gets the raw target contours from NetworkTables. Returns ungrouped contours in normalized screen space (-1 to 1).
      Parameters:
      limelightName - Name/identifier of the Limelight
      Returns:
      Array of RawTarget objects containing up to 3 contours

    • getCornerCoordinates

      public static double[] getCornerCoordinates(String limelightName)
      Gets the corner coordinates of detected targets from NetworkTables. Requires "send contours" to be enabled in the Limelight Output tab.
      Parameters:
      limelightName - Name/identifier of the Limelight
      Returns:
      Array of doubles containing corner coordinates [x0, y0, x1, y1, ...]

    • printPoseEstimate

      public static void printPoseEstimate(LimelightHelpers.PoseEstimate pose)
      Prints detailed information about a PoseEstimate to standard output. Includes timestamp, latency, tag count, tag span, average tag distance, average tag area, and detailed information about each detected fiducial.
      Parameters:
      pose - The PoseEstimate object to print. If null, prints "No PoseEstimate available."

    • validPoseEstimate

      public static Boolean validPoseEstimate(LimelightHelpers.PoseEstimate pose)
      Returns true if the pose estimate is valid.
      Parameters:
      pose - the pose estimate to check
      Returns:
      true if the pose is non-null and contains at least one raw fiducial

    • getLimelightNTTable

      public static NetworkTable getLimelightNTTable(String tableName)
      Returns the limelight nt table.
      Parameters:
      tableName - the limelight name
      Returns:
      the limelight nt table

    • Flush

      public static void Flush()
      Flush.

    • getLimelightNTTableEntry

      public static NetworkTableEntry getLimelightNTTableEntry(String tableName, String entryName)
      Returns the limelight nt table entry.
      Parameters:
      tableName - the limelight name
      entryName - the network table entry name
      Returns:
      the limelight nt table entry

    • getLimelightDoubleArrayEntry

      public static DoubleArrayEntry getLimelightDoubleArrayEntry(String tableName, String entryName)
      Returns the limelight double array entry.
      Parameters:
      tableName - the limelight name
      entryName - the network table entry name
      Returns:
      the limelight double array entry

    • getLimelightNTDouble

      public static double getLimelightNTDouble(String tableName, String entryName)
      Returns the limelight nt double.
      Parameters:
      tableName - the limelight name
      entryName - the network table entry name
      Returns:
      the limelight nt double value

    • setLimelightNTDouble

      public static void setLimelightNTDouble(String tableName, String entryName, double val)
      Sets the limelight nt double.
      Parameters:
      tableName - the limelight name
      entryName - the network table entry name
      val - the value to set

    • setLimelightNTDoubleArray

      public static void setLimelightNTDoubleArray(String tableName, String entryName, double[] val)
      Sets the limelight nt double array.
      Parameters:
      tableName - the limelight name
      entryName - the network table entry name
      val - the array to set

    • getLimelightNTDoubleArray

      public static double[] getLimelightNTDoubleArray(String tableName, String entryName)
      Returns the limelight nt double array.
      Parameters:
      tableName - the limelight name
      entryName - the network table entry name
      Returns:
      the limelight nt double array value

    • getLimelightNTString

      public static String getLimelightNTString(String tableName, String entryName)
      Returns the limelight nt string.
      Parameters:
      tableName - the limelight name
      entryName - the network table entry name
      Returns:
      the limelight nt string value

    • getLimelightNTStringArray

      public static String[] getLimelightNTStringArray(String tableName, String entryName)
      Returns the limelight nt string array.
      Parameters:
      tableName - the limelight name
      entryName - the network table entry name
      Returns:
      the limelight nt string array value

    • getTV

      public static boolean getTV(String limelightName)
      Does the Limelight have a valid target?
      Parameters:
      limelightName - Name of the Limelight camera ("" for default)
      Returns:
      True if a valid target is present, false otherwise

    • getTX

      public static double getTX(String limelightName)
      Gets the horizontal offset from the crosshair to the target in degrees.
      Parameters:
      limelightName - Name of the Limelight camera ("" for default)
      Returns:
      Horizontal offset angle in degrees

    • getTY

      public static double getTY(String limelightName)
      Gets the vertical offset from the crosshair to the target in degrees.
      Parameters:
      limelightName - Name of the Limelight camera ("" for default)
      Returns:
      Vertical offset angle in degrees

    • getTXNC

      public static double getTXNC(String limelightName)
      Gets the horizontal offset from the principal pixel/point to the target in degrees. This is the most accurate 2d metric if you are using a calibrated camera and you don't need adjustable crosshair functionality.
      Parameters:
      limelightName - Name of the Limelight camera ("" for default)
      Returns:
      Horizontal offset angle in degrees

    • getTYNC

      public static double getTYNC(String limelightName)
      Gets the vertical offset from the principal pixel/point to the target in degrees. This is the most accurate 2d metric if you are using a calibrated camera and you don't need adjustable crosshair functionality.
      Parameters:
      limelightName - Name of the Limelight camera ("" for default)
      Returns:
      Vertical offset angle in degrees

    • getTA

      public static double getTA(String limelightName)
      Gets the target area as a percentage of the image (0-100%).
      Parameters:
      limelightName - Name of the Limelight camera ("" for default)
      Returns:
      Target area percentage (0-100)

    • getT2DArray

      public static double[] getT2DArray(String limelightName)
      T2D is an array that contains several targeting metrics
      Parameters:
      limelightName - Name of the Limelight camera
      Returns:
      Array containing [targetValid, targetCount, targetLatency, captureLatency, tx, ty, txnc, tync, ta, tid, targetClassIndexDetector, targetClassIndexClassifier, targetLongSidePixels, targetShortSidePixels, targetHorizontalExtentPixels, targetVerticalExtentPixels, targetSkewDegrees]

    • getTargetCount

      public static int getTargetCount(String limelightName)
      Gets the number of targets currently detected.
      Parameters:
      limelightName - Name of the Limelight camera
      Returns:
      Number of detected targets

    • getClassifierClassIndex

      public static int getClassifierClassIndex(String limelightName)
      Gets the classifier class index from the currently running neural classifier pipeline
      Parameters:
      limelightName - Name of the Limelight camera
      Returns:
      Class index from classifier pipeline

    • getDetectorClassIndex

      public static int getDetectorClassIndex(String limelightName)
      Gets the detector class index from the primary result of the currently running neural detector pipeline.
      Parameters:
      limelightName - Name of the Limelight camera
      Returns:
      Class index from detector pipeline

    • getClassifierClass

      public static String getClassifierClass(String limelightName)
      Gets the current neural classifier result class name.
      Parameters:
      limelightName - Name of the Limelight camera
      Returns:
      Class name string from classifier pipeline

    • getDetectorClass

      public static String getDetectorClass(String limelightName)
      Gets the primary neural detector result class name.
      Parameters:
      limelightName - Name of the Limelight camera
      Returns:
      Class name string from detector pipeline

    • getLatency_Pipeline

      public static double getLatency_Pipeline(String limelightName)
      Gets the pipeline's processing latency contribution.
      Parameters:
      limelightName - Name of the Limelight camera
      Returns:
      Pipeline latency in milliseconds

    • getLatency_Capture

      public static double getLatency_Capture(String limelightName)
      Gets the capture latency.
      Parameters:
      limelightName - Name of the Limelight camera
      Returns:
      Capture latency in milliseconds

    • getCurrentPipelineIndex

      public static double getCurrentPipelineIndex(String limelightName)
      Gets the active pipeline index.
      Parameters:
      limelightName - Name of the Limelight camera
      Returns:
      Current pipeline index (0-9)

    • getCurrentPipelineType

      public static String getCurrentPipelineType(String limelightName)
      Gets the current pipeline type.
      Parameters:
      limelightName - Name of the Limelight camera
      Returns:
      Pipeline type string (e.g. "retro", "apriltag", etc)

    • getJSONDump

      public static String getJSONDump(String limelightName)
      Gets the full JSON results dump.
      Parameters:
      limelightName - Name of the Limelight camera
      Returns:
      JSON string containing all current results

    • getBotpose

      @Deprecated public static double[] getBotpose(String limelightName)
      Deprecated.
      Switch to getBotPose
      Parameters:
      limelightName - the Limelight table name
      Returns:

    • getBotpose_wpiRed

      @Deprecated public static double[] getBotpose_wpiRed(String limelightName)
      Deprecated.
      Switch to getBotPose_wpiRed
      Parameters:
      limelightName - the Limelight table name
      Returns:

    • getBotpose_wpiBlue

      @Deprecated public static double[] getBotpose_wpiBlue(String limelightName)
      Deprecated.
      Switch to getBotPose_wpiBlue
      Parameters:
      limelightName - the Limelight table name
      Returns:

    • getBotPose

      public static double[] getBotPose(String limelightName)
      Returns the bot pose.
      Parameters:
      limelightName - the Limelight table name
      Returns:
      the bot pose

    • getBotPose_wpiRed

      public static double[] getBotPose_wpiRed(String limelightName)
      Returns the bot pose wpi red.
      Parameters:
      limelightName - the Limelight table name
      Returns:
      the bot pose wpi red

    • getBotPose_wpiBlue

      public static double[] getBotPose_wpiBlue(String limelightName)
      Returns the bot pose wpi blue.
      Parameters:
      limelightName - the Limelight table name
      Returns:
      the bot pose wpi blue

    • getBotPose_TargetSpace

      public static double[] getBotPose_TargetSpace(String limelightName)
      Returns the bot pose target space.
      Parameters:
      limelightName - the Limelight table name
      Returns:
      the bot pose target space

    • getCameraPose_TargetSpace

      public static double[] getCameraPose_TargetSpace(String limelightName)
      Returns the camera pose target space.
      Returns:
      the camera pose target space

    • getTargetPose_CameraSpace

      public static double[] getTargetPose_CameraSpace(String limelightName)
      Returns the target pose camera space.
      Parameters:
      limelightName - the Limelight table name
      Returns:
      the target pose camera space

    • getTargetPose_RobotSpace

      public static double[] getTargetPose_RobotSpace(String limelightName)
      Returns the target pose robot space.
      Parameters:
      limelightName - the Limelight table name
      Returns:
      the target pose robot space

    • getTargetColor

      public static double[] getTargetColor(String limelightName)
      Gets the average color under the crosshair region as a 3-element array.
      Parameters:
      limelightName - Name of the Limelight camera
      Returns:
      Array containing [Blue, Green, Red] color values (BGR order)

    • getFiducialID

      public static double getFiducialID(String limelightName)
      Returns the fiducial id.
      Parameters:
      limelightName - the Limelight table name
      Returns:
      the fiducial id

    • getHeartbeat

      public static double getHeartbeat(String limelightName)
      Gets the Limelight heartbeat value. Increments once per frame, allowing you to detect if the Limelight is connected and alive.
      Parameters:
      limelightName - Name of the Limelight camera
      Returns:
      Heartbeat value that increments each frame

    • getNeuralClassID

      public static String getNeuralClassID(String limelightName)
      Returns the neural class id.
      Returns:
      the neural class id

    • getRawBarcodeData

      public static String[] getRawBarcodeData(String limelightName)
      Returns the raw barcode data.
      Returns:
      the raw barcode data

    • getBotPose3d

      public static Pose3d getBotPose3d(String limelightName)
      Returns the bot pose 3d.
      Parameters:
      limelightName - the Limelight table name
      Returns:
      the bot pose 3d

    • getBotPose3d_wpiRed

      public static Pose3d getBotPose3d_wpiRed(String limelightName)
      (Not Recommended) Gets the robot's 3D pose in the WPILib Red Alliance Coordinate System.
      Parameters:
      limelightName - Name/identifier of the Limelight
      Returns:
      Pose3d object representing the robot's position and orientation in Red Alliance field space

    • getBotPose3d_wpiBlue

      public static Pose3d getBotPose3d_wpiBlue(String limelightName)
      (Recommended) Gets the robot's 3D pose in the WPILib Blue Alliance Coordinate System.
      Parameters:
      limelightName - Name/identifier of the Limelight
      Returns:
      Pose3d object representing the robot's position and orientation in Blue Alliance field space

    • getBotPose3d_TargetSpace

      public static Pose3d getBotPose3d_TargetSpace(String limelightName)
      Gets the robot's 3D pose with respect to the currently tracked target's coordinate system.
      Parameters:
      limelightName - Name/identifier of the Limelight
      Returns:
      Pose3d object representing the robot's position and orientation relative to the target

    • getCameraPose3d_TargetSpace

      public static Pose3d getCameraPose3d_TargetSpace(String limelightName)
      Gets the camera's 3D pose with respect to the currently tracked target's coordinate system.
      Parameters:
      limelightName - Name/identifier of the Limelight
      Returns:
      Pose3d object representing the camera's position and orientation relative to the target

    • getTargetPose3d_CameraSpace

      public static Pose3d getTargetPose3d_CameraSpace(String limelightName)
      Gets the target's 3D pose with respect to the camera's coordinate system.
      Parameters:
      limelightName - Name/identifier of the Limelight
      Returns:
      Pose3d object representing the target's position and orientation relative to the camera

    • getTargetPose3d_RobotSpace

      public static Pose3d getTargetPose3d_RobotSpace(String limelightName)
      Gets the target's 3D pose with respect to the robot's coordinate system.
      Parameters:
      limelightName - Name/identifier of the Limelight
      Returns:
      Pose3d object representing the target's position and orientation relative to the robot

    • getCameraPose3d_RobotSpace

      public static Pose3d getCameraPose3d_RobotSpace(String limelightName)
      Gets the camera's 3D pose with respect to the robot's coordinate system.
      Parameters:
      limelightName - Name/identifier of the Limelight
      Returns:
      Pose3d object representing the camera's position and orientation relative to the robot

    • getBotPose2d_wpiBlue

      public static Pose2d getBotPose2d_wpiBlue(String limelightName)
      Gets the Pose2d for easy use with Odometry vision pose estimator (addVisionMeasurement)
      Parameters:
      limelightName - the Limelight table name
      Returns:

    • getBotPoseEstimate_wpiBlue

      public static LimelightHelpers.PoseEstimate getBotPoseEstimate_wpiBlue(String limelightName)
      Gets the MegaTag1 Pose2d and timestamp for use with WPILib pose estimator (addVisionMeasurement) in the WPILib Blue alliance coordinate system.
      Parameters:
      limelightName - the Limelight table name
      Returns:

    • getBotPoseEstimate_wpiBlue_MegaTag2

      public static LimelightHelpers.PoseEstimate getBotPoseEstimate_wpiBlue_MegaTag2(String limelightName)
      Gets the MegaTag2 Pose2d and timestamp for use with WPILib pose estimator (addVisionMeasurement) in the WPILib Blue alliance coordinate system. Make sure you are calling setRobotOrientation() before calling this method.
      Parameters:
      limelightName - the Limelight table name
      Returns:

    • getBotPose2d_wpiRed

      public static Pose2d getBotPose2d_wpiRed(String limelightName)
      Gets the Pose2d for easy use with Odometry vision pose estimator (addVisionMeasurement)
      Parameters:
      limelightName - the Limelight table name
      Returns:

    • getBotPoseEstimate_wpiRed

      public static LimelightHelpers.PoseEstimate getBotPoseEstimate_wpiRed(String limelightName)
      Gets the Pose2d and timestamp for use with WPILib pose estimator (addVisionMeasurement) when you are on the RED alliance
      Parameters:
      limelightName - the Limelight table name
      Returns:

    • getBotPoseEstimate_wpiRed_MegaTag2

      public static LimelightHelpers.PoseEstimate getBotPoseEstimate_wpiRed_MegaTag2(String limelightName)
      Gets the Pose2d and timestamp for use with WPILib pose estimator (addVisionMeasurement) when you are on the RED alliance
      Parameters:
      limelightName - the Limelight table name
      Returns:

    • getBotPose2d

      public static Pose2d getBotPose2d(String limelightName)
      Gets the Pose2d for easy use with Odometry vision pose estimator (addVisionMeasurement)
      Parameters:
      limelightName - the Limelight table name
      Returns:

    • getIMUData

      public static LimelightHelpers.IMUData getIMUData(String limelightName)
      Gets the current IMU data from NetworkTables. IMU data is formatted as [robotYaw, Roll, Pitch, Yaw, gyroX, gyroY, gyroZ, accelX, accelY, accelZ]. Returns all zeros if data is invalid or unavailable.
      Parameters:
      limelightName - Name/identifier of the Limelight
      Returns:
      IMUData object containing all current IMU data

    • setPipelineIndex

      public static void setPipelineIndex(String limelightName, int pipelineIndex)
      Sets the pipeline index.
      Parameters:
      limelightName - the Limelight table name
      pipelineIndex - the pipeline index to set

    • setPriorityTagID

      public static void setPriorityTagID(String limelightName, int ID)
      Sets the priority tag id.
      Parameters:
      limelightName - the Limelight table name
      ID - the priority tag ID

    • setLEDMode_PipelineControl

      public static void setLEDMode_PipelineControl(String limelightName)
      Sets LED mode to be controlled by the current pipeline.
      Parameters:
      limelightName - Name of the Limelight camera

    • setLEDMode_ForceOff

      public static void setLEDMode_ForceOff(String limelightName)
      Sets the led mode force off.
      Parameters:
      limelightName - the Limelight table name

    • setLEDMode_ForceBlink

      public static void setLEDMode_ForceBlink(String limelightName)
      Sets the led mode force blink.
      Parameters:
      limelightName - the Limelight table name

    • setLEDMode_ForceOn

      public static void setLEDMode_ForceOn(String limelightName)
      Sets the led mode force on.
      Parameters:
      limelightName - the Limelight table name

    • setStreamMode_Standard

      public static void setStreamMode_Standard(String limelightName)
      Enables standard side-by-side stream mode.
      Parameters:
      limelightName - Name of the Limelight camera

    • setStreamMode_PiPMain

      public static void setStreamMode_PiPMain(String limelightName)
      Enables Picture-in-Picture mode with secondary stream in the corner.
      Parameters:
      limelightName - Name of the Limelight camera

    • setStreamMode_PiPSecondary

      public static void setStreamMode_PiPSecondary(String limelightName)
      Enables Picture-in-Picture mode with primary stream in the corner.
      Parameters:
      limelightName - Name of the Limelight camera

    • setCropWindow

      public static void setCropWindow(String limelightName, double cropXMin, double cropXMax, double cropYMin, double cropYMax)
      Sets the crop window for the camera. The crop window in the UI must be completely open.
      Parameters:
      limelightName - Name of the Limelight camera
      cropXMin - Minimum X value (-1 to 1)
      cropXMax - Maximum X value (-1 to 1)
      cropYMin - Minimum Y value (-1 to 1)
      cropYMax - Maximum Y value (-1 to 1)

    • setKeystone

      public static void setKeystone(String limelightName, double horizontal, double vertical)
      Sets the keystone modification for the crop window.
      Parameters:
      limelightName - Name of the Limelight camera
      horizontal - Horizontal keystone value (-0.95 to 0.95)
      vertical - Vertical keystone value (-0.95 to 0.95)

    • setFiducial3DOffset

      public static void setFiducial3DOffset(String limelightName, double offsetX, double offsetY, double offsetZ)
      Sets 3D offset point for easy 3D targeting.

    • SetRobotOrientation

      public static void SetRobotOrientation(String limelightName, double yaw, double yawRate, double pitch, double pitchRate, double roll, double rollRate)
      Sets robot orientation values used by MegaTag2 localization algorithm.
      Parameters:
      limelightName - Name/identifier of the Limelight
      yaw - Robot yaw in degrees. 0 = robot facing red alliance wall in FRC
      yawRate - (Unnecessary) Angular velocity of robot yaw in degrees per second
      pitch - (Unnecessary) Robot pitch in degrees
      pitchRate - (Unnecessary) Angular velocity of robot pitch in degrees per second
      roll - (Unnecessary) Robot roll in degrees
      rollRate - (Unnecessary) Angular velocity of robot roll in degrees per second

    • SetRobotOrientation_NoFlush

      public static void SetRobotOrientation_NoFlush(String limelightName, double yaw, double yawRate, double pitch, double pitchRate, double roll, double rollRate)
      Sets robot orientation values without flushing.
      Parameters:
      limelightName - the Limelight table name

    • SetIMUMode

      public static void SetIMUMode(String limelightName, int mode)
      Configures the IMU mode for MegaTag2 Localization
      Parameters:
      limelightName - Name/identifier of the Limelight
      mode - IMU mode.

    • SetIMUAssistAlpha

      public static void SetIMUAssistAlpha(String limelightName, double alpha)
      Configures the complementary filter alpha value for IMU Assist Modes (Modes 3 and 4)
      Parameters:
      limelightName - Name/identifier of the Limelight
      alpha - Defaults to .001. Higher values will cause the internal IMU to converge onto the assist source more rapidly.

    • SetThrottle

      public static void SetThrottle(String limelightName, int throttle)
      Configures the throttle value. Set to 100-200 while disabled to reduce thermal output/temperature.
      Parameters:
      limelightName - Name/identifier of the Limelight
      throttle - Defaults to 0. Your Limelgiht will process one frame after skipping frames.

    • SetFiducialIDFiltersOverride

      public static void SetFiducialIDFiltersOverride(String limelightName, int[] validIDs)
      Overrides the valid AprilTag IDs that will be used for localization. Tags not in this list will be ignored for robot pose estimation.
      Parameters:
      limelightName - Name/identifier of the Limelight
      validIDs - Array of valid AprilTag IDs to track

    • SetFiducialDownscalingOverride

      public static void SetFiducialDownscalingOverride(String limelightName, float downscale)
      Sets the downscaling factor for AprilTag detection. Increasing downscale can improve performance at the cost of potentially reduced detection range.
      Parameters:
      limelightName - Name/identifier of the Limelight
      downscale - Downscale factor. Valid values: 1.0 (no downscale), 1.5, 2.0, 3.0, 4.0. Set to 0 for pipeline control.

    • setCameraPose_RobotSpace

      public static void setCameraPose_RobotSpace(String limelightName, double forward, double side, double up, double roll, double pitch, double yaw)
      Sets the camera pose relative to the robot.
      Parameters:
      limelightName - Name of the Limelight camera
      forward - Forward offset in meters
      side - Side offset in meters
      up - Up offset in meters
      roll - Roll angle in degrees
      pitch - Pitch angle in degrees
      yaw - Yaw angle in degrees

    • setPythonScriptData

      public static void setPythonScriptData(String limelightName, double[] outgoingPythonData)
      Sets the python script data.
      Parameters:
      limelightName - the limelight name
      outgoingPythonData - the data to pass to the python script

    • getPythonScriptData

      public static double[] getPythonScriptData(String limelightName)
      Returns the python script data.
      Parameters:
      limelightName - the Limelight table name
      Returns:
      the python script data

    • triggerSnapshot

      public static void triggerSnapshot(String limelightName)
      Triggers a snapshot capture via NetworkTables by incrementing the snapshot counter. Rate-limited to once per 10 frames on the Limelight.
      Parameters:
      limelightName - Name of the Limelight camera

    • setRewindEnabled

      public static void setRewindEnabled(String limelightName, boolean enabled)
      Enables or pauses the rewind buffer recording.
      Parameters:
      limelightName - Name of the Limelight camera
      enabled - True to enable recording, false to pause

    • triggerRewindCapture

      public static void triggerRewindCapture(String limelightName, double durationSeconds)
      Triggers a rewind capture with the specified duration. Maximum duration is 165 seconds. Rate-limited on the Limelight.
      Parameters:
      limelightName - Name of the Limelight camera
      durationSeconds - Duration of rewind capture in seconds (max 165)

    • getLatestResults

      public static LimelightHelpers.LimelightResults getLatestResults(String limelightName)
      Gets the latest JSON results output and returns a LimelightResults object.
      Parameters:
      limelightName - Name of the Limelight camera
      Returns:
      LimelightResults object containing all current target data

    • setupPortForwardingUSB

      public static void setupPortForwardingUSB(int usbIndex)
      Sets up port forwarding for a Limelight 3A/3G connected via USB. This allows access to the Limelight web interface and video stream when connected to the robot over USB.

      For usbIndex 0: ports 5800-5809 forward to 172.29.0.1 For usbIndex 1: ports 5810-5819 forward to 172.29.1.1 etc.

      Call this method once during robot initialization. To access the interface of the camera with usbIndex0, you would go to roboRIO-(teamnum)-FRC.local:5801. Port 5811 for usb index 1

      Parameters:
      usbIndex - The USB index of the Limelight (0, 1, 2, etc.)