recoalgo.h

基于主成份分析（PCA）的人脸特征识别核心源程序。

/***
 **     libface - Library of face recognition and supporting algorithms
        Copyright (c) 2003 Stefan Farthofer

	This file is part of libface, which is

        free software; you can redistribute it and/or modify
        it under the terms of the GNU General Public License as published by
        the Free Software Foundation; either version 2 of the License, or
        (at your option) any later version.

        This program is distributed in the hope that it will be useful,
        but WITHOUT ANY WARRANTY; without even the implied warranty of
        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
        GNU General Public License for more details.

        You should have received a copy of the GNU General Public License
        along with this program; if not, write to the Free Software
        Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

	For further information seek us at http://sourceforge.net/projects/openbio/
**	or write an email to [e-mail] or [e-mail].
***/
/* declares the struct a recognition algorithm has to implement */

#ifndef __RECOALGO_H
#define __RECOALGO_H

struct sRecoAlgo {
	/* init and info */
	int (*init)(void);
	const char* (*getName)(void);
	int (*getType)(void);

	/* basic functions */
	int (*setupAlgoInstance)(FRrecognitionParameters* gParms, FRalgoParam* algoParms, unsigned int nrAlgoParms, FRimage* images, unsigned int nrImages, BYTE** parms);
	size_t (*getParametersSize)(FRrecognitionParameters* gParms, BYTE* parms);
	int (*serializeParameters)(FRrecognitionParameters* gParms, BYTE** parms, BYTE** mem, size_t maxsz, BYTE direction);
	void (*freeParameters)(FRrecognitionParameters* gParms, BYTE** parms);
	int (*copyParameters)(FRrecognitionParameters* gParms, BYTE** parmsDst, BYTE *parmsSrc);

	int (*computeTrait)(FRrecognitionParameters* gParms, BYTE* parms, FRimage* image, BYTE** trait);
	int (*compareTraits)(FRrecognitionParameters* gParms, BYTE* parms, BYTE* trait1, BYTE* trait2, float* probability);
	size_t (*getTraitSize)(FRrecognitionParameters* gParms, BYTE* parms, BYTE* trait);
	int (*serializeTrait)(FRrecognitionParameters* gParms, BYTE* parms, BYTE** trait, BYTE** mem, size_t maxsz, BYTE direction);
	void (*freeTrait)(FRrecognitionParameters* gParms, BYTE* parms, BYTE** trait);

	/* extended functions for debugging and visualization of algorithm */
	int (*trainedDataToImages)(FRrecognitionParameters* gParms, BYTE* parms, FRimage** images, unsigned int* nrImages);
	int (*trainedDataToText) (FRrecognitionParameters* gParms, BYTE* parms, char** text);
	int (*traitToImages)(FRrecognitionParameters* gParms, BYTE* parms, BYTE* trait, FRimage** images, unsigned int* nrImages);
	int (*traitToText)(FRrecognitionParameters* gParms, BYTE* parms, BYTE* trait, char** text);
};
#define FRrecoAlgo struct sRecoAlgo

/* functions to manage reco algos, will mainly be used by init, i suppose */
int frAddRecoAlgo(FRrecoAlgo* algo);
int frRemoveRecoAlgo(int id);
FRrecoAlgo* frGetRecoAlgoById(int id);

/* functions used by recoAlgos for serialization */
void frCopyMem(BYTE** mem, void * data, size_t sz, BYTE direction);

#endif /* header guard */