Image Tracker
Related documentations |
---|
Target Manager |
Recommended Conditions for Target Images |
Tracker Coordinate System |
The Image Tracker recognizes and tracks planar images. You can lay not only 3D objects but also videos(including transparent ones) on them.
Start / Stop Tracker
Use Tracking Information
Set Target Image
Add / Replace Target Image
Change Tracking Mode
Start / Stop Tracker
To start / stop Tracker after loading the map, refer to the following code.
>ImageTrackerActivity.java
@Override protected void onResume() { ... TrackerManager.getInstance().startTracker(TrackerManager.TRACKER_TYPE_IMAGE); ... } @Override protected void onPause() { ... TrackerManager.getInstance().stopTracker(); ... }
Use the Tracking Information
In the folder where SDK is installed, go to 'assets > ImageTarget' folder, and there is sample target image. Print the image.
If you use the sample code, the following content will be augmented for each image.
- Blocks.jpg: The alpha video is augmented.
- Lego.jpg: The normal video is augmented.
- Glacier.jpg: The cube with the texture is augmented.
To apply tracking results to augmented objects, refer to the following code.
>ImageTrackerRenderer.java
public void onDrawFrame(GL10 unused) { ... TrackingState state = TrackerManager.GetInstance().UpdateTrackingState(); TrackingResult trackingResult = state.GetTrackingResult(); for (int i = 0; i < trackingResult.getCount(); i++) { Trackable trackable = trackingResult.getTrackable(i); if (trackable.getName().equals("Lego")) { ... videoQuad.draw(); } else if (trackable.getName().equals("Blocks")) { ... chromaKeyVideoQuad.draw(); } else if (trackable.getName().equals("Glacier")) { ... texturedCube.draw(); } else { coloredCube.setProjectionMatrix(projectionMatrix); coloredCube.setTransform(trackable.getPoseMatrix()); coloredCube.setScale(0.3f, 0.3f, 0.01f); coloredCube.draw(); } } … }
Set Target Image
By calling addTrackerData () to register the map file and calling loadTrackerData (), the target image can be tracked. To set a target image, refer to the following code.
>ImageTrackerActivity.java
onCreate() { ... TrackerManager.getInstance().addTrackerData("ImageTarget/Blocks.2dmap", true); TrackerManager.getInstance().addTrackerData("ImageTarget/Glacier.2dmap", true); TrackerManager.getInstance().addTrackerData("ImageTarget/Lego.2dmap", true); TrackerManager.getInstance().loadTrackerData(); ... }
Add / Replace Target Image
Create a map file refer to Target Manager.
Download the file you created.
Unzip the downloaded file and copy it to the desired path. The way to copy maps to the assets folder and to the external storage is different.
- When copying to the assets folder, set the second parameter to true to indicate that it is a relative path and a file in the assets folder.
TrackerManager.getInstance().addTrackerData("ImageTarget/Blocks.2dmap", true);
- If copying to external storage, enter the full path and set the second parameter to false.
TrackerManager.getInstance().addTrackerData(mapFile.getAbsolutePath(), false);
※ You must call loadTrackerData () after calling addTrackerData ().
Change Tracking Mode
5 Tracking Modes of Image Tracker:
NORMAL_TRACKING, EXTENDED_TRACKING, MULTI_TRACKING, JITTER_REDUCTION_ACTIVATION, JITTER_REDUCTION_DEACTIVATIO
- NORMAL_TRACKING: Default Setting. Traceable one target image.
TrackerManager.getInstance().setTrackingOption(TrackerManager.TrackingOption.NORMAL_TRACKING);
- EXTENDED_TRACKING: Traceable even at the far distance from the target image.
TrackerManager.getInstance().setTrackingOption(TrackerManager.TrackingOption.EXTENDED_TRACKING);
- MULTI_TRACKING: Possible to recognize and track up to three target images at the same time
TrackerManager.getInstance().setTrackingOption(TrackerManager.TrackingOption.MULTI_TRACKING);
- JITTER_REDUCTION_ACTIVATION: Jitter reduction.
TrackerManager.getInstance().setTrackingOption(TrackerManager.TrackingOption.JITTER_REDUCTION_ACTIVATION);
- JITTER_REDUCTION_DEACTIVATION: Disable the jitter reduction option.
TrackerManager.getInstance().setTrackingOption(TrackerManager.TrackingOption.JITTER_REDUCTION_DEACTIVATION);