param.h File Reference

ARToolkit global structure (parameters) subroutines. More...

#include <AR/config.h>

Data Structures
struct	ARParam
	camera intrinsic parameters. More...
struct	ARSParam
Functions
int	arParamGet (double global[][3], double screen[][2], int data_num, double mat[3][4])
	XXXBK.
int	arParamDecomp (ARParam *source, ARParam *icpara, double trans[3][4])
	XXXBK.
int	arParamDecompMat (double source[3][4], double cpara[3][4], double trans[3][4])
	XXXBK.
int	arParamIdeal2Observ (const double dist_factor[4], const double ix, const double iy, double *ox, double *oy)
	Convert ideal screen coordinates of a vertex to observed ones.
int	arParamObserv2Ideal (const double dist_factor[4], const double ox, const double oy, double *ix, double *iy)
	Convert observed screen coordinates of a vertex to ideal ones.
int	arParamChangeSize (ARParam *source, int xsize, int ysize, ARParam *newparam)
	change the camera size parameters.
int	arParamSave (char *filename, int num, ARParam *param,...)
	save a camera intrinsic parameters.
int	arParamLoad (const char *filename, int num, ARParam *param,...)
	load the camera intrinsic parameters.
int	arParamDisp (ARParam *param)
	display parameters.
int	arsParamChangeSize (ARSParam *source, int xsize, int ysize, ARSParam *newparam)
int	arsParamSave (char *filename, ARSParam *sparam)
int	arsParamLoad (char *filename, ARSParam *sparam)
int	arsParamDisp (ARSParam *sparam)
int	arsParamGetMat (double matL[3][4], double matR[3][4], double cparaL[3][4], double cparaR[3][4], double matL2R[3][4])

---

Detailed Description

ARToolkit global structure (parameters) subroutines.

This file contains principal routines for loading, saving, and modify camera parameters for of ARToolkit library. Different structures are used for modify in run-time this parameters in the library. A file structure is use for input/output.

Remarks:

History :

Author:

Takeshi Mita tmita@inolab.sys.es.osaka-u.ac.jp

Shinsaku Hiura shinsaku@sys.es.osaka-u.ac.jp

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

Version:

4.1

Date:

01/12/07

---

Function Documentation

int arParamChangeSize (  ARParam *  source, int  xsize, int  ysize, ARParam *  newparam )

change the camera size parameters. Change the size variable in camera intrinsic parameters. Parameters: source  name of the source parameters structure xsize  new length size ysize  new height size newparam  name of the destination parameters structure. Returns: 0

int arParamDecomp (  ARParam *  source, ARParam *  icpara, double  trans[3][4] )

XXXBK. XXXBK Parameters: source  XXXBK icpara  XXXBK trans  XXXBK Returns: XXXBK

int arParamDecompMat (  double  source[3][4], double  cpara[3][4], double  trans[3][4] )

XXXBK. XXXBK Parameters: source  input camera matrix cpara  camera parameter to be set trans  XXXBK Returns: XXXBK

int arParamDisp (  ARParam *  param  )

display parameters. Display the structure of the camera instrinsic parameters argument. Parameters: param  structure to display Returns: 0

int arParamGet (  double  global[][3], double  screen[][2], int  data_num, double  mat[3][4] )

XXXBK. XXXBK Parameters: global  XXXBK screen  XXXBK data_num  XXXBK mat  XXXBK Returns: XXXBK

int int arParamIdeal2Observ (  const double  dist_factor[4], const double  ix, const double  iy, double *  ox, double *  oy )

Convert ideal screen coordinates of a vertex to observed ones. Ideal coordinates mean that the distortion of the camera is compensated (so a straight line looks straight). In observed coordinates the camera-distortion is not compensated and thus a straight line is not shown really straight. Parameters: dist_factor  distorsion factors of used camera ix  x in ideal screen coordinates iy  y in ideal screen coordinates ox  resulted x in observed screen coordinates oy  resulted y in observed screen coordinates Returns: 0 if success, -1 otherwise

int arParamLoad (  const char *  filename, int  num, ARParam *  param,   ... )

load the camera intrinsic parameters. Load camera intrinsic parameters in the ARToolkit Library from a file (itself, an output of the calibration step). Parameters: filename  name of the parameters file. num  number of variable arguments param  result of the loaded parameters Returns: 0 if success, -1 if Error (file not found, file structure problem)

int arParamObserv2Ideal (  const double  dist_factor[4], const double  ox, const double  oy, double *  ix, double *  iy )

Convert observed screen coordinates of a vertex to ideal ones. Ideal coordinates mean that the distortion of the camera is compensated (so a straight line looks straight). In observed coordinates the camera-distortion is not compensated and thus a straight line is not shown really straight. Parameters: dist_factor  distorsion factors of used camera ox  x in observed screen coordinates oy  y in observed screen coordinates ix  resulted x in ideal screen coordinates iy  resulted y in ideal screen coordinates Returns: 0 if success, -1 otherwise

int arParamSave (  char *  filename, int  num, ARParam *  param,   ... )

save a camera intrinsic parameters. Save manipulated camera intrinsic parameters in a file. Parameters: filename  name of the parameters file. num  number of variable arguments param  parameters to save Returns: 0 if success, -1 if Error (file not found, file structure problem)

Generated with Doxygen
Copyright © 2004-2006. HIT Lab NZ. All Rights Reserved.