pctb/ocr.h

   1 /*
   2  * ocr.c forms a mostly-self-contained bit
   3  * so we put its declarations in this separate file
   4  */
   5
   6 #ifndef OCR_H
   7 #define OCR_H
   8
   9
  10 #define _GNU_SOURCE
  11
  12 #include <string.h>
  13 #include <stdio.h>
  14 #include <errno.h>
  15 #include <assert.h>
  16 #include <stdint.h>
  17 #include <stdlib.h>
  18 #include <unistd.h>
  19 #include <stdarg.h>
  20 #include <inttypes.h>
  21
  22 #include <sys/types.h>
  23 #include <sys/wait.h>
  24
  25
  26 typedef struct {
  27   int w,h;
  28   char d[];
  29 } CanonImage;
  30
  31 typedef uint32_t Pixcol;
  32 #define PSPIXCOL(priscan) priscan##32
  33
  34 typedef struct {
  35   const char *s; /* valid until next call to ocr() */
  36   int l,r; /* column numbers */
  37   unsigned ctxmap; /* match context index */
  38 } OcrResultGlyph;
  39
  40
  41 typedef const struct OcrCellTypeInfo *OcrCellType;
  42 extern const struct OcrCellTypeInfo ocr_celltype_text;
  43 extern const struct OcrCellTypeInfo ocr_celltype_number;
  44
  45
  46 typedef struct OcrReader OcrReader;
  47 OcrReader *ocr_init(int h);
  48
  49 OcrResultGlyph *ocr(OcrReader *rd, OcrCellType, int w, Pixcol cols[]);
  50   /* return value is array terminated by {0,-1,-1}
  51    * array is valid until next call to ocr()
  52    */
  53
  54
  55 /*----- debugging arrangements, rather contingent -----*/
  56
  57 #define DEBUG_FLAG_LIST                         \
  58    DF(ocr)                                      \
  59    DF(rect)                                     \
  60    DF(callout)                                  \
  61    DF(pages)
  62
  63 enum {
  64 #define DF(f) dbg__shift_##f,
  65   DEBUG_FLAG_LIST
  66 #undef DF
  67 };
  68 enum {
  69 #define DF(f) dbg_##f = 1 << dbg__shift_##f,
  70   DEBUG_FLAG_LIST
  71 #undef DF
  72 };
  73
  74 unsigned debug_flags;
  75
  76 #define DEBUGP(f) (!!(debug_flags & dbg_##f))
  77
  78 void debug_flush(void);
  79
  80 #define eassert assert
  81 #define debug stderr
  82
  83 const char *get_vardir(void);
  84
  85 #define DEBUG_DEFINE_DEBUGF(f)                                          \
  86   static void vdebugf(const char *fmt, va_list al) {                    \
  87     if (DEBUGP(f))                                                      \
  88       vfprintf(debug,fmt,al);                                           \
  89   }                                                                     \
  90   static void debugf(const char *fmt, ...) {                            \
  91     va_list al;  va_start(al,fmt);  vdebugf(fmt,al);  va_end(al);       \
  92   }
  93
  94 #endif /*OCR_H*/