featdefs.h File Reference

#include "ocrfeatures.h"

Go to the source code of this file.

Classes
struct	CHAR_DESC_STRUCT
struct	FEATURE_DEFS_STRUCT

Macros
#define	NUM_FEATURE_TYPES   4
#define	ILLEGAL_SHORT_NAME   2000

Typedefs
typedef CHAR_DESC_STRUCT *	CHAR_DESC
typedef FEATURE_DEFS_STRUCT *	FEATURE_DEFS

Functions
void TESS_API	InitFeatureDefs (FEATURE_DEFS_STRUCT *featuredefs)
void	FreeCharDescription (CHAR_DESC CharDesc)
CHAR_DESC	NewCharDescription (const FEATURE_DEFS_STRUCT &FeatureDefs)
bool	ValidCharDescription (const FEATURE_DEFS_STRUCT &FeatureDefs, CHAR_DESC CharDesc)
void	WriteCharDescription (const FEATURE_DEFS_STRUCT &FeatureDefs, CHAR_DESC CharDesc, STRING *str)
CHAR_DESC TESS_API	ReadCharDescription (const FEATURE_DEFS_STRUCT &FeatureDefs, FILE *File)
int TESS_API	ShortNameToFeatureType (const FEATURE_DEFS_STRUCT &FeatureDefs, const char *ShortName)

Variables
const char *	kMicroFeatureType
const char *	kCNFeatureType
const char *	kIntFeatureType
const char *	kGeoFeatureType
const FEATURE_DESC_STRUCT	MicroFeatureDesc
TESS_API const FEATURE_DESC_STRUCT	PicoFeatDesc
const FEATURE_DESC_STRUCT	CharNormDesc
const FEATURE_DESC_STRUCT	OutlineFeatDesc
const FEATURE_DESC_STRUCT	IntFeatDesc
const FEATURE_DESC_STRUCT	GeoFeatDesc

Macro Definition Documentation

ILLEGAL_SHORT_NAME

#define ILLEGAL_SHORT_NAME   2000

Definition at line 34 of file featdefs.h.

NUM_FEATURE_TYPES

#define NUM_FEATURE_TYPES   4

---

Include Files and Type Defines

Definition at line 27 of file featdefs.h.

Typedef Documentation

CHAR_DESC

typedef CHAR_DESC_STRUCT* CHAR_DESC

Definition at line 46 of file featdefs.h.

FEATURE_DEFS

typedef FEATURE_DEFS_STRUCT* FEATURE_DEFS

Definition at line 53 of file featdefs.h.

Function Documentation

FreeCharDescription()

void FreeCharDescription

(

CHAR_DESC

CharDesc

)

Release the memory consumed by the specified character description and all of the features in that description.

Parameters

CharDesc

character description to be deallocated

Globals:

• none

Note

Exceptions: none

History: Wed May 23 13:52:19 1990, DSJ, Created.

Definition at line 141 of file featdefs.cpp.

                                             {
  int i;

  if (CharDesc) {
    for (i = 0; i < CharDesc->NumFeatureSets; i++)
      FreeFeatureSet (CharDesc->FeatureSets[i]);
    Efree(CharDesc);
  }
}                                /* FreeCharDescription */

InitFeatureDefs()

void TESS_API InitFeatureDefs

(

FEATURE_DEFS_STRUCT *

featuredefs

)

Definition at line 121 of file featdefs.cpp.

                                                       {
  featuredefs->NumFeatureTypes = NUM_FEATURE_TYPES;
  for (int i = 0; i < NUM_FEATURE_TYPES; ++i) {
    featuredefs->FeatureDesc[i] = DescDefs[i];
  }
}

NewCharDescription()

CHAR_DESC NewCharDescription

(

const FEATURE_DEFS_STRUCT &

FeatureDefs

)

Allocate a new character description, initialize its feature sets to be empty, and return it.

Globals:

• none

Returns

New character description structure.

Note

Exceptions: none

History: Wed May 23 15:27:10 1990, DSJ, Created.

Definition at line 164 of file featdefs.cpp.

                                                                     {
  CHAR_DESC CharDesc;
  int i;

  CharDesc = (CHAR_DESC) Emalloc (sizeof (CHAR_DESC_STRUCT));
  CharDesc->NumFeatureSets = FeatureDefs.NumFeatureTypes;

  for (i = 0; i < CharDesc->NumFeatureSets; i++)
    CharDesc->FeatureSets[i] = NULL;

  return (CharDesc);

}                                /* NewCharDescription */

ReadCharDescription()

CHAR_DESC TESS_API ReadCharDescription	(	const FEATURE_DEFS_STRUCT &	FeatureDefs,
		FILE *	File
	)

Read a character description from File, and return a data structure containing this information. The data is formatted as follows:

  NumberOfSets
          ShortNameForSet1 Set1
          ShortNameForSet2 Set2
          ...

Globals:

• none

Parameters

FeatureDefs	definitions of feature types/extractors
File	open text file to read character description from

Returns

Character description read from File.

Note

Exceptions:

• ILLEGAL_NUM_SETS

History: Wed May 23 17:32:48 1990, DSJ, Created.

Definition at line 263 of file featdefs.cpp.

                                          {
  int NumSetsToRead;
  char ShortName[FEAT_NAME_SIZE];
  CHAR_DESC CharDesc;
  int Type;

  if (tfscanf(File, "%d", &NumSetsToRead) != 1 ||
    NumSetsToRead < 0 || NumSetsToRead > FeatureDefs.NumFeatureTypes)
    DoError (ILLEGAL_NUM_SETS, "Illegal number of feature sets");

  CharDesc = NewCharDescription(FeatureDefs);
  for (; NumSetsToRead > 0; NumSetsToRead--) {
    tfscanf(File, "%s", ShortName);
    Type = ShortNameToFeatureType(FeatureDefs, ShortName);
    CharDesc->FeatureSets[Type] =
      ReadFeatureSet (File, FeatureDefs.FeatureDesc[Type]);
  }
  return (CharDesc);

}                                // ReadCharDescription

ShortNameToFeatureType()

int TESS_API ShortNameToFeatureType	(	const FEATURE_DEFS_STRUCT &	FeatureDefs,
		const char *	ShortName
	)

Search through all features currently defined and return the feature type for the feature with the specified short name. Trap an error if the specified name is not found.

Globals:

• none

Parameters

FeatureDefs	definitions of feature types/extractors
ShortName	short name of a feature type

Returns

Feature type which corresponds to ShortName.

Note

Exceptions:

• ILLEGAL_SHORT_NAME

History: Wed May 23 15:36:05 1990, DSJ, Created.

Definition at line 302 of file featdefs.cpp.

                                                  {
  int i;

  for (i = 0; i < FeatureDefs.NumFeatureTypes; i++)
    if (!strcmp ((FeatureDefs.FeatureDesc[i]->ShortName), ShortName))
      return (i);
  DoError (ILLEGAL_SHORT_NAME, "Illegal short name for a feature");
  return 0;

}                                // ShortNameToFeatureType

ValidCharDescription()

bool ValidCharDescription	(	const FEATURE_DEFS_STRUCT &	FeatureDefs,
		CHAR_DESC	CharDesc
	)

Definition at line 219 of file featdefs.cpp.

                                              {
  bool anything_written = false;
  bool well_formed = true;
  for (int Type = 0; Type < CharDesc->NumFeatureSets; Type++) {
    if (CharDesc->FeatureSets[Type]) {
      for (int i = 0; i < CharDesc->FeatureSets[Type]->NumFeatures; i++) {
        FEATURE feat = CharDesc->FeatureSets[Type]->Features[i];
        for (int p = 0; p < feat->Type->NumParams; p++) {
          if (isnan(feat->Params[p]) || isinf(feat->Params[p]))
            well_formed = false;
          else
            anything_written = true;
        }
      }
    } else {
      return false;
    }
  }
  return anything_written && well_formed;
}                                /* ValidCharDescription */

WriteCharDescription()

void WriteCharDescription	(	const FEATURE_DEFS_STRUCT &	FeatureDefs,
		CHAR_DESC	CharDesc,
		STRING *	str
	)

Appends a textual representation of CharDesc to str. The format used is to write out the number of feature sets which will be written followed by a representation of each feature set.

Each set starts with the short name for that feature followed by a description of the feature set. Feature sets which are not present are not written.

Parameters

FeatureDefs	definitions of feature types/extractors
str	string to append CharDesc to
CharDesc	character description to write to File

Note

Exceptions: none

History: Wed May 23 17:21:18 1990, DSJ, Created.

Definition at line 197 of file featdefs.cpp.

                                                           {
  int Type;
  int NumSetsToWrite = 0;

  for (Type = 0; Type < CharDesc->NumFeatureSets; Type++)
    if (CharDesc->FeatureSets[Type])
      NumSetsToWrite++;

  str->add_str_int(" ", NumSetsToWrite);
  *str += "\n";
  for (Type = 0; Type < CharDesc->NumFeatureSets; Type++) {
    if (CharDesc->FeatureSets[Type]) {
      *str += FeatureDefs.FeatureDesc[Type]->ShortName;
      *str += " ";
      WriteFeatureSet(CharDesc->FeatureSets[Type], str);
    }
  }
}                                /* WriteCharDescription */

Variable Documentation

CharNormDesc

const FEATURE_DESC_STRUCT CharNormDesc

GeoFeatDesc

const FEATURE_DESC_STRUCT GeoFeatDesc

IntFeatDesc

const FEATURE_DESC_STRUCT IntFeatDesc

kCNFeatureType

const char* kCNFeatureType

Definition at line 42 of file featdefs.cpp.

kGeoFeatureType

const char* kGeoFeatureType

Definition at line 44 of file featdefs.cpp.

kIntFeatureType

const char* kIntFeatureType

Definition at line 43 of file featdefs.cpp.

kMicroFeatureType

const char* kMicroFeatureType

Definition at line 41 of file featdefs.cpp.

MicroFeatureDesc

const FEATURE_DESC_STRUCT MicroFeatureDesc

---

Global Data Definitions and Declarations

OutlineFeatDesc

const FEATURE_DESC_STRUCT OutlineFeatDesc

PicoFeatDesc

TESS_API const FEATURE_DESC_STRUCT PicoFeatDesc