text: /******************************************************************************
   **	Filename:    featdefs.h
   **	Purpose:     Definitions of currently defined feature types.
   **	Author:      Dan Johnson
   **	History:     Mon May 21 08:28:01 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   FEATDEFS_H
  #define   FEATDEFS_H
  
  /**----------------------------------------------------------------------------
            Include Files and Type Defines
  ----------------------------------------------------------------------------**/
  #include BOSS_TESSERACT_U_ocrfeatures_h //original-code:"ocrfeatures.h"
  
  /* Enumerate the different types of features currently defined. */
  #define NUM_FEATURE_TYPES 4
  extern const char* kMicroFeatureType;
  extern const char* kCNFeatureType;
  extern const char* kIntFeatureType;
  extern const char* kGeoFeatureType;
  
  /* define error traps which can be triggered by this module.*/
  #define ILLEGAL_SHORT_NAME  2000
  
  /* 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.*/
  
  struct CHAR_DESC_STRUCT {
    uinT32 NumFeatureSets;
    FEATURE_SET FeatureSets[NUM_FEATURE_TYPES];
  };
  typedef CHAR_DESC_STRUCT *CHAR_DESC;
  
  struct FEATURE_DEFS_STRUCT {
    inT32 NumFeatureTypes;
    const FEATURE_DESC_STRUCT* FeatureDesc[NUM_FEATURE_TYPES];
    int FeatureEnabled[NUM_FEATURE_TYPES];
  };
  typedef FEATURE_DEFS_STRUCT *FEATURE_DEFS;
  
  /*----------------------------------------------------------------------
      Generic functions for manipulating character descriptions
  ----------------------------------------------------------------------*/
  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);
  
  /**----------------------------------------------------------------------------
          Global Data Definitions and Declarations
  ----------------------------------------------------------------------------**/
  extern const FEATURE_DESC_STRUCT MicroFeatureDesc;
  extern TESS_API const FEATURE_DESC_STRUCT PicoFeatDesc;
  extern const FEATURE_DESC_STRUCT CharNormDesc;
  extern const FEATURE_DESC_STRUCT OutlineFeatDesc;
  extern const FEATURE_DESC_STRUCT IntFeatDesc;
  extern const FEATURE_DESC_STRUCT GeoFeatDesc;
  #endif
  