arMulti.h File Reference

ARToolkit multi pattern subroutines. More...

#include <stdio.h>
#include <AR/config.h>
#include <AR/param.h>
#include <AR/ar.h>
#include <malloc.h>

Include dependency graph for arMulti.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	ARMultiEachMarkerInfoT
	multi-marker structure More...
struct	ARMultiMarkerInfoT
	global multi-marker structure More...
Functions
int	arMultiActivate (ARMultiMarkerInfoT *config)
	activate a multi-marker pattern on the recognition procedure.
int	arMultiDeactivate (ARMultiMarkerInfoT *config)
	Desactivate a multi-marker pattern on the recognition procedure.
int	arMultiFreeConfig (ARMultiMarkerInfoT *config)
	remove a multi-marker pattern from memory.
double	arMultiGetTransMat (ARMarkerInfo *marker_info, int marker_num, ARMultiMarkerInfoT *config)
	compute camera position in function of the multi-marker patterns (based on detected markers)
ARMultiMarkerInfoT *	arMultiReadConfigFile (const char *filename)
	loading multi-markers description from a file
double	arsMultiGetTransMat (ARMarkerInfo *marker_infoL, int marker_numL, ARMarkerInfo *marker_infoR, int marker_numR, ARMultiMarkerInfoT *config)

---

Detailed Description

ARToolkit multi pattern subroutines.

This file extend ar core routines for multi-pattern tracking. You can obtain position of a local coordinate system based on the estimation of multiple markers tracking (each in relative position)

Remarks:

more efficient with uniform planar configuration

History :

Author:

Hirokazu Kato kato@sys.im.hiroshima-cu.ac.jp

Version:

1.0

Date:

01/09/05

Definition in file arMulti.h.

---

Function Documentation

int arMultiActivate

(

ARMultiMarkerInfoT *

config

)

activate a multi-marker pattern on the recognition procedure.

Activate a multi-marker for be checking during the template matching operation.

Parameters:

config

pointer to the multi-marker

Returns:

0 if success, -1 if error

Definition at line 18 of file arMultiActivate.c.

int arMultiDeactivate

(

ARMultiMarkerInfoT *

config

)

Desactivate a multi-marker pattern on the recognition procedure.

Desactivate a multi-marker for not be checking during the template matching operation.

Parameters:

config

pointer to the multi-marker

Returns:

0 if success, -1 if error

Definition at line 31 of file arMultiActivate.c.

int arMultiFreeConfig

(

ARMultiMarkerInfoT *

config

)

remove a multi-marker pattern from memory.

desactivate a pattern and remove it from memory. Post-condition of this function is unavailability of the multi-marker pattern.

Parameters:

config

pointer to the multi-marker

Returns:

0 if success, -1 if error

Definition at line 44 of file arMultiActivate.c.

double arMultiGetTransMat	(	ARMarkerInfo *	marker_info,
		int	marker_num,
		ARMultiMarkerInfoT *	config
	)

compute camera position in function of the multi-marker patterns (based on detected markers)

calculate the transformation between the multi-marker patterns and the real camera. Based on confident values of detected markers in the multi-markers patterns, a global position is return.

Parameters:

	marker_info	list of detected markers (from arDetectMarker)
	marker_num	number of detected markers
	config

Returns:

Definition at line 38 of file arMultiGetTransMat.c.

ARMultiMarkerInfoT* arMultiReadConfigFile

(

const char *

filename

)

loading multi-markers description from a file

Load a configuration file for multi-markers tracking. The configuration file furnishs pointer to each pattern description.

Parameters:

filename

name of the pattern file

Returns:

a pattern structure, NULL if error

Definition at line 20 of file arMultiReadConfigFile.c.

double arsMultiGetTransMat	(	ARMarkerInfo *	marker_infoL,
		int	marker_numL,
		ARMarkerInfo *	marker_infoR,
		int	marker_numR,
		ARMultiMarkerInfoT *	config
	)