fr.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].
***/

#ifndef __FR_H
#define __FR_H

/* --------- STRUCTURES ----------- */
/* used to hold data computed by an recognitionMethod (e.g. feature vector for eigenfaces) */
struct sImageTrait {
	BYTE *data;
};
#define FRimageTrait struct sImageTrait

struct sImage {
	unsigned int width;		/* width and height of the image */
	unsigned int height;
	float *imgdata;			/* pointer to image data */
};
#define FRimage struct sImage

/* contains global data for a recognition algorithm, e.g. feature vectors for the
 * eigenfaces approach
 */
struct sTrainedData {
	unsigned int id;	/* unique id, i could use one algorithm more than once */
	int algorithmType;	/* which algorithm */
	BYTE *data;			/* size is not needed, this is known by the alogrithm implementation */
};
#define FRtrainedData struct sTrainedData

/* parameters for recognition, may contain several FRtrainedData entries for the various 
 * recognition methods to use
 */
struct sRecognitionParameters {
	unsigned int width;			/* width and height of faces */
	unsigned int height;
	unsigned int nextId;	/* used for unique ids for algorithm entries */
	unsigned int faceFinder;	/* id of the face finder to use or 0 if non */
	unsigned int nrAlgorithms;	/* used algorithms */
	FRtrainedData *algorithms;
};
#define FRrecognitionParameters struct sRecognitionParameters

/* used to pass parameters to an reognition or finder alogrithm */
struct sAlgoParam {
	int id; /* id of parameter, algorithm specific */
	BYTE* data;
};
#define FRalgoParam struct sAlgoParam

/* box, used by finders to return face position, defines an arbitrary rectangle */
struct sBox {
	float x1,x2,x3,x4,y1,y2,y3,y4;
};
#define FRbox struct sBox


/* --------- FUNCTIONS ----------- */
/* init */
int frInit(void);

/* image load/save */
int frImgLoadBound(FRimage* image);
int frImgLoadFile(char* filename, FRimage* image);
int frImgSaveFile(char* filename, FRimage* image);
int frImgLoadMem(void* mem, size_t sz, FRimage* image, ILenum type);
int frImgLoadRaw(void* mem, int width, int height, FRimage* image);
int frImgGetILImg(ILuint* imgnr, FRimage* image);
int frImgGetILImgFloat(ILuint* imgnr, FRimage* image);
void frImgFree(FRimage* image);
int frImgResize(FRimage* dst, FRimage* src, unsigned int w, unsigned int h);

/* recognition parameter setup */
int frRecoParamsAddAlogrithm(FRrecognitionParameters* gParms, int type, FRalgoParam* algoParms, unsigned int nrAlgoParms, FRimage* images, unsigned int nrImages);
int frRecoParamsRemoveAlgorithm(FRrecognitionParameters* gParms, unsigned int id);

/* recognition parameter serialize */
int frRecoParamsCreate(FRrecognitionParameters** gParms);
int frRecoParamsLoadFile(FILE* fileHandle, FRrecognitionParameters** gParms);
int frRecoParamsSaveFile(FILE* fileHandle, FRrecognitionParameters* gParms);
size_t frRecoParamsGetSize(FRrecognitionParameters* gParms);
int frRecoParamsSerialize(BYTE** mem, size_t maxsz, FRrecognitionParameters** gParms, BYTE direction);
void frRecoParamsFree(FRrecognitionParameters** gParms);

/* calculate traits */
int frTraitsCalc(FRrecognitionParameters* gParms, FRimage* rawImage, FRimageTrait** traits);

/* traits serialize */
int frTraitsSaveFile(FRrecognitionParameters* gParms, FILE* fileHandle, FRimageTrait* traits);
int frTraitsLoadFile(FRrecognitionParameters* gParms, FILE* fileHandle, FRimageTrait** traits);
size_t frTraitsGetSize(FRrecognitionParameters* gParms, FRimageTrait* traits);
int frTraitsSerialize(FRrecognitionParameters* gParms, BYTE** mem, size_t maxsz, FRimageTrait** traits, BYTE direction);
void frTraitsFree(FRrecognitionParameters* gParms, FRimageTrait** traits);

/* compare traits */
int frCmp(FRrecognitionParameters* parms, FRimageTrait* traits1, FRimageTrait* traits2, float* match);

/* face finder */
int frFindFaces(int finder, FRimage* image, FRbox** boxes, unsigned int* nrBoxes);
int frFindFaceAndProcess(int finder, FRimage* in, FRimage** out, unsigned int w, unsigned int h);

/* preprocessor */
int frPreprocess(int preprocessor, FRimage* in, FRimage** out, FRbox* box, int w, int h);

#endif /* __FR_H */