diff options
author | Jörg Frings-Fürst <debian@jff-webhosting.net> | 2014-10-06 14:00:40 +0200 |
---|---|---|
committer | Jörg Frings-Fürst <debian@jff-webhosting.net> | 2014-10-06 14:00:40 +0200 |
commit | 6e9c41a892ed0e0da326e0278b3221ce3f5713b8 (patch) | |
tree | 2e301d871bbeeb44aa57ff9cc070fcf3be484487 /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.h | 197 |
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 */ |