org.bytedeco.artoolkitplus

Class TrackerSingleMarker

java.lang.Object

org.bytedeco.javacpp.Pointer

org.bytedeco.artoolkitplus.Tracker

org.bytedeco.artoolkitplus.TrackerSingleMarker

All Implemented Interfaces:

AutoCloseable

Direct Known Subclasses:

SingleTracker

@Namespace(value="ARToolKitPlus")
 @NoOffset
 @Properties(inherit=ARToolKitPlus.class)
public class TrackerSingleMarker
extends Tracker

Defines a simple interface for single-marker tracking with ARToolKitPlus ARToolKitPlus::TrackerSingleMarker provides all methods to access ARToolKit for single marker tracking without needing to mess around with it low level methods directly. Per default the tracker searches for Id-based markers with normal border and uses the RPP algorithm for pose estimation. You can override this using the according methods. If you need multi-marker tracking use TrackerMultiMarker.

Nested Class Summary

Nested classes/interfaces inherited from class org.bytedeco.javacpp.Pointer

Pointer.CustomDeallocator, Pointer.Deallocator, Pointer.NativeDeallocator

Field Summary

Fields inherited from class org.bytedeco.javacpp.Pointer

address, capacity, limit, position

Constructor Summary

Constructors

Constructor and Description
TrackerSingleMarker(int imWidth, int imHeight)
TrackerSingleMarker(int imWidth, int imHeight, int maxImagePatterns, int pattWidth, int pattHeight, int pattSamples, int maxLoadPatterns) These parameters control the way the toolkit warps a found marker to a perfect square.
TrackerSingleMarker(Pointer p) Pointer cast constructor.

Method Summary

Modifier and Type	Method and Description
int	addPattern(BytePointer nFileName) adds a pattern to ARToolKit pass the patterns filename
int	addPattern(String nFileName)
int[]	calc(byte[] nImage)
int[]	calc(byte[] nImage, ARMarkerInfo nMarker_info, int[] nNumMarkers)
IntBuffer	calc(ByteBuffer nImage)
IntBuffer	calc(ByteBuffer nImage, ARMarkerInfo nMarker_info, IntBuffer nNumMarkers)
IntPointer	calc(BytePointer nImage)
IntPointer	calc(BytePointer nImage, ARMarkerInfo nMarker_info, IntPointer nNumMarkers)
IntPointer	calc(BytePointer nImage, PointerPointer nMarker_info, IntPointer nNumMarkers) calculates the transformation matrix pass the image as RGBX (32-bits)
void	getARMatrix(float[] nMatrix)
void	getARMatrix(FloatBuffer nMatrix)
void	getARMatrix(FloatPointer nMatrix) Provides access to ARToolKit' patt_trans matrix This method is primarily for compatibility issues with code previously using ARToolKit rather than ARToolKitPlus.
float	getConfidence() Returns the confidence value of the currently best detected marker.
boolean	init(BytePointer nCamParamFile, float nNearClip, float nFarClip) initializes TrackerSingleMarker
boolean	init(String nCamParamFile, float nNearClip, float nFarClip)
int	selectBestMarkerByCf() Select the best marker based on Confidence
void	selectDetectedMarker(int id) manually select one of the detected markers instead of using the best one
void	setPatternWidth(float nWidth) Sets the width and height of the patterns in OpenGL units defaults to 2.0, so the unity cube fits the marker surface

Methods inherited from class org.bytedeco.artoolkitplus.Tracker

activateAutoThreshold, activateBinaryMarker, activateVignettingCompensation, activateVignettingCompensation, arDetectMarker, arDetectMarker, arDetectMarker, arDetectMarker, arDetectMarkerLite, arDetectMarkerLite, arDetectMarkerLite, arDetectMarkerLite, arFreePatt, arGetTransMat, arGetTransMat, arGetTransMat, arGetTransMatCont, arGetTransMatCont, arGetTransMatCont, arLoadPatt, arLoadPatt, arLoadPatt, arMultiFreeConfig, arMultiGetTransMat, arMultiGetTransMatHull, arMultiReadConfigFile, arMultiReadConfigFile, calcCameraMatrix, calcCameraMatrix, calcCameraMatrix, calcCameraMatrix, calcCameraMatrix, calcCameraMatrix, calcOpenGLMatrixFromMarker, calcOpenGLMatrixFromMarker, calcOpenGLMatrixFromMarker, changeCameraSize, executeMultiMarkerPoseEstimator, executeSingleMarkerPoseEstimator, executeSingleMarkerPoseEstimator, executeSingleMarkerPoseEstimator, getBitsPerPixel, getCamera, getModelViewMatrix, getNumLoadablePatterns, getPixelFormat, getProjectionMatrix, getThreshold, getTrackedCorners, isAutoThresholdActivated, loadCameraFile, loadCameraFile, rppGetTransMat, rppGetTransMat, rppGetTransMat, rppMultiGetTransMat, setBorderWidth, setCamera, setCamera, setHullMode, setImageProcessingMode, setLoadUndistLUT, setMarkerMode, setNumAutoThresholdRetries, setPixelFormat, setPoseEstimator, setThreshold, setUndistortionMode

Methods inherited from class org.bytedeco.javacpp.Pointer

address, asBuffer, asByteBuffer, availablePhysicalBytes, calloc, capacity, capacity, close, deallocate, deallocate, deallocateReferences, deallocator, deallocator, equals, fill, formatBytes, free, hashCode, isNull, limit, limit, malloc, maxBytes, maxPhysicalBytes, memchr, memcmp, memcpy, memmove, memset, offsetof, parseBytes, physicalBytes, position, position, put, realloc, setNull, sizeof, toString, totalBytes, totalPhysicalBytes, withDeallocator, zero

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

TrackerSingleMarker

public TrackerSingleMarker(Pointer p)

Pointer cast constructor. Invokes Pointer.Pointer(Pointer).

TrackerSingleMarker

public TrackerSingleMarker(int imWidth,
                           int imHeight,
                           int maxImagePatterns,
                           int pattWidth,
                           int pattHeight,
                           int pattSamples,
                           int maxLoadPatterns)

These parameters control the way the toolkit warps a found marker to a perfect square. The square has size pattWidth * pattHeight, the projected square in the image is subsampled at a min of pattWidth/pattHeight and a max of pattSamples steps in both x and y direction

Parameters:

imWidth - width of the source image in px

imHeight - height of the source image in px

maxImagePatterns - describes the maximum number of patterns that can be analyzed in a camera image.

pattWidth - describes the pattern image width (must be 6 for binary markers)

pattHeight - describes the pattern image height (must be 6 for binary markers)

pattSamples - describes the maximum resolution at which a pattern is sampled from the camera image (6 by default, must a a multiple of pattWidth and pattHeight).

maxLoadPatterns - describes the maximum number of pattern files that can be loaded. Reduce maxLoadPatterns and maxImagePatterns to reduce memory footprint.

TrackerSingleMarker

public TrackerSingleMarker(int imWidth,
                           int imHeight)

Method Detail

init

@Cast(value="bool")
public boolean init(@Cast(value="const char*")
                                         BytePointer nCamParamFile,
                                         @Cast(value="ARFloat")
                                         float nNearClip,
                                         @Cast(value="ARFloat")
                                         float nFarClip)

initializes TrackerSingleMarker

Parameters:

nCamParamFile - is the name of the camera parameter file

init

@Cast(value="bool")
public boolean init(String nCamParamFile,
                                         @Cast(value="ARFloat")
                                         float nNearClip,
                                         @Cast(value="ARFloat")
                                         float nFarClip)

addPattern

public int addPattern(@Cast(value="const char*")
                      BytePointer nFileName)

adds a pattern to ARToolKit pass the patterns filename

addPattern

public int addPattern(String nFileName)

calc

@StdVector
public IntPointer calc(@Cast(value="const uint8_t*")
                                   BytePointer nImage,
                                   @Cast(value="ARToolKitPlus::ARMarkerInfo**")
                                   PointerPointer nMarker_info,
                                   IntPointer nNumMarkers)

calculates the transformation matrix pass the image as RGBX (32-bits)

Returns:

detected markers in image

calc

@StdVector
public IntPointer calc(@Cast(value="const uint8_t*")
                                   BytePointer nImage)

calc

@StdVector
public IntPointer calc(@Cast(value="const uint8_t*")
                                   BytePointer nImage,
                                   @ByPtrPtr
                                   ARMarkerInfo nMarker_info,
                                   IntPointer nNumMarkers)

calc

@StdVector
public IntBuffer calc(@Cast(value="const uint8_t*")
                                  ByteBuffer nImage,
                                  @ByPtrPtr
                                  ARMarkerInfo nMarker_info,
                                  IntBuffer nNumMarkers)

calc

@StdVector
public IntBuffer calc(@Cast(value="const uint8_t*")
                                  ByteBuffer nImage)

calc

@StdVector
public int[] calc(@Cast(value="const uint8_t*")
                              byte[] nImage,
                              @ByPtrPtr
                              ARMarkerInfo nMarker_info,
                              int[] nNumMarkers)

calc

@StdVector
public int[] calc(@Cast(value="const uint8_t*")
                              byte[] nImage)

selectDetectedMarker

public void selectDetectedMarker(int id)

manually select one of the detected markers instead of using the best one

selectBestMarkerByCf

public int selectBestMarkerByCf()

Select the best marker based on Confidence

setPatternWidth

public void setPatternWidth(@Cast(value="ARFloat")
                            float nWidth)

Sets the width and height of the patterns in OpenGL units defaults to 2.0, so the unity cube fits the marker surface

getARMatrix

public void getARMatrix(@Cast(value="ARFloat(* /*[3]*/ )[4]")
                        FloatPointer nMatrix)

Provides access to ARToolKit' patt_trans matrix This method is primarily for compatibility issues with code previously using ARToolKit rather than ARToolKitPlus. patt_trans is the original transformation matrix ARToolKit calculates rather than the OpenGL style version of this matrix that can be retrieved via getModelViewMatrix().

getARMatrix

public void getARMatrix(@Cast(value="ARFloat(* /*[3]*/ )[4]")
                        FloatBuffer nMatrix)

getARMatrix

public void getARMatrix(@Cast(value="ARFloat(* /*[3]*/ )[4]")
                        float[] nMatrix)

getConfidence

public float getConfidence()

Returns the confidence value of the currently best detected marker.