summaryrefslogtreecommitdiff
path: root/backend/cardscan.h
diff options
context:
space:
mode:
authorJörg Frings-Fürst <debian@jff-webhosting.net>2014-10-06 14:00:40 +0200
committerJörg Frings-Fürst <debian@jff-webhosting.net>2014-10-06 14:00:40 +0200
commit6e9c41a892ed0e0da326e0278b3221ce3f5713b8 (patch)
tree2e301d871bbeeb44aa57ff9cc070fcf3be484487 /backend/cardscan.h
Initial import of sane-backends version 1.0.24-1.2
Diffstat (limited to 'backend/cardscan.h')
-rw-r--r--backend/cardscan.h197
1 files changed, 197 insertions, 0 deletions
diff --git a/backend/cardscan.h b/backend/cardscan.h
new file mode 100644
index 0000000..a673dc6
--- /dev/null
+++ b/backend/cardscan.h
@@ -0,0 +1,197 @@
+#ifndef CARDSCAN_H
+#define CARDSCAN_H
+
+/*
+ * Part of SANE - Scanner Access Now Easy.
+ * Please see opening comment in cardscan.c
+ */
+
+/* -------------------------------------------------------------------------
+ * This option list has to contain all options for all scanners supported by
+ * this driver. If a certain scanner cannot handle a certain option, there's
+ * still the possibility to say so, later.
+ */
+enum scanner_Option
+{
+ OPT_NUM_OPTS = 0,
+
+ OPT_MODE_GROUP,
+ OPT_MODE, /*mono/gray/color*/
+
+ /* must come last: */
+ NUM_OPTIONS
+};
+
+/* values common to calib and image data */
+#define HEADER_SIZE 64
+#define PIXELS_PER_LINE 1208
+
+/* values for calib data */
+#define CAL_COLOR_SIZE (PIXELS_PER_LINE * 3)
+#define CAL_GRAY_SIZE PIXELS_PER_LINE
+
+/* values for image data */
+#define MAX_PAPERLESS_LINES 210
+
+struct scanner
+{
+ /* --------------------------------------------------------------------- */
+ /* immutable values which are set during init of scanner. */
+ struct scanner *next;
+ char *device_name; /* The name of the scanner device for sane */
+
+ /* --------------------------------------------------------------------- */
+ /* immutable values which are set during inquiry probing of the scanner. */
+ SANE_Device sane;
+ char * vendor_name;
+ char * product_name;
+
+ /* --------------------------------------------------------------------- */
+ /* immutable values which are set during reading of config file. */
+ int has_cal_buffer;
+ int lines_per_block;
+ int color_block_size;
+ int gray_block_size;
+
+ /* --------------------------------------------------------------------- */
+ /* changeable SANE_Option structs provide our interface to frontend. */
+
+ /* long array of option structs */
+ SANE_Option_Descriptor opt[NUM_OPTIONS];
+
+ /* --------------------------------------------------------------------- */
+ /* some options require lists of strings or numbers, we keep them here */
+ /* instead of in global vars so that they can differ for each scanner */
+
+ /*mode group*/
+ SANE_String_Const mode_list[3];
+
+ /* --------------------------------------------------------------------- */
+ /* changeable vars to hold user input. modified by SANE_Options above */
+
+ /*mode group*/
+ int mode; /*color,lineart,etc*/
+
+ /* --------------------------------------------------------------------- */
+ /* values which are derived from setting the options above */
+ /* the user never directly modifies these */
+
+ /* this is defined in sane spec as a struct containing:
+ SANE_Frame format;
+ SANE_Bool last_frame;
+ SANE_Int lines;
+ SANE_Int depth; ( binary=1, gray=8, color=8 (!24) )
+ SANE_Int pixels_per_line;
+ SANE_Int bytes_per_line;
+ */
+ SANE_Parameters params;
+
+ /* --------------------------------------------------------------------- */
+ /* calibration data read once */
+ unsigned char cal_color_b[CAL_COLOR_SIZE];
+ unsigned char cal_gray_b[CAL_GRAY_SIZE];
+ unsigned char cal_color_w[CAL_COLOR_SIZE];
+ unsigned char cal_gray_w[CAL_GRAY_SIZE];
+
+ /* --------------------------------------------------------------------- */
+ /* values which are set by scanning functions to keep track of pages, etc */
+ int started;
+ int paperless_lines;
+
+ /* buffer part of image */
+ unsigned char buffer[PIXELS_PER_LINE * 3 * 32];
+
+ /* how far we have read from scanner into buffer */
+ int bytes_rx;
+
+ /* how far we have written from buffer to frontend */
+ int bytes_tx;
+
+ /* --------------------------------------------------------------------- */
+ /* values used by the command and data sending function */
+ int fd; /* The scanner device file descriptor. */
+
+};
+
+#define USB_COMMAND_TIME 10000
+#define USB_DATA_TIME 10000
+
+#define MODE_COLOR 0
+#define MODE_GRAYSCALE 1
+
+/* ------------------------------------------------------------------------- */
+
+#define MM_PER_UNIT_UNFIX SANE_UNFIX(SANE_FIX(MM_PER_INCH / 1200.0))
+#define MM_PER_UNIT_FIX SANE_FIX(SANE_UNFIX(SANE_FIX(MM_PER_INCH / 1200.0)))
+
+#define SCANNER_UNIT_TO_FIXED_MM(number) SANE_FIX((number) * MM_PER_UNIT_UNFIX)
+#define FIXED_MM_TO_SCANNER_UNIT(number) SANE_UNFIX(number) / MM_PER_UNIT_UNFIX
+
+#define CONFIG_FILE "cardscan.conf"
+
+#ifndef PATH_MAX
+# define PATH_MAX 1024
+#endif
+
+/* ------------------------------------------------------------------------- */
+
+SANE_Status sane_init (SANE_Int * version_code, SANE_Auth_Callback authorize);
+
+SANE_Status sane_get_devices (const SANE_Device *** device_list,
+ SANE_Bool local_only);
+
+SANE_Status sane_open (SANE_String_Const name, SANE_Handle * handle);
+
+SANE_Status sane_set_io_mode (SANE_Handle h, SANE_Bool non_blocking);
+
+SANE_Status sane_get_select_fd (SANE_Handle h, SANE_Int * fdp);
+
+const SANE_Option_Descriptor * sane_get_option_descriptor (SANE_Handle handle,
+ SANE_Int option);
+
+SANE_Status sane_control_option (SANE_Handle handle, SANE_Int option,
+ SANE_Action action, void *val,
+ SANE_Int * info);
+
+SANE_Status sane_start (SANE_Handle handle);
+
+SANE_Status sane_get_parameters (SANE_Handle handle,
+ SANE_Parameters * params);
+
+SANE_Status sane_read (SANE_Handle handle, SANE_Byte * buf, SANE_Int max_len,
+ SANE_Int * len);
+
+void sane_cancel (SANE_Handle h);
+
+void sane_close (SANE_Handle h);
+
+void sane_exit (void);
+
+/* ------------------------------------------------------------------------- */
+
+static SANE_Status attach_one (const char *devicename);
+static SANE_Status connect_fd (struct scanner *s);
+static SANE_Status disconnect_fd (struct scanner *s);
+
+static SANE_Status
+do_cmd(struct scanner *s, int shortTime,
+ unsigned char * cmdBuff, size_t cmdLen,
+ unsigned char * outBuff, size_t outLen,
+ unsigned char * inBuff, size_t * inLen
+);
+
+static SANE_Status load_calibration (struct scanner *s);
+
+static SANE_Status heat_lamp_color(struct scanner *s);
+static SANE_Status heat_lamp_gray(struct scanner *s);
+
+static SANE_Status read_from_scanner_color(struct scanner *s);
+static SANE_Status read_from_scanner_gray(struct scanner *s);
+
+static SANE_Status power_down(struct scanner *s);
+
+static void hexdump (int level, char *comment, unsigned char *p, int l);
+
+static size_t maxStringSize (const SANE_String_Const strings[]);
+
+#endif /* CARDSCAN_H */