chiark / gitweb /
fix STRING macro
[ypp-sc-tools.db-test.git] / pctb / common.h
index 9afb083e4fc332467daaf04562ee565af8b739b9..52f57d699c4cefd959d300bc44349038d7e4e5a8 100644 (file)
@@ -1,15 +1,55 @@
+/*
+ * useful common stuff, mostly error handling and debugging
+ */
+/*
+ *  This is part of ypp-sc-tools, a set of third-party tools for assisting
+ *  players of Yohoho Puzzle Pirates.
+ * 
+ *  Copyright (C) 2009 Ian Jackson <ijackson@chiark.greenend.org.uk>
+ * 
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ * 
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ * 
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ * 
+ *  Yohoho and Puzzle Pirates are probably trademarks of Three Rings and
+ *  are used without permission.  This program is not endorsed or
+ *  sponsored by Three Rings.
+ */
 
 #ifndef COMMON_H
 #define COMMON_H
 
 #define _GNU_SOURCE
 
+#include <locale.h>
 #include <stdarg.h>
-
+#include <math.h>
+#include <stdio.h>
+#include <errno.h>
+#include <assert.h>
+#include <string.h>
+#include <stdint.h>
+#include <stdlib.h>
+#include <unistd.h>
+#include <dirent.h>
+#include <pcre.h>
+#include <inttypes.h>
+
+#include <sys/wait.h>
 #include <sys/types.h>
 
 typedef struct {
   int w,h;
+  struct RgbImage *rgb;
   char d[];
 } CanonImage;
 
@@ -25,13 +65,20 @@ typedef struct { /* both inclusive */
   Point br;
 } Rect;
 
+#define RECT_W(r) ((r).br.x - (r).tl.x + 1)
+#define RECT_H(r) ((r).br.y - (r).tl.y + 1)
+
 
 
 #define DEBUG_FLAG_LIST                                \
    DF(findypp)                                 \
    DF(pages)                                   \
    DF(rect)                                    \
+   DF(pixmap)                                  \
+   DF(struct)                                  \
    DF(ocr)                                     \
+   DF(rsync)                                   \
+   DF(structcolon)                             \
    DF(callout)
 
 enum {
@@ -53,8 +100,10 @@ void debug_flush(void);
 #define debug stderr
 
 const char *get_vardir(void);
+const char *get_libdir(void);
 
 #define FMT(f,a) __attribute__((format(printf,f,a)))
+#define SCANFMT(f,a) __attribute__((format(scanf,f,a)))
 #define NORET __attribute__((noreturn))
 
 #define DEFINE_VWRAPPERF(decls, funcf, otherattribs)                   \
@@ -84,9 +133,40 @@ void fatal(const char *fmt, ...)       FMT(1,2) NORET;
 void sysassert_fail(const char *file, int line, const char *what)
    __attribute__((noreturn));
 
+void waitpid_check_exitstatus(pid_t pid, const char *what);
+
 
 void *mmalloc(size_t sz);
 void *mrealloc(void *p, size_t sz);
 
 
+#define dbassert(x) ((x) ? (void)0 : dbfile_assertfail(__FILE__,__LINE__,#x))
+void dbfile_assertfail(const char *file, int line, const char *m) NORET;
+
+FILE *dbfile;
+void dbfile_getsline(char *lbuf, size_t lbufsz, const char *file, int line);
+int dbfile_open(const char *tpath); /* 0: ENOENT; 1: worked */
+void dbfile_close(void); /* idempotent */
+
+int dbfile_scanf(const char *fmt, ...) SCANFMT(1,2);
+int dbfile_vscanf(const char *fmt, va_list al) SCANFMT(1,0);
+
+
+char *masprintf(const char *fmt, ...) FMT(1,2);
+
+#define EXECLP_HELPER(helper, ...) do{                         \
+    char *helper_path= masprintf("%s/%s",get_libdir(),helper); \
+    execlp(helper_path,helper, __VA_ARGS__);                   \
+    sysassert(errno==ENOENT);                                  \
+    fatal("Failed to find helper program %s.\n"                        \
+         "(Are you in the correct directory?)", helper);       \
+  }while(0)
+
+
+#define ARRAYSIZE(a) ((sizeof((a)) / sizeof((a)[0])))
+#define FILLZERO(obj) (memset(&(obj),0,sizeof((obj))))
+
+#define STRING2(x) #x
+#define STRING(x) STRING2(x)
+
 #endif /*COMMON_H*/