Examples with VuforiaTrackableDefaultListener org.firstinspires.ftc.robotcore.external.navigation.VuforiaTrackableDefaultListener used on opensource projects

Example 6 with VuforiaTrackableDefaultListener

use of org.firstinspires.ftc.robotcore.external.navigation.VuforiaTrackableDefaultListener in project robotcode by OutoftheBoxFTC.

the class ConceptVuforiaNavigation method runOpMode.

@Override
public void runOpMode() {
    /*
         * To start up Vuforia, tell it the view that we wish to use for camera monitor (on the RC phone);
         * If no camera monitor is desired, use the parameterless constructor instead (commented out below).
         */
    int cameraMonitorViewId = hardwareMap.appContext.getResources().getIdentifier("cameraMonitorViewId", "id", hardwareMap.appContext.getPackageName());
    VuforiaLocalizer.Parameters parameters = new VuforiaLocalizer.Parameters(cameraMonitorViewId);
    // OR...  Do Not Activate the Camera Monitor View, to save power
    // VuforiaLocalizer.Parameters parameters = new VuforiaLocalizer.Parameters();
    /*
         * IMPORTANT: You need to obtain your own license key to use Vuforia. The string below with which
         * 'parameters.vuforiaLicenseKey' is initialized is for illustration only, and will not function.
         * A Vuforia 'Development' license key, can be obtained free of charge from the Vuforia developer
         * web site at https://developer.vuforia.com/license-manager.
         *
         * Vuforia license keys are always 380 characters long, and look as if they contain mostly
         * random data. As an example, here is a example of a fragment of a valid key:
         *      ... yIgIzTqZ4mWjk9wd3cZO9T1axEqzuhxoGlfOOI2dRzKS4T0hQ8kT ...
         * Once you've obtained a license key, copy the string from the Vuforia web site
         * and paste it in to your code onthe next line, between the double quotes.
         */
    parameters.vuforiaLicenseKey = "ATsODcD/////AAAAAVw2lR...d45oGpdljdOh5LuFB9nDNfckoxb8COxKSFX";
    /*
         * We also indicate which camera on the RC that we wish to use.
         * Here we chose the back (HiRes) camera (for greater range), but
         * for a competition robot, the front camera might be more convenient.
         */
    parameters.cameraDirection = VuforiaLocalizer.CameraDirection.BACK;
    this.vuforia = ClassFactory.createVuforiaLocalizer(parameters);
    /**
     * Load the data sets that for the trackable objects we wish to track. These particular data
     * sets are stored in the 'assets' part of our application (you'll see them in the Android
     * Studio 'Project' view over there on the left of the screen). You can make your own datasets
     * with the Vuforia Target Manager: https://developer.vuforia.com/target-manager. PDFs for the
     * example "StonesAndChips", datasets can be found in in this project in the
     * documentation directory.
     */
    VuforiaTrackables stonesAndChips = this.vuforia.loadTrackablesFromAsset("StonesAndChips");
    VuforiaTrackable redTarget = stonesAndChips.get(0);
    // Stones
    redTarget.setName("RedTarget");
    VuforiaTrackable blueTarget = stonesAndChips.get(1);
    // Chips
    blueTarget.setName("BlueTarget");
    /**
     * For convenience, gather together all the trackable objects in one easily-iterable collection
     */
    List<VuforiaTrackable> allTrackables = new ArrayList<VuforiaTrackable>();
    allTrackables.addAll(stonesAndChips);
    /**
     * We use units of mm here because that's the recommended units of measurement for the
     * size values specified in the XML for the ImageTarget trackables in data sets. E.g.:
     *      <ImageTarget name="stones" size="247 173"/>
     * You don't *have to* use mm here, but the units here and the units used in the XML
     * target configuration files *must* correspond for the math to work out correctly.
     */
    float mmPerInch = 25.4f;
    // ... or whatever is right for your robot
    float mmBotWidth = 18 * mmPerInch;
    // the FTC field is ~11'10" center-to-center of the glass panels
    float mmFTCFieldWidth = (12 * 12 - 2) * mmPerInch;
    /**
     * In order for localization to work, we need to tell the system where each target we
     * wish to use for navigation resides on the field, and we need to specify where on the robot
     * the phone resides. These specifications are in the form of <em>transformation matrices.</em>
     * Transformation matrices are a central, important concept in the math here involved in localization.
     * See <a href="https://en.wikipedia.org/wiki/Transformation_matrix">Transformation Matrix</a>
     * for detailed information. Commonly, you'll encounter transformation matrices as instances
     * of the {@link OpenGLMatrix} class.
     *
     * For the most part, you don't need to understand the details of the math of how transformation
     * matrices work inside (as fascinating as that is, truly). Just remember these key points:
     * <ol>
     *
     *     <li>You can put two transformations together to produce a third that combines the effect of
     *     both of them. If, for example, you have a rotation transform R and a translation transform T,
     *     then the combined transformation matrix RT which does the rotation first and then the translation
     *     is given by {@code RT = T.multiplied(R)}. That is, the transforms are multiplied in the
     *     <em>reverse</em> of the chronological order in which they applied.</li>
     *
     *     <li>A common way to create useful transforms is to use methods in the {@link OpenGLMatrix}
     *     class and the Orientation class. See, for example, {@link OpenGLMatrix#translation(float,
     *     float, float)}, {@link OpenGLMatrix#rotation(AngleUnit, float, float, float, float)}, and
     *     {@link Orientation#getRotationMatrix(AxesReference, AxesOrder, AngleUnit, float, float, float)}.
     *     Related methods in {@link OpenGLMatrix}, such as {@link OpenGLMatrix#rotated(AngleUnit,
     *     float, float, float, float)}, are syntactic shorthands for creating a new transform and
     *     then immediately multiplying the receiver by it, which can be convenient at times.</li>
     *
     *     <li>If you want to break open the black box of a transformation matrix to understand
     *     what it's doing inside, use {@link MatrixF#getTranslation()} to fetch how much the
     *     transform will move you in x, y, and z, and use {@link Orientation#getOrientation(MatrixF,
     *     AxesReference, AxesOrder, AngleUnit)} to determine the rotational motion that the transform
     *     will impart. See {@link #format(OpenGLMatrix)} below for an example.</li>
     *
     * </ol>
     *
     * This example places the "stones" image on the perimeter wall to the Left
     *  of the Red Driver station wall.  Similar to the Red Beacon Location on the Res-Q
     *
     * This example places the "chips" image on the perimeter wall to the Right
     *  of the Blue Driver station.  Similar to the Blue Beacon Location on the Res-Q
     *
     * See the doc folder of this project for a description of the field Axis conventions.
     *
     * Initially the target is conceptually lying at the origin of the field's coordinate system
     * (the center of the field), facing up.
     *
     * In this configuration, the target's coordinate system aligns with that of the field.
     *
     * In a real situation we'd also account for the vertical (Z) offset of the target,
     * but for simplicity, we ignore that here; for a real robot, you'll want to fix that.
     *
     * To place the Stones Target on the Red Audience wall:
     * - First we rotate it 90 around the field's X axis to flip it upright
     * - Then we rotate it  90 around the field's Z access to face it away from the audience.
     * - Finally, we translate it back along the X axis towards the red audience wall.
     */
    OpenGLMatrix redTargetLocationOnField = OpenGLMatrix.translation(-mmFTCFieldWidth / 2, 0, 0).multiplied(Orientation.getRotationMatrix(/* First, in the fixed (field) coordinate system, we rotate 90deg in X, then 90 in Z */
    AxesReference.EXTRINSIC, AxesOrder.XZX, AngleUnit.DEGREES, 90, 90, 0));
    redTarget.setLocation(redTargetLocationOnField);
    RobotLog.ii(TAG, "Red Target=%s", format(redTargetLocationOnField));
    /*
         * To place the Stones Target on the Blue Audience wall:
         * - First we rotate it 90 around the field's X axis to flip it upright
         * - Finally, we translate it along the Y axis towards the blue audience wall.
         */
    OpenGLMatrix blueTargetLocationOnField = OpenGLMatrix.translation(0, mmFTCFieldWidth / 2, 0).multiplied(Orientation.getRotationMatrix(/* First, in the fixed (field) coordinate system, we rotate 90deg in X */
    AxesReference.EXTRINSIC, AxesOrder.XZX, AngleUnit.DEGREES, 90, 0, 0));
    blueTarget.setLocation(blueTargetLocationOnField);
    RobotLog.ii(TAG, "Blue Target=%s", format(blueTargetLocationOnField));
    /**
     * Create a transformation matrix describing where the phone is on the robot. Here, we
     * put the phone on the right hand side of the robot with the screen facing in (see our
     * choice of BACK camera above) and in landscape mode. Starting from alignment between the
     * robot's and phone's axes, this is a rotation of -90deg along the Y axis.
     *
     * When determining whether a rotation is positive or negative, consider yourself as looking
     * down the (positive) axis of rotation from the positive towards the origin. Positive rotations
     * are then CCW, and negative rotations CW. An example: consider looking down the positive Z
     * axis towards the origin. A positive rotation about Z (ie: a rotation parallel to the the X-Y
     * plane) is then CCW, as one would normally expect from the usual classic 2D geometry.
     */
    OpenGLMatrix phoneLocationOnRobot = OpenGLMatrix.translation(mmBotWidth / 2, 0, 0).multiplied(Orientation.getRotationMatrix(AxesReference.EXTRINSIC, AxesOrder.YZY, AngleUnit.DEGREES, -90, 0, 0));
    RobotLog.ii(TAG, "phone=%s", format(phoneLocationOnRobot));
    /**
     * Let the trackable listeners we care about know where the phone is. We know that each
     * listener is a {@link VuforiaTrackableDefaultListener} and can so safely cast because
     * we have not ourselves installed a listener of a different type.
     */
    ((VuforiaTrackableDefaultListener) redTarget.getListener()).setPhoneInformation(phoneLocationOnRobot, parameters.cameraDirection);
    ((VuforiaTrackableDefaultListener) blueTarget.getListener()).setPhoneInformation(phoneLocationOnRobot, parameters.cameraDirection);
    /**
     * A brief tutorial: here's how all the math is going to work:
     *
     * C = phoneLocationOnRobot  maps   phone coords -> robot coords
     * P = tracker.getPose()     maps   image target coords -> phone coords
     * L = redTargetLocationOnField maps   image target coords -> field coords
     *
     * So
     *
     * C.inverted()              maps   robot coords -> phone coords
     * P.inverted()              maps   phone coords -> imageTarget coords
     *
     * Putting that all together,
     *
     * L x P.inverted() x C.inverted() maps robot coords to field coords.
     *
     * @see VuforiaTrackableDefaultListener#getRobotLocation()
     */
    /**
     * Wait for the game to begin
     */
    telemetry.addData(">", "Press Play to start tracking");
    telemetry.update();
    waitForStart();
    /**
     * Start tracking the data sets we care about.
     */
    stonesAndChips.activate();
    while (opModeIsActive()) {
        for (VuforiaTrackable trackable : allTrackables) {
            /**
             * getUpdatedRobotLocation() will return null if no new information is available since
             * the last time that call was made, or if the trackable is not currently visible.
             * getRobotLocation() will return null if the trackable is not currently visible.
             */
            // 
            telemetry.addData(trackable.getName(), ((VuforiaTrackableDefaultListener) trackable.getListener()).isVisible() ? "Visible" : "Not Visible");
            OpenGLMatrix robotLocationTransform = ((VuforiaTrackableDefaultListener) trackable.getListener()).getUpdatedRobotLocation();
            if (robotLocationTransform != null) {
                lastLocation = robotLocationTransform;
            }
        }
        /**
         * Provide feedback as to where the robot was last located (if we know).
         */
        if (lastLocation != null) {
            // RobotLog.vv(TAG, "robot=%s", format(lastLocation));
            telemetry.addData("Pos", format(lastLocation));
        } else {
            telemetry.addData("Pos", "Unknown");
        }
        telemetry.update();
    }
}

Example 7 with VuforiaTrackableDefaultListener

use of org.firstinspires.ftc.robotcore.external.navigation.VuforiaTrackableDefaultListener in project robotcode by OutoftheBoxFTC.

the class ConceptVuMarkIdentification method runOpMode.

@Override
public void runOpMode() {
    /*
         * To start up Vuforia, tell it the view that we wish to use for camera monitor (on the RC phone);
         * If no camera monitor is desired, use the parameterless constructor instead (commented out below).
         */
    int cameraMonitorViewId = hardwareMap.appContext.getResources().getIdentifier("cameraMonitorViewId", "id", hardwareMap.appContext.getPackageName());
    VuforiaLocalizer.Parameters parameters = new VuforiaLocalizer.Parameters(cameraMonitorViewId);
    // OR...  Do Not Activate the Camera Monitor View, to save power
    // VuforiaLocalizer.Parameters parameters = new VuforiaLocalizer.Parameters();
    /*
         * IMPORTANT: You need to obtain your own license key to use Vuforia. The string below with which
         * 'parameters.vuforiaLicenseKey' is initialized is for illustration only, and will not function.
         * A Vuforia 'Development' license key, can be obtained free of charge from the Vuforia developer
         * web site at https://developer.vuforia.com/license-manager.
         *
         * Vuforia license keys are always 380 characters long, and look as if they contain mostly
         * random data. As an example, here is a example of a fragment of a valid key:
         *      ... yIgIzTqZ4mWjk9wd3cZO9T1axEqzuhxoGlfOOI2dRzKS4T0hQ8kT ...
         * Once you've obtained a license key, copy the string from the Vuforia web site
         * and paste it in to your code onthe next line, between the double quotes.
         */
    parameters.vuforiaLicenseKey = "ATsODcD/////AAAAAVw2lR...d45oGpdljdOh5LuFB9nDNfckoxb8COxKSFX";
    /*
         * We also indicate which camera on the RC that we wish to use.
         * Here we chose the back (HiRes) camera (for greater range), but
         * for a competition robot, the front camera might be more convenient.
         */
    parameters.cameraDirection = VuforiaLocalizer.CameraDirection.BACK;
    this.vuforia = ClassFactory.createVuforiaLocalizer(parameters);
    /**
     * Load the data set containing the VuMarks for Relic Recovery. There's only one trackable
     * in this data set: all three of the VuMarks in the game were created from this one template,
     * but differ in their instance id information.
     * @see VuMarkInstanceId
     */
    VuforiaTrackables relicTrackables = this.vuforia.loadTrackablesFromAsset("RelicVuMark");
    VuforiaTrackable relicTemplate = relicTrackables.get(0);
    // can help in debugging; otherwise not necessary
    relicTemplate.setName("relicVuMarkTemplate");
    telemetry.addData(">", "Press Play to start");
    telemetry.update();
    waitForStart();
    relicTrackables.activate();
    while (opModeIsActive()) {
        /**
         * See if any of the instances of {@link relicTemplate} are currently visible.
         * {@link RelicRecoveryVuMark} is an enum which can have the following values:
         * UNKNOWN, LEFT, CENTER, and RIGHT. When a VuMark is visible, something other than
         * UNKNOWN will be returned by {@link RelicRecoveryVuMark#from(VuforiaTrackable)}.
         */
        RelicRecoveryVuMark vuMark = RelicRecoveryVuMark.from(relicTemplate);
        if (vuMark != RelicRecoveryVuMark.UNKNOWN) {
            /* Found an instance of the template. In the actual game, you will probably
                 * loop until this condition occurs, then move on to act accordingly depending
                 * on which VuMark was visible. */
            telemetry.addData("VuMark", "%s visible", vuMark);
            /* For fun, we also exhibit the navigational pose. In the Relic Recovery game,
                 * it is perhaps unlikely that you will actually need to act on this pose information, but
                 * we illustrate it nevertheless, for completeness. */
            OpenGLMatrix pose = ((VuforiaTrackableDefaultListener) relicTemplate.getListener()).getPose();
            telemetry.addData("Pose", format(pose));
            /* We further illustrate how to decompose the pose into useful rotational and
                 * translational components */
            if (pose != null) {
                VectorF trans = pose.getTranslation();
                Orientation rot = Orientation.getOrientation(pose, AxesReference.EXTRINSIC, AxesOrder.XYZ, AngleUnit.DEGREES);
                // Extract the X, Y, and Z components of the offset of the target relative to the robot
                double tX = trans.get(0);
                double tY = trans.get(1);
                double tZ = trans.get(2);
                // Extract the rotational components of the target relative to the robot
                double rX = rot.firstAngle;
                double rY = rot.secondAngle;
                double rZ = rot.thirdAngle;
            }
        } else {
            telemetry.addData("VuMark", "not visible");
        }
        telemetry.update();
    }
}

Example 8 with VuforiaTrackableDefaultListener

use of org.firstinspires.ftc.robotcore.external.navigation.VuforiaTrackableDefaultListener in project FTC-2017 by FIRST-4030.

the class ConceptVuforiaNavigation method runOpMode.

@Override
public void runOpMode() {
    /*
         * To start up Vuforia, tell it the view that we wish to use for camera monitor (on the RC phone);
         * If no camera monitor is desired, use the parameterless constructor instead (commented out below).
         */
    int cameraMonitorViewId = hardwareMap.appContext.getResources().getIdentifier("cameraMonitorViewId", "id", hardwareMap.appContext.getPackageName());
    VuforiaLocalizer.Parameters parameters = new VuforiaLocalizer.Parameters(cameraMonitorViewId);
    // OR...  Do Not Activate the Camera Monitor View, to save power
    // VuforiaLocalizer.Parameters parameters = new VuforiaLocalizer.Parameters();
    /*
         * IMPORTANT: You need to obtain your own license key to use Vuforia. The string below with which
         * 'parameters.vuforiaLicenseKey' is initialized is for illustration only, and will not function.
         * A Vuforia 'Development' license key, can be obtained free of charge from the Vuforia developer
         * web site at https://developer.vuforia.com/license-manager.
         *
         * Vuforia license keys are always 380 characters long, and look as if they contain mostly
         * random data. As an example, here is a example of a fragment of a valid key:
         *      ... yIgIzTqZ4mWjk9wd3cZO9T1axEqzuhxoGlfOOI2dRzKS4T0hQ8kT ...
         * Once you've obtained a license key, copy the string from the Vuforia web site
         * and paste it in to your code onthe next line, between the double quotes.
         */
    parameters.vuforiaLicenseKey = "ATsODcD/////AAAAAVw2lR...d45oGpdljdOh5LuFB9nDNfckoxb8COxKSFX";
    /*
         * We also indicate which camera on the RC that we wish to use.
         * Here we chose the back (HiRes) camera (for greater range), but
         * for a competition robot, the front camera might be more convenient.
         */
    parameters.cameraDirection = VuforiaLocalizer.CameraDirection.BACK;
    this.vuforia = ClassFactory.createVuforiaLocalizer(parameters);
    /**
     * Load the data sets that for the trackable objects we wish to track. These particular data
     * sets are stored in the 'assets' part of our application (you'll see them in the Android
     * Studio 'Project' view over there on the left of the screen). You can make your own datasets
     * with the Vuforia Target Manager: https://developer.vuforia.com/target-manager. PDFs for the
     * example "StonesAndChips", datasets can be found in in this project in the
     * documentation directory.
     */
    VuforiaTrackables stonesAndChips = this.vuforia.loadTrackablesFromAsset("StonesAndChips");
    VuforiaTrackable redTarget = stonesAndChips.get(0);
    // Stones
    redTarget.setName("RedTarget");
    VuforiaTrackable blueTarget = stonesAndChips.get(1);
    // Chips
    blueTarget.setName("BlueTarget");
    /**
     * For convenience, gather together all the trackable objects in one easily-iterable collection
     */
    List<VuforiaTrackable> allTrackables = new ArrayList<VuforiaTrackable>();
    allTrackables.addAll(stonesAndChips);
    /**
     * We use units of mm here because that's the recommended units of measurement for the
     * size values specified in the XML for the ImageTarget trackables in data sets. E.g.:
     *      <ImageTarget name="stones" size="247 173"/>
     * You don't *have to* use mm here, but the units here and the units used in the XML
     * target configuration files *must* correspond for the math to work out correctly.
     */
    float mmPerInch = 25.4f;
    // ... or whatever is right for your robot
    float mmBotWidth = 18 * mmPerInch;
    // the FTC field is ~11'10" center-to-center of the glass panels
    float mmFTCFieldWidth = (12 * 12 - 2) * mmPerInch;
    /**
     * In order for localization to work, we need to tell the system where each target we
     * wish to use for navigation resides on the field, and we need to specify where on the robot
     * the phone resides. These specifications are in the form of <em>transformation matrices.</em>
     * Transformation matrices are a central, important concept in the math here involved in localization.
     * See <a href="https://en.wikipedia.org/wiki/Transformation_matrix">Transformation Matrix</a>
     * for detailed information. Commonly, you'll encounter transformation matrices as instances
     * of the {@link OpenGLMatrix} class.
     *
     * For the most part, you don't need to understand the details of the math of how transformation
     * matrices work inside (as fascinating as that is, truly). Just remember these key points:
     * <ol>
     *
     *     <li>You can put two transformations together to produce a third that combines the effect of
     *     both of them. If, for example, you have a rotation transform R and a translation transform T,
     *     then the combined transformation matrix RT which does the rotation first and then the translation
     *     is given by {@code RT = T.multiplied(R)}. That is, the transforms are multiplied in the
     *     <em>reverse</em> of the chronological order in which they applied.</li>
     *
     *     <li>A common way to create useful transforms is to use methods in the {@link OpenGLMatrix}
     *     class and the Orientation class. See, for example, {@link OpenGLMatrix#translation(float,
     *     float, float)}, {@link OpenGLMatrix#rotation(AngleUnit, float, float, float, float)}, and
     *     {@link Orientation#getRotationMatrix(AxesReference, AxesOrder, AngleUnit, float, float, float)}.
     *     Related methods in {@link OpenGLMatrix}, such as {@link OpenGLMatrix#rotated(AngleUnit,
     *     float, float, float, float)}, are syntactic shorthands for creating a new transform and
     *     then immediately multiplying the receiver by it, which can be convenient at times.</li>
     *
     *     <li>If you want to break open the black box of a transformation matrix to understand
     *     what it's doing inside, use {@link MatrixF#getTranslation()} to fetch how much the
     *     transform will move you in x, y, and z, and use {@link Orientation#getOrientation(MatrixF,
     *     AxesReference, AxesOrder, AngleUnit)} to determine the rotational motion that the transform
     *     will impart. See {@link #format(OpenGLMatrix)} below for an example.</li>
     *
     * </ol>
     *
     * This example places the "stones" image on the perimeter wall to the Left
     *  of the Red Driver station wall.  Similar to the Red Beacon Location on the Res-Q
     *
     * This example places the "chips" image on the perimeter wall to the Right
     *  of the Blue Driver station.  Similar to the Blue Beacon Location on the Res-Q
     *
     * See the doc folder of this project for a description of the field Axis conventions.
     *
     * Initially the target is conceptually lying at the origin of the field's coordinate system
     * (the center of the field), facing up.
     *
     * In this configuration, the target's coordinate system aligns with that of the field.
     *
     * In a real situation we'd also account for the vertical (Z) offset of the target,
     * but for simplicity, we ignore that here; for a real robot, you'll want to fix that.
     *
     * To place the Stones Target on the Red Audience wall:
     * - First we rotate it 90 around the field's X axis to flip it upright
     * - Then we rotate it  90 around the field's Z access to face it away from the audience.
     * - Finally, we translate it back along the X axis towards the red audience wall.
     */
    OpenGLMatrix redTargetLocationOnField = OpenGLMatrix.translation(-mmFTCFieldWidth / 2, 0, 0).multiplied(Orientation.getRotationMatrix(/* First, in the fixed (field) coordinate system, we rotate 90deg in X, then 90 in Z */
    AxesReference.EXTRINSIC, AxesOrder.XZX, AngleUnit.DEGREES, 90, 90, 0));
    redTarget.setLocation(redTargetLocationOnField);
    RobotLog.ii(TAG, "Red Target=%s", format(redTargetLocationOnField));
    /*
        * To place the Stones Target on the Blue Audience wall:
        * - First we rotate it 90 around the field's X axis to flip it upright
        * - Finally, we translate it along the Y axis towards the blue audience wall.
        */
    OpenGLMatrix blueTargetLocationOnField = OpenGLMatrix.translation(0, mmFTCFieldWidth / 2, 0).multiplied(Orientation.getRotationMatrix(/* First, in the fixed (field) coordinate system, we rotate 90deg in X */
    AxesReference.EXTRINSIC, AxesOrder.XZX, AngleUnit.DEGREES, 90, 0, 0));
    blueTarget.setLocation(blueTargetLocationOnField);
    RobotLog.ii(TAG, "Blue Target=%s", format(blueTargetLocationOnField));
    /**
     * Create a transformation matrix describing where the phone is on the robot. Here, we
     * put the phone on the right hand side of the robot with the screen facing in (see our
     * choice of BACK camera above) and in landscape mode. Starting from alignment between the
     * robot's and phone's axes, this is a rotation of -90deg along the Y axis.
     *
     * When determining whether a rotation is positive or negative, consider yourself as looking
     * down the (positive) axis of rotation from the positive towards the origin. Positive rotations
     * are then CCW, and negative rotations CW. An example: consider looking down the positive Z
     * axis towards the origin. A positive rotation about Z (ie: a rotation parallel to the the X-Y
     * plane) is then CCW, as one would normally expect from the usual classic 2D geometry.
     */
    OpenGLMatrix phoneLocationOnRobot = OpenGLMatrix.translation(mmBotWidth / 2, 0, 0).multiplied(Orientation.getRotationMatrix(AxesReference.EXTRINSIC, AxesOrder.YZY, AngleUnit.DEGREES, -90, 0, 0));
    RobotLog.ii(TAG, "phone=%s", format(phoneLocationOnRobot));
    /**
     * Let the trackable listeners we care about know where the phone is. We know that each
     * listener is a {@link VuforiaTrackableDefaultListener} and can so safely cast because
     * we have not ourselves installed a listener of a different type.
     */
    ((VuforiaTrackableDefaultListener) redTarget.getListener()).setPhoneInformation(phoneLocationOnRobot, parameters.cameraDirection);
    ((VuforiaTrackableDefaultListener) blueTarget.getListener()).setPhoneInformation(phoneLocationOnRobot, parameters.cameraDirection);
    /**
     * A brief tutorial: here's how all the math is going to work:
     *
     * C = phoneLocationOnRobot  maps   phone coords -> robot coords
     * P = tracker.getPose()     maps   image target coords -> phone coords
     * L = redTargetLocationOnField maps   image target coords -> field coords
     *
     * So
     *
     * C.inverted()              maps   robot coords -> phone coords
     * P.inverted()              maps   phone coords -> imageTarget coords
     *
     * Putting that all together,
     *
     * L x P.inverted() x C.inverted() maps robot coords to field coords.
     *
     * @see VuforiaTrackableDefaultListener#getRobotLocation()
     */
    /**
     * Wait for the game to begin
     */
    telemetry.addData(">", "Press Play to start tracking");
    telemetry.update();
    waitForStart();
    /**
     * Start tracking the data sets we care about.
     */
    stonesAndChips.activate();
    while (opModeIsActive()) {
        for (VuforiaTrackable trackable : allTrackables) {
            /**
             * getUpdatedRobotLocation() will return null if no new information is available since
             * the last time that call was made, or if the trackable is not currently visible.
             * getRobotLocation() will return null if the trackable is not currently visible.
             */
            // 
            telemetry.addData(trackable.getName(), ((VuforiaTrackableDefaultListener) trackable.getListener()).isVisible() ? "Visible" : "Not Visible");
            OpenGLMatrix robotLocationTransform = ((VuforiaTrackableDefaultListener) trackable.getListener()).getUpdatedRobotLocation();
            if (robotLocationTransform != null) {
                lastLocation = robotLocationTransform;
            }
        }
        /**
         * Provide feedback as to where the robot was last located (if we know).
         */
        if (lastLocation != null) {
            // RobotLog.vv(TAG, "robot=%s", format(lastLocation));
            telemetry.addData("Pos", format(lastLocation));
        } else {
            telemetry.addData("Pos", "Unknown");
        }
        telemetry.update();
    }
}

Example 9 with VuforiaTrackableDefaultListener

use of org.firstinspires.ftc.robotcore.external.navigation.VuforiaTrackableDefaultListener in project Relic_Main by TeamOverdrive.

the class ConceptVuMarkIdentification method runOpMode.

@Override
public void runOpMode() {
    /*
         * To start up Vuforia, tell it the view that we wish to use for camera monitor (on the RC phone);
         * If no camera monitor is desired, use the parameterless constructor instead (commented out below).
         */
    int cameraMonitorViewId = hardwareMap.appContext.getResources().getIdentifier("cameraMonitorViewId", "id", hardwareMap.appContext.getPackageName());
    VuforiaLocalizer.Parameters parameters = new VuforiaLocalizer.Parameters(cameraMonitorViewId);
    // OR...  Do Not Activate the Camera Monitor View, to save power
    // VuforiaLocalizer.Parameters parameters = new VuforiaLocalizer.Parameters();
    /*
         * IMPORTANT: You need to obtain your own license key to use Vuforia. The string below with which
         * 'parameters.vuforiaLicenseKey' is initialized is for illustration only, and will not function.
         * A Vuforia 'Development' license key, can be obtained free of charge from the Vuforia developer
         * web site at https://developer.vuforia.com/license-manager.
         *
         * Vuforia license keys are always 380 characters long, and look as if they contain mostly
         * random data. As an example, here is a example of a fragment of a valid key:
         *      ... yIgIzTqZ4mWjk9wd3cZO9T1axEqzuhxoGlfOOI2dRzKS4T0hQ8kT ...
         * Once you've obtained a license key, copy the string from the Vuforia web site
         * and paste it in to your code onthe next line, between the double quotes.
         */
    parameters.vuforiaLicenseKey = "ATsODcD/////AAAAAVw2lR...d45oGpdljdOh5LuFB9nDNfckoxb8COxKSFX";
    /*
         * We also indicate which camera on the RC that we wish to use.
         * Here we chose the back (HiRes) camera (for greater range), but
         * for a competition robot, the front camera might be more convenient.
         */
    parameters.cameraDirection = VuforiaLocalizer.CameraDirection.BACK;
    this.vuforia = ClassFactory.createVuforiaLocalizer(parameters);
    /**
     * Load the data set containing the VuMarks for Relic Recovery. There's only one trackable
     * in this data set: all three of the VuMarks in the game were created from this one template,
     * but differ in their instance id information.
     * @see VuMarkInstanceId
     */
    VuforiaTrackables relicTrackables = this.vuforia.loadTrackablesFromAsset("RelicVuMark");
    VuforiaTrackable relicTemplate = relicTrackables.get(0);
    // can help in debugging; otherwise not necessary
    relicTemplate.setName("relicVuMarkTemplate");
    telemetry.addData(">", "Press Play to start");
    telemetry.update();
    waitForStart();
    relicTrackables.activate();
    while (opModeIsActive()) {
        /**
         * See if any of the instances of {@link relicTemplate} are currently visible.
         * {@link RelicRecoveryVuMark} is an enum which can have the following values:
         * UNKNOWN, LEFT, CENTER, and RIGHT. When a VuMark is visible, something other than
         * UNKNOWN will be returned by {@link RelicRecoveryVuMark#from(VuforiaTrackable)}.
         */
        RelicRecoveryVuMark vuMark = RelicRecoveryVuMark.from(relicTemplate);
        if (vuMark != RelicRecoveryVuMark.UNKNOWN) {
            /* Found an instance of the template. In the actual game, you will probably
                 * loop until this condition occurs, then move on to act accordingly depending
                 * on which VuMark was visible. */
            telemetry.addData("VuMark", "%s visible", vuMark);
            /* For fun, we also exhibit the navigational pose. In the Relic Recovery game,
                 * it is perhaps unlikely that you will actually need to act on this pose information, but
                 * we illustrate it nevertheless, for completeness. */
            OpenGLMatrix pose = ((VuforiaTrackableDefaultListener) relicTemplate.getListener()).getPose();
            telemetry.addData("Pose", format(pose));
            /* We further illustrate how to decompose the pose into useful rotational and
                 * translational components */
            if (pose != null) {
                VectorF trans = pose.getTranslation();
                Orientation rot = Orientation.getOrientation(pose, AxesReference.EXTRINSIC, AxesOrder.XYZ, AngleUnit.DEGREES);
                // Extract the X, Y, and Z components of the offset of the target relative to the robot
                double tX = trans.get(0);
                double tY = trans.get(1);
                double tZ = trans.get(2);
                // Extract the rotational components of the target relative to the robot
                double rX = rot.firstAngle;
                double rY = rot.secondAngle;
                double rZ = rot.thirdAngle;
            }
        } else {
            telemetry.addData("VuMark", "not visible");
        }
        telemetry.update();
    }
}