mirror of
https://github.com/tesseract-ocr/tesseract.git
synced 2024-12-23 23:17:49 +08:00
425d593ebe
git-svn-id: https://tesseract-ocr.googlecode.com/svn/trunk/trunk@2 d0cd1f9f-072b-0410-8dd7-cf729c803f20
171 lines
6.7 KiB
C
171 lines
6.7 KiB
C
/******************************************************************************
|
|
** Filename: features.h
|
|
** Purpose: Generic definition of a feature.
|
|
** Author: Dan Johnson
|
|
** History: Sun May 20 10:28:30 1990, DSJ, Created.
|
|
**
|
|
** (c) Copyright Hewlett-Packard Company, 1988.
|
|
** Licensed under the Apache License, Version 2.0 (the "License");
|
|
** you may not use this file except in compliance with the License.
|
|
** You may obtain a copy of the License at
|
|
** http://www.apache.org/licenses/LICENSE-2.0
|
|
** Unless required by applicable law or agreed to in writing, software
|
|
** distributed under the License is distributed on an "AS IS" BASIS,
|
|
** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
** See the License for the specific language governing permissions and
|
|
** limitations under the License.
|
|
******************************************************************************/
|
|
#ifndef FEATURES_H
|
|
#define FEATURES_H
|
|
|
|
/**----------------------------------------------------------------------------
|
|
Include Files and Type Defines
|
|
----------------------------------------------------------------------------**/
|
|
#include "funcdefs.h"
|
|
#include "tessclas.h"
|
|
#include "fxdefs.h"
|
|
|
|
#include <stdio.h>
|
|
|
|
#undef Min
|
|
#undef Max
|
|
#define FEAT_NAME_SIZE 80
|
|
|
|
/*define trap errors which can be caused by this module*/
|
|
#define ILLEGAL_FEATURE_PARAM 1000
|
|
#define ILLEGAL_NUM_FEATURES 1001
|
|
|
|
/* A character is described by multiple sets of extracted features. Each
|
|
set contains a number of features of a particular type, for example, a
|
|
set of bays, or a set of closures, or a set of microfeatures. Each
|
|
feature consists of a number of parameters. All features within a
|
|
feature set contain the same number of parameters. All circular
|
|
parameters are required to be the first parameters in the feature.*/
|
|
|
|
typedef struct
|
|
{
|
|
struct fds *Type; /* points to description of feature type */
|
|
FLOAT32 Params[1]; /* variable size array - params for feature */
|
|
} FEATURE_STRUCT;
|
|
typedef FEATURE_STRUCT *FEATURE;
|
|
|
|
typedef struct
|
|
{
|
|
UINT16 NumFeatures; /* number of features in set */
|
|
UINT16 MaxNumFeatures; /* maximum size of feature set */
|
|
FEATURE Features[1]; /* variable size array of features */
|
|
} FEATURE_SET_STRUCT;
|
|
typedef FEATURE_SET_STRUCT *FEATURE_SET;
|
|
|
|
/* Define various function types which will be needed for "class methods"*/
|
|
typedef FEATURE (*FEAT_FUNC) ();
|
|
typedef FEATURE_SET (*FX_FUNC) (TBLOB *, LINE_STATS *);
|
|
typedef FLOAT32 (*PENALTY_FUNC) ();
|
|
|
|
typedef struct
|
|
{
|
|
INT8 Circular; /* TRUE if dimension wraps around */
|
|
INT8 NonEssential; /* TRUE if dimension not used in searches */
|
|
FLOAT32 Min; /* low end of range for circular dimensions */
|
|
FLOAT32 Max; /* high end of range for circular dimensions */
|
|
FLOAT32 Range; /* Max - Min */
|
|
FLOAT32 HalfRange; /* (Max - Min)/2 */
|
|
FLOAT32 MidRange; /* (Max + Min)/2 */
|
|
} PARAM_DESC;
|
|
|
|
typedef struct fds
|
|
{
|
|
UINT16 NumParams; /* total # of params */
|
|
UINT8 NumLinearParams; /* # of linear params */
|
|
UINT8 NumCircularParams; /* # of linear params */
|
|
UINT8 MinFeatPerChar; /* min # of feats allowed */
|
|
UINT8 MaxFeatPerChar; /* max # of feats allowed */
|
|
char LongName[FEAT_NAME_SIZE]; /* long name for feature */
|
|
char ShortName[FEAT_NAME_SIZE];/* short name for feature */
|
|
PARAM_DESC *ParamDesc; /* array - one per param */
|
|
} FEATURE_DESC_STRUCT;
|
|
/* one per feature type */
|
|
typedef FEATURE_DESC_STRUCT *FEATURE_DESC;
|
|
|
|
typedef struct fxs
|
|
{
|
|
FX_FUNC Extractor; /* func to extract features */
|
|
VOID_FUNC InitExtractorVars; /* func to init fx controls */
|
|
} FEATURE_EXT_STRUCT;
|
|
|
|
/*----------------------------------------------------------------------
|
|
Macros for defining the parameters of a new features
|
|
----------------------------------------------------------------------*/
|
|
#define StartParamDesc(Name) \
|
|
static PARAM_DESC Name[] = {
|
|
|
|
#define DefineParam(Circular, NonEssential, Min, Max) \
|
|
{Circular, NonEssential, Min, Max, \
|
|
(Max) - (Min), (((Max) - (Min))/2.0), (((Max) + (Min))/2.0)},
|
|
|
|
#define EndParamDesc };
|
|
|
|
/*----------------------------------------------------------------------
|
|
Macro for describing a new feature. The parameters of the macro
|
|
are as follows:
|
|
|
|
DefineFeature (Name, NumLinear, NumCircular,
|
|
MinFeatPerChar, MaxFeatPerChar,
|
|
LongName, ShortName, ParamName,
|
|
Extractor, Displayer,
|
|
ComputeExtraPenalty,
|
|
InitExtractor, InitExtractorVars, TweekExtractorVars)
|
|
----------------------------------------------------------------------*/
|
|
#define DefineFeature(Name, NL, NC, Min, Max, LN, SN, PN) \
|
|
FEATURE_DESC_STRUCT Name = { \
|
|
((NL) + (NC)), NL, NC, Min, Max, LN, SN, PN};
|
|
#define DefineFeatureExt(Name, E, IEV) FEATURE_EXT_STRUCT Name = {E, IEV};
|
|
|
|
/*----------------------------------------------------------------------
|
|
Macros for accessing features
|
|
----------------------------------------------------------------------*/
|
|
#define TypeOf(Feature) ((Feature)->Type)
|
|
#define ParamOf(Feature, N) ((Feature)->Params[N])
|
|
#define NumParamsIn(Feature) (TypeOf (Feature) -> NumParams)
|
|
|
|
/*----------------------------------------------------------------------
|
|
Macros for accessing feature sets
|
|
----------------------------------------------------------------------*/
|
|
#define NumFeaturesIn(Set) ((Set)->NumFeatures)
|
|
#define MaxNumFeaturesIn(Set) ((Set)->MaxNumFeatures)
|
|
#define FeatureIn(Set, N) ((Set)->Features[N])
|
|
|
|
/*----------------------------------------------------------------------
|
|
Macros for accessing feature descriptions
|
|
----------------------------------------------------------------------*/
|
|
#define ShortNameOf(FeatDesc) ((FeatDesc)->ShortName)
|
|
#define LongNameOf(FeatDesc) ((FeatDesc)->LongName)
|
|
#define ExtractUsing(FeatDesc) (*(FeatDesc)->Extractor)
|
|
#define InitFXVarsUsing(FD) (*(FD)->InitExtractorVars)
|
|
|
|
/*----------------------------------------------------------------------
|
|
Generic routines that work for all feature types
|
|
----------------------------------------------------------------------*/
|
|
BOOL8 AddFeature(FEATURE_SET FeatureSet, FEATURE Feature);
|
|
|
|
void DefaultInitFXVars();
|
|
|
|
void FreeFeature(FEATURE Feature);
|
|
|
|
void FreeFeatureSet(FEATURE_SET FeatureSet);
|
|
|
|
FEATURE NewFeature(FEATURE_DESC FeatureDesc);
|
|
|
|
FEATURE_SET NewFeatureSet(int NumFeatures);
|
|
|
|
FEATURE ReadFeature(FILE *File, FEATURE_DESC FeatureDesc);
|
|
|
|
FEATURE_SET ReadFeatureSet(FILE *File, FEATURE_DESC FeatureDesc);
|
|
|
|
void WriteFeature(FILE *File, FEATURE Feature);
|
|
|
|
void WriteFeatureSet(FILE *File, FEATURE_SET FeatureSet);
|
|
|
|
void WriteOldParamDesc(FILE *File, FEATURE_DESC FeatureDesc);
|
|
#endif
|