matchdefs.h

Go to the documentation of this file.

/******************************************************************************
 ** Filename:    matchdefs.h
 ** Purpose:     Generic interface definitions for feature matchers.
 ** Author:      Dan Johnson
 **
 ** (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 MATCHDEFS_H
#define MATCHDEFS_H
 
#include <cstdio>
#include <tesseract/unichar.h>
 
/* define the maximum number of classes defined for any matcher
  and the maximum class id for any matcher. This must be changed
  if more different classes need to be classified */
#define MAX_NUM_CLASSES   INT16_MAX
#define MAX_CLASS_ID    (MAX_NUM_CLASSES - 1)
 
using CLASS_ID = UNICHAR_ID;
#define NO_CLASS      (0)
 
using PROTO_ID = int16_t;
#define NO_PROTO  (-1)
 
using FEATURE_ID = uint8_t;
#define NO_FEATURE      255
#define NOISE_FEATURE   254
#define MISSING_PROTO   254
#define MAX_NUM_FEAT    40
#define MAX_FEATURE_ID    250
 
using RATING = float;
 
using CERTAINTY = float;
 
typedef struct
{
  CLASS_ID Class;
  RATING Rating;
  CERTAINTY Certainty;
}
 
 
MATCH_RESULT;
 
typedef MATCH_RESULT SORTED_CLASSES[MAX_CLASS_ID + 1];
 
/*----------------------------------------------------------------------------
          Public Function Prototypes
----------------------------------------------------------------------------*/
/* misc test functions for proto id's and feature id's */
#define IsValidFeature(Fid) ((Fid) < MAX_FEATURE_ID)
#define IsValidProto(Pid) ((Pid) >= 0)
 
#if defined(__STDC__) || defined(__cplusplus)
# define _ARGS(s) s
#else
# define _ARGS(s) ()
#endif
 
/* matchdefs.c */
int CompareMatchResults
_ARGS ((MATCH_RESULT * Result1, MATCH_RESULT * Result2));
 
void PrintMatchResult _ARGS ((FILE * File, MATCH_RESULT * MatchResult));
 
void PrintMatchResults
_ARGS ((FILE * File, int N, MATCH_RESULT MatchResults[]));
 
#undef _ARGS
 
/*----------------------------------------------------------------------------
        Global Data Definitions and Declarations
----------------------------------------------------------------------------*/
#endif