diff options
Diffstat (limited to 'backend/sharp.h')
| -rw-r--r-- | backend/sharp.h | 462 |
1 files changed, 462 insertions, 0 deletions
diff --git a/backend/sharp.h b/backend/sharp.h new file mode 100644 index 0000000..6797224 --- /dev/null +++ b/backend/sharp.h @@ -0,0 +1,462 @@ +/* sane - Scanner Access Now Easy. + + Copyright (C) 1998, 1999 Kazuya Fukuda, Abel Deuring + + This file is part of the SANE package. + + 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 2 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, write to the Free Software + Foundation, Inc., 59 Temple Place - Suite 330, Boston, + MA 02111-1307, USA. + + As a special exception, the authors of SANE give permission for + additional uses of the libraries contained in this release of SANE. + + The exception is that, if you link a SANE library with other files + to produce an executable, this does not by itself cause the + resulting executable to be covered by the GNU General Public + License. Your use of that executable is in no way restricted on + account of linking the SANE library code into it. + + This exception does not, however, invalidate any other reasons why + the executable file might be covered by the GNU General Public + License. + + If you submit changes to SANE to the maintainers to be included in + a subsequent release, you agree by submitting the changes that + those changes may be distributed with this exception intact. + + If you write modifications of your own for SANE, it is your choice + whether to permit this exception to apply to your modifications. + If you do not wish that, delete this exception notice. */ + +#ifndef sharp_h +#define sharp_h 1 + +#include <sys/types.h> + +/* default values for configurable options. + Though these options are only meaningful if USE_FORK is defined, + they are + DEFAULT_BUFFERS: number of buffers allocated as shared memory + for the data transfer from reader_process to + read_data. The minimum value is 2 + DEFAULT_BUFSIZE: default size of one buffer. Must be greater + than zero. + DEFAULT_QUEUED_READS: number of read requests queued by + sanei_scsi_req_enter. Since queued read requests + are currently only supported for Linux and + DomainOS, this value should automatically be set + dependent on the target OS... + For Linux, 2 is the optimum; for DomainOS, I + don't have any recommendation; other OS + should use the value zero. + + The value for DEFAULT_BUFSIZE is probably too Linux-oriented... +*/ + +#define DEFAULT_BUFFERS 12 +#define DEFAULT_BUFSIZE 128 * 1024 +#define DEFAULT_QUEUED_READS 2 + +typedef enum + { + OPT_NUM_OPTS = 0, + + OPT_MODE_GROUP, + OPT_MODE, + OPT_HALFTONE, + OPT_PAPER, + OPT_SCANSOURCE, + OPT_GAMMA, +#ifdef USE_CUSTOM_GAMMA + OPT_CUSTOM_GAMMA, +#endif + OPT_SPEED, + + OPT_RESOLUTION_GROUP, +#ifdef USE_RESOLUTION_LIST + OPT_RESOLUTION_LIST, +#endif + OPT_X_RESOLUTION, +#ifdef USE_SEPARATE_Y_RESOLUTION + OPT_Y_RESOLUTION, +#endif + + OPT_GEOMETRY_GROUP, + OPT_TL_X, /* top-left x */ + OPT_TL_Y, /* top-left y */ + OPT_BR_X, /* bottom-right x */ + OPT_BR_Y, /* bottom-right y */ + + OPT_ENHANCEMENT_GROUP, + OPT_EDGE_EMPHASIS, + OPT_THRESHOLD, +#ifdef USE_COLOR_THRESHOLD + OPT_THRESHOLD_R, + OPT_THRESHOLD_G, + OPT_THRESHOLD_B, +#endif + OPT_LIGHTCOLOR, + OPT_PREVIEW, + +#ifdef USE_CUSTOM_GAMMA + OPT_GAMMA_VECTOR, + OPT_GAMMA_VECTOR_R, + OPT_GAMMA_VECTOR_G, + OPT_GAMMA_VECTOR_B, +#endif + /* must come last: */ + NUM_OPTIONS + } +SHARP_Option; + +#ifdef USE_FORK + +/* status defines for a buffer: + buffer not used / read request queued / buffer contains data +*/ +#define SHM_EMPTY 0 +#define SHM_BUSY 1 +#define SHM_FULL 2 +typedef struct SHARP_shmem_ctl + { + int shm_status; /* can be SHM_EMPTY, SHM_BUSY, SHM_FULL */ + size_t used; /* number of bytes successfully read from scanner */ + size_t nreq; /* number of bytes requested from scanner */ + size_t start; /* index of the begin of used area of the buffer */ + void *qid; + SANE_Byte *buffer; + } +SHARP_shmem_ctl; + +typedef struct SHARP_rdr_ctl + { + int cancel; /* 1 = flag for the reader process to cancel */ + int running; /* 1 indicates that the reader process is alive */ + SANE_Status status; /* return status of the reader process */ + SHARP_shmem_ctl *buf_ctl; + } +SHARP_rdr_ctl; +#endif /* USE_FORK */ + +typedef enum + { + /* JX250, JX330, JX350, JX610 are used as array indices, so the + corresponding numbers should start at 0 + */ + unknown = -1, + JX250, + JX320, + JX330, + JX350, + JX610 + } +SHARP_Model; + +typedef struct SHARP_Info + { + SANE_Range xres_range; + SANE_Range yres_range; + SANE_Range tl_x_ranges[3]; /* normal / FSU / ADF */ + SANE_Range br_x_ranges[3]; /* normal / FSU / ADF */ + SANE_Range tl_y_ranges[3]; /* normal / FSU / ADF */ + SANE_Range br_y_ranges[3]; /* normal / FSU / ADF */ + SANE_Range threshold_range; + + SANE_Int xres_default; + SANE_Int yres_default; + SANE_Int x_default; + SANE_Int y_default; + SANE_Int bmu; + SANE_Int mud; + SANE_Int adf_fsu_installed; + SANE_String_Const scansources[5]; + size_t buffers; + size_t bufsize; + int wanted_bufsize; + size_t queued_reads; + int complain_on_errors; + /* default scan mode: + -1 -> "automatic": Use the ADF, if installed, + else use the FSU, if installed. + or: SCAN_ADF, SCAN_FSU, SCAN_SIMPLE + */ + int default_scan_mode; + } +SHARP_Info; + +#define COMPLAIN_ON_FSU_ERROR 2 +#define COMPLAIN_ON_ADF_ERROR 1 +typedef struct SHARP_Sense_Data + { + SHARP_Model model; + /* flag, if conditions like "paper jam" or "cover open" + are considered as an error. Should be 0 for attach, else + a frontend might refuse to start, if the scanner returns + these errors. + */ + int complain_on_errors; + /* Linux returns only 16 bytes of sense data... */ + u_char sb[16]; + } +SHARP_Sense_Data; + +typedef struct SHARP_Device + { + struct SHARP_Device *next; + SANE_Device sane; + SHARP_Info info; + /* xxx now part of sense data SHARP_Model model; */ + SHARP_Sense_Data sensedat; + } +SHARP_Device; + +typedef struct SHARP_New_Device + { + struct SHARP_Device *dev; + struct SHARP_New_Device *next; + } +SHARP_New_Device; + +typedef struct SHARP_Scanner + { + struct SHARP_Scanner *next; + int fd; + SHARP_Device *dev; + SANE_Option_Descriptor opt[NUM_OPTIONS]; + Option_Value val[NUM_OPTIONS]; + SANE_Parameters params; + + int get_params_called; + SANE_Byte *buffer; /* for color data re-ordering, required for JX 250 */ + SANE_Int buf_used; + SANE_Int buf_pos; + SANE_Int modes; + SANE_Int xres; + SANE_Int yres; + SANE_Int ulx; + SANE_Int uly; + SANE_Int width; + SANE_Int length; + SANE_Int threshold; + SANE_Int image_composition; + SANE_Int bpp; + SANE_Int halftone; + SANE_Bool reverse; + SANE_Bool speed; + SANE_Int gamma; + SANE_Int edge; + SANE_Int lightcolor; + SANE_Int adf_fsu_mode; /* mode selected by user */ + SANE_Int adf_scan; /* flag, if the actual scan is an ADF scan */ + + size_t bytes_to_read; + size_t max_lines_to_read; + size_t unscanned_lines; + SANE_Bool scanning; + SANE_Bool busy; + SANE_Bool cancel; +#ifdef USE_CUSTOM_GAMMA + SANE_Int gamma_table[4][256]; +#endif +#ifdef USE_FORK + pid_t reader_pid; + SHARP_rdr_ctl *rdr_ctl; + int shmid; + size_t read_buff; /* index of the buffer actually used by read_data */ +#endif /* USE_FORK */ + } +SHARP_Scanner; + +typedef struct SHARP_Send +{ + SANE_Int dtc; + SANE_Int dtq; + SANE_Int length; + SANE_Byte *data; +} +SHARP_Send; + +typedef struct WPDH +{ + u_char wpdh[6]; + u_char wdl[2]; +} +WPDH; + +typedef struct WDB +{ + SANE_Byte wid; + SANE_Byte autobit; + SANE_Byte x_res[2]; + SANE_Byte y_res[2]; + + SANE_Byte x_ul[4]; + SANE_Byte y_ul[4]; + SANE_Byte width[4]; + SANE_Byte length[4]; + + SANE_Byte brightness; + SANE_Byte threshold; + SANE_Byte null_1; + + SANE_Byte image_composition; + SANE_Byte bpp; + + SANE_Byte ht_pattern[2]; + SANE_Byte rif_padding; + SANE_Byte null_2[4]; + SANE_Byte null_3[6]; + SANE_Byte eletu; + SANE_Byte zooming_x[2]; + SANE_Byte zooming_y[2]; + SANE_Byte lightness_r[2]; + SANE_Byte lightness_g[2]; + SANE_Byte lightness_b[2]; + SANE_Byte lightness_bw[2]; + +} +WDB; + +/* "extension" of the window descriptor block for the JX 330 */ +typedef struct WDBX330 + { + SANE_Byte moire_reduction[2]; + } +WDBX330; + +/* "extension" of the window descriptor block for the JX 250 */ +typedef struct XWDBX250 + { + SANE_Byte threshold_red; + SANE_Byte threshold_green; + SANE_Byte threshold_blue; + SANE_Byte draft; + SANE_Byte scanning_time[4]; + SANE_Byte fixed_gamma; + SANE_Byte x_axis_res_qualifier[2]; + SANE_Byte y_axis_res_qualifier[2]; + } +WDBX250; + +typedef struct window_param +{ + WPDH wpdh; + WDB wdb; + WDBX330 wdbx330; + WDBX250 wdbx250; +} +window_param; + +typedef struct mode_sense_param +{ + SANE_Byte mode_data_length; + SANE_Byte mode_param_header2; + SANE_Byte mode_param_header3; + SANE_Byte mode_desciptor_length; + SANE_Byte resereved[5]; + SANE_Byte blocklength[3]; + SANE_Byte page_code; + SANE_Byte page_length; /* 6 */ + SANE_Byte bmu; + SANE_Byte res2; + SANE_Byte mud[2]; + SANE_Byte res3; + SANE_Byte res4; +} +mode_sense_param; + +typedef struct mode_sense_subdevice +{ + /* This definition reflects the JX250. The JX330 would need a slightly + different definition, but the bytes used right now (for ADF and FSU) + are identical. + */ + SANE_Byte mode_data_length; + SANE_Byte mode_param_header2; + SANE_Byte mode_param_header3; + SANE_Byte mode_desciptor_length; + SANE_Byte res1[5]; + SANE_Byte blocklength[3]; + SANE_Byte page_code; + SANE_Byte page_length; /* 0x1a */ + SANE_Byte a_mode_type; + SANE_Byte f_mode_type; + SANE_Byte res2; + SANE_Byte max_x[4]; + SANE_Byte max_y[4]; + SANE_Byte res3[2]; + SANE_Byte x_basic_resolution[2]; + SANE_Byte y_basic_resolution[2]; + SANE_Byte x_max_resolution[2]; + SANE_Byte y_max_resolution[2]; + SANE_Byte x_min_resolution[2]; + SANE_Byte y_min_resolution[2]; + SANE_Byte res4; +} +mode_sense_subdevice; + +typedef struct mode_select_param +{ + SANE_Byte mode_param_header1; + SANE_Byte mode_param_header2; + SANE_Byte mode_param_header3; + SANE_Byte mode_param_header4; + SANE_Byte page_code; + SANE_Byte page_length; /* 6 */ + SANE_Byte res1; + SANE_Byte res2; + SANE_Byte mud[2]; + SANE_Byte res3; + SANE_Byte res4; +} +mode_select_param; + +typedef struct mode_select_subdevice +{ + SANE_Byte mode_param_header1; + SANE_Byte mode_param_header2; + SANE_Byte mode_param_header3; + SANE_Byte mode_param_header4; + SANE_Byte page_code; + SANE_Byte page_length; /* 0x1A */ + SANE_Byte a_mode; + SANE_Byte f_mode; + SANE_Byte res[24]; +} +mode_select_subdevice; + +/* SCSI commands */ +#define TEST_UNIT_READY 0x00 +#define REQUEST_SENSE 0x03 +#define INQUIRY 0x12 +#define MODE_SELECT6 0x15 +#define RESERVE_UNIT 0x16 +#define RELEASE_UNIT 0x17 +#define MODE_SENSE6 0x1a +#define SCAN 0x1b +#define SEND_DIAGNOSTIC 0x1d +#define SET_WINDOW 0x24 +#define GET_WINDOW 0x25 +#define READ 0x28 +#define SEND 0x2a +#define OBJECT_POSITION 0x31 + +#define SENSE_LEN 18 +#define INQUIRY_LEN 36 +#define MODEPARAM_LEN 12 +#define MODE_SUBDEV_LEN 32 +#define WINDOW_LEN 76 + +#endif /* not sharp_h */ |