kopia lustrzana https://gitlab.com/sane-project/backends
				
				
				
			
		
			
				
	
	
		
			282 wiersze
		
	
	
		
			8.1 KiB
		
	
	
	
		
			C
		
	
	
			
		
		
	
	
			282 wiersze
		
	
	
		
			8.1 KiB
		
	
	
	
		
			C
		
	
	
/************************************************************************
 | 
						|
   lexmark.h - SANE library for Lexmark scanners.
 | 
						|
   Copyright (C) 2003-2004 Lexmark International, Inc. (original source)
 | 
						|
   Copyright (C) 2005 Fred Odendaal
 | 
						|
   Copyright (C) 2006-2010 Stéphane Voltz	<stef.dev@free.fr>
 | 
						|
   Copyright (C) 2010 "Torsten Houwaart" <ToHo@gmx.de> X74 support
 | 
						|
 | 
						|
   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 LEXMARK_H
 | 
						|
#define LEXMARK_H
 | 
						|
 | 
						|
#undef DEEP_DEBUG
 | 
						|
 | 
						|
#include "../include/sane/config.h"
 | 
						|
 | 
						|
#include <errno.h>
 | 
						|
#include <signal.h>
 | 
						|
#include <stdio.h>
 | 
						|
#include <stdlib.h>
 | 
						|
#include <string.h>
 | 
						|
#include <sys/types.h>
 | 
						|
#include <sys/wait.h>
 | 
						|
#include <time.h>
 | 
						|
#include <unistd.h>
 | 
						|
#include <fcntl.h>
 | 
						|
#include <ctype.h>
 | 
						|
#include <sys/time.h>
 | 
						|
 | 
						|
#include "../include/_stdint.h"
 | 
						|
#include "../include/sane/sane.h"
 | 
						|
#include "../include/sane/sanei.h"
 | 
						|
#include "../include/sane/saneopts.h"
 | 
						|
#include "../include/sane/sanei_config.h"
 | 
						|
#include "../include/sane/sanei_usb.h"
 | 
						|
#include "../include/sane/sanei_backend.h"
 | 
						|
 | 
						|
typedef enum
 | 
						|
{
 | 
						|
  OPT_NUM_OPTS = 0,
 | 
						|
  OPT_MODE,
 | 
						|
  OPT_RESOLUTION,
 | 
						|
  OPT_PREVIEW,
 | 
						|
  OPT_THRESHOLD,
 | 
						|
 | 
						|
  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 */
 | 
						|
 | 
						|
  /* manual gain handling */
 | 
						|
  OPT_MANUAL_GAIN,		/* 6 */
 | 
						|
  OPT_GRAY_GAIN,
 | 
						|
  OPT_RED_GAIN,
 | 
						|
  OPT_GREEN_GAIN,
 | 
						|
  OPT_BLUE_GAIN,
 | 
						|
 | 
						|
  /* must come last: */
 | 
						|
  NUM_OPTIONS
 | 
						|
}
 | 
						|
Lexmark_Options;
 | 
						|
 | 
						|
/*
 | 
						|
 * this struct is used to described the specific parts of each model
 | 
						|
 */
 | 
						|
typedef struct Lexmark_Model
 | 
						|
{
 | 
						|
  SANE_Int vendor_id;
 | 
						|
  SANE_Int product_id;
 | 
						|
  SANE_Byte mainboard_id;	/* matched against the content of reg B0 */
 | 
						|
  SANE_String_Const name;
 | 
						|
  SANE_String_Const vendor;
 | 
						|
  SANE_String_Const model;
 | 
						|
  SANE_Int motor_type;
 | 
						|
  SANE_Int sensor_type;
 | 
						|
  SANE_Int HomeEdgePoint1;
 | 
						|
  SANE_Int HomeEdgePoint2;
 | 
						|
} Lexmark_Model;
 | 
						|
 | 
						|
/*
 | 
						|
 * this struct is used to store per sensor model constants
 | 
						|
 */
 | 
						|
typedef struct Lexmark_Sensor
 | 
						|
{
 | 
						|
  SANE_Int id;
 | 
						|
  SANE_Int offset_startx;	/* starting x for offset calibration */
 | 
						|
  SANE_Int offset_endx;		/* end x for offset calibration */
 | 
						|
  SANE_Int offset_threshold;	/* target threshold for offset calibration */
 | 
						|
  SANE_Int xoffset;		/* number of unusable pixels on the start of the sensor */
 | 
						|
  SANE_Int default_gain;	/* value of the default gain for a scan */
 | 
						|
  SANE_Int red_gain_target;
 | 
						|
  SANE_Int green_gain_target;
 | 
						|
  SANE_Int blue_gain_target;
 | 
						|
  SANE_Int gray_gain_target;
 | 
						|
  SANE_Int red_shading_target;
 | 
						|
  SANE_Int green_shading_target;
 | 
						|
  SANE_Int blue_shading_target;
 | 
						|
  SANE_Int gray_shading_target;
 | 
						|
  SANE_Int offset_fallback;	/* offset to use in case offset calibration fails */
 | 
						|
  SANE_Int gain_fallback;	/* gain to use in case offset calibration fails */
 | 
						|
} Lexmark_Sensor;
 | 
						|
 | 
						|
typedef enum
 | 
						|
{
 | 
						|
  RED = 0,
 | 
						|
  GREEN,
 | 
						|
  BLUE
 | 
						|
}
 | 
						|
Scan_Regions;
 | 
						|
 | 
						|
/* struct to hold pre channel settings */
 | 
						|
typedef struct Channels
 | 
						|
{
 | 
						|
  SANE_Word red;
 | 
						|
  SANE_Word green;
 | 
						|
  SANE_Word blue;
 | 
						|
  SANE_Word gray;
 | 
						|
}
 | 
						|
Channels;
 | 
						|
 | 
						|
/** @name Option_Value union
 | 
						|
 * convenience union to access option values given to the backend
 | 
						|
 * @{
 | 
						|
 */
 | 
						|
#ifndef SANE_OPTION
 | 
						|
#define SANE_OPTION 1
 | 
						|
typedef union
 | 
						|
{
 | 
						|
  SANE_Bool b;
 | 
						|
  SANE_Word w;
 | 
						|
  SANE_Word *wa;		/* word array */
 | 
						|
  SANE_String s;
 | 
						|
}
 | 
						|
Option_Value;
 | 
						|
#endif
 | 
						|
/* @} */
 | 
						|
 | 
						|
typedef struct Read_Buffer
 | 
						|
{
 | 
						|
  SANE_Int gray_offset;
 | 
						|
  SANE_Int max_gray_offset;
 | 
						|
  SANE_Int region;
 | 
						|
  SANE_Int red_offset;
 | 
						|
  SANE_Int green_offset;
 | 
						|
  SANE_Int blue_offset;
 | 
						|
  SANE_Int max_red_offset;
 | 
						|
  SANE_Int max_green_offset;
 | 
						|
  SANE_Int max_blue_offset;
 | 
						|
  SANE_Byte *data;
 | 
						|
  SANE_Byte *readptr;
 | 
						|
  SANE_Byte *writeptr;
 | 
						|
  SANE_Byte *max_writeptr;
 | 
						|
  size_t size;
 | 
						|
  size_t linesize;
 | 
						|
  SANE_Bool empty;
 | 
						|
  SANE_Int image_line_no;
 | 
						|
  SANE_Int bit_counter;
 | 
						|
  SANE_Int max_lineart_offset;
 | 
						|
}
 | 
						|
Read_Buffer;
 | 
						|
 | 
						|
typedef struct Lexmark_Device
 | 
						|
{
 | 
						|
  struct Lexmark_Device *next;
 | 
						|
  SANE_Bool missing;	/**< devices has been unplugged or swtiched off */
 | 
						|
 | 
						|
  SANE_Device sane;
 | 
						|
  SANE_Option_Descriptor opt[NUM_OPTIONS];
 | 
						|
  Option_Value val[NUM_OPTIONS];
 | 
						|
  SANE_Parameters params;
 | 
						|
  SANE_Int devnum;
 | 
						|
  long data_size;
 | 
						|
  SANE_Bool initialized;
 | 
						|
  SANE_Bool eof;
 | 
						|
  SANE_Int x_dpi;
 | 
						|
  SANE_Int y_dpi;
 | 
						|
  long data_ctr;
 | 
						|
  SANE_Bool device_cancelled;
 | 
						|
  SANE_Int cancel_ctr;
 | 
						|
  SANE_Byte *transfer_buffer;
 | 
						|
  size_t bytes_read;
 | 
						|
  size_t bytes_remaining;
 | 
						|
  size_t bytes_in_buffer;
 | 
						|
  SANE_Byte *read_pointer;
 | 
						|
  Read_Buffer *read_buffer;
 | 
						|
  SANE_Byte threshold;
 | 
						|
 | 
						|
  Lexmark_Model model;		/* per model data */
 | 
						|
  Lexmark_Sensor *sensor;
 | 
						|
  SANE_Byte shadow_regs[255];	/* shadow registers */
 | 
						|
  struct Channels offset;
 | 
						|
  struct Channels gain;
 | 
						|
  float *shading_coeff;
 | 
						|
}
 | 
						|
Lexmark_Device;
 | 
						|
 | 
						|
/* Maximum transfer size */
 | 
						|
#define MAX_XFER_SIZE 0xFFC0
 | 
						|
 | 
						|
/* motors and sensors type defines */
 | 
						|
#define X1100_MOTOR	1
 | 
						|
#define A920_MOTOR	2
 | 
						|
#define X74_MOTOR	3
 | 
						|
 | 
						|
#define X1100_B2_SENSOR 4
 | 
						|
#define A920_SENSOR     5
 | 
						|
#define X1100_2C_SENSOR 6
 | 
						|
#define X1200_SENSOR    7	/* X1200 on USB 1.0 */
 | 
						|
#define X1200_USB2_SENSOR 8	/* X1200 on USB 2.0 */
 | 
						|
#define X74_SENSOR	9
 | 
						|
 | 
						|
/* Non-static Function Proto-types (called by lexmark.c) */
 | 
						|
SANE_Status sanei_lexmark_low_init (Lexmark_Device * dev);
 | 
						|
void sanei_lexmark_low_destroy (Lexmark_Device * dev);
 | 
						|
SANE_Status sanei_lexmark_low_open_device (Lexmark_Device * dev);
 | 
						|
void sanei_lexmark_low_close_device (Lexmark_Device * dev);
 | 
						|
SANE_Bool sanei_lexmark_low_search_home_fwd (Lexmark_Device * dev);
 | 
						|
void sanei_lexmark_low_move_fwd (SANE_Int distance, Lexmark_Device * dev,
 | 
						|
				 SANE_Byte * regs);
 | 
						|
SANE_Bool sanei_lexmark_low_X74_search_home (Lexmark_Device * dev,
 | 
						|
					     SANE_Byte * regs);
 | 
						|
SANE_Bool sanei_lexmark_low_search_home_bwd (Lexmark_Device * dev);
 | 
						|
SANE_Int sanei_lexmark_low_find_start_line (Lexmark_Device * dev);
 | 
						|
SANE_Status sanei_lexmark_low_set_scan_regs (Lexmark_Device * dev,
 | 
						|
					     SANE_Int resolution,
 | 
						|
					     SANE_Int offset,
 | 
						|
					     SANE_Bool calibrated);
 | 
						|
SANE_Status sanei_lexmark_low_start_scan (Lexmark_Device * dev);
 | 
						|
long sanei_lexmark_low_read_scan_data (SANE_Byte * data, SANE_Int size,
 | 
						|
				       Lexmark_Device * dev);
 | 
						|
SANE_Status sanei_lexmark_low_assign_model (Lexmark_Device * dev,
 | 
						|
					    SANE_String_Const devname,
 | 
						|
					    SANE_Int vendor, SANE_Int product,
 | 
						|
					    SANE_Byte mainboard);
 | 
						|
 | 
						|
/*
 | 
						|
 * scanner calibration functions
 | 
						|
 */
 | 
						|
SANE_Status sanei_lexmark_low_offset_calibration (Lexmark_Device * dev);
 | 
						|
SANE_Status sanei_lexmark_low_gain_calibration (Lexmark_Device * dev);
 | 
						|
SANE_Status sanei_lexmark_low_shading_calibration (Lexmark_Device * dev);
 | 
						|
SANE_Status sanei_lexmark_low_calibration (Lexmark_Device * dev);
 | 
						|
 | 
						|
#endif /* LEXMARK_H */
 |