kopia lustrzana https://gitlab.com/sane-project/backends
305 wiersze
7.3 KiB
C
305 wiersze
7.3 KiB
C
/** @file u12-scanner.h
|
|
* @brief Definitions for the devices.
|
|
*
|
|
* Copyright (c) 2003-2004 Gerhard Jaeger <gerhard@gjaeger.de>
|
|
*
|
|
* History:
|
|
* - 0.01 - initial version
|
|
* - 0.02 - removed useless stuff
|
|
* .
|
|
* <hr>
|
|
* 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, see <https://www.gnu.org/licenses/>.
|
|
*
|
|
* 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.
|
|
* <hr>
|
|
*/
|
|
#ifndef __U12_SCANNER_H__
|
|
#define __U12_SCANNER_H__
|
|
|
|
/* definitions for the timer functions
|
|
*/
|
|
typedef double TimerDef;
|
|
#define _MSECOND 1000 /* based on 1 us */
|
|
#define _SECOND (1000*_MSECOND)
|
|
|
|
#if 1
|
|
#define _DO_UDELAY(usecs) u12io_udelay(usecs)
|
|
#define _DODELAY(msecs) u12io_udelay(1000*msecs)
|
|
/*{ int i; for( i = msecs; i--; ) _DO_UDELAY(1000); }*/
|
|
#else
|
|
#define _DODELAY(msecs)
|
|
#endif
|
|
|
|
/* ModuleStates */
|
|
#define _MotorInNormalState 0
|
|
#define _MotorGoBackward 1
|
|
#define _MotorInStopState 2
|
|
#define _MotorAdvancing 3
|
|
#define _MotorAdvanced 4
|
|
|
|
|
|
/** some function types
|
|
*/
|
|
typedef struct u12d *pU12_Device;
|
|
typedef struct svd *pShadingVarDef;
|
|
typedef void (*pFnVoid)(pU12_Device);
|
|
typedef void (*pFnDACOffs)(pU12_Device, pShadingVarDef, u_long);
|
|
typedef void (*pFnDACDark)(pU12_Device, pShadingVarDef, u_long, u_short);
|
|
typedef void (*pFnDataProcess)(pU12_Device, void*, void*, u_long);
|
|
typedef SANE_Bool (*pFnBool)(pU12_Device);
|
|
|
|
|
|
/* useful for RGB-values */
|
|
typedef struct {
|
|
SANE_Byte Red;
|
|
SANE_Byte Green;
|
|
SANE_Byte Blue;
|
|
} RGBByteDef;
|
|
|
|
typedef struct {
|
|
u_short Red;
|
|
u_short Green;
|
|
u_short Blue;
|
|
} RGBUShortDef;
|
|
|
|
typedef struct {
|
|
u_long Red;
|
|
u_long Green;
|
|
u_long Blue;
|
|
} RGBULongDef;
|
|
|
|
typedef union {
|
|
RGBByteDef Colors;
|
|
SANE_Byte bColors[3];
|
|
} ColorByte;
|
|
|
|
typedef union {
|
|
RGBUShortDef Colors;
|
|
u_short wColors[3];
|
|
} ColorWord;
|
|
|
|
typedef union {
|
|
SANE_Byte *pb;
|
|
u_short *pw;
|
|
u_long *pdw;
|
|
RGBUShortDef *pusrgb;
|
|
RGBULongDef *pulrgb;
|
|
RGBByteDef *pbrgb;
|
|
} DataPointer;
|
|
|
|
typedef struct
|
|
{
|
|
union {
|
|
SANE_Byte *bp;
|
|
u_short *usp;
|
|
u_long *ulp;
|
|
} red;
|
|
union {
|
|
SANE_Byte *bp;
|
|
u_short *usp;
|
|
u_long *ulp;
|
|
} green;
|
|
union {
|
|
SANE_Byte *bp;
|
|
u_short *usp;
|
|
u_long *ulp;
|
|
} blue;
|
|
|
|
} RBGPtrDef;
|
|
|
|
typedef struct {
|
|
SANE_Byte b1st;
|
|
SANE_Byte b2nd;
|
|
} WordVal;
|
|
|
|
typedef struct {
|
|
WordVal w1st;
|
|
WordVal w2nd;
|
|
} DWordVal;
|
|
|
|
|
|
typedef union {
|
|
WordVal wOverlap;
|
|
DWordVal dwOverlap;
|
|
u_long dwValue;
|
|
u_short wValue;
|
|
SANE_Byte bValue;
|
|
} DataType;
|
|
|
|
typedef struct {
|
|
u_short exposureTime;
|
|
u_short xStepTime;
|
|
} ExpXStepDef;
|
|
|
|
typedef struct {
|
|
SANE_Byte reg;
|
|
SANE_Byte val;
|
|
} RegDef;
|
|
|
|
/** for defining a point
|
|
*/
|
|
typedef struct {
|
|
u_short x;
|
|
u_short y;
|
|
} XY;
|
|
|
|
/** for defining a crop area, all is 300DPI based
|
|
*/
|
|
typedef struct {
|
|
u_short x; /**< x-pos of top-left corner */
|
|
u_short y; /**< y-pos of top-left corner */
|
|
u_short cx; /**< width */
|
|
u_short cy; /**< height */
|
|
} CropRect;
|
|
|
|
/** for defining an image
|
|
*/
|
|
typedef struct {
|
|
u_long dwFlag; /**< i.e. image source */
|
|
CropRect crArea; /**< the image size and position */
|
|
XY xyDpi; /**< the resolution */
|
|
u_short wDataType; /**< and the data type */
|
|
} ImgDef;
|
|
|
|
/**
|
|
*/
|
|
typedef struct {
|
|
u_long dwPixelsPerLine;
|
|
u_long dwBytesPerLine;
|
|
u_long dwLinesPerArea;
|
|
ImgDef image;
|
|
} CropInfo;
|
|
|
|
/** all we need for a scan
|
|
*/
|
|
typedef struct
|
|
{
|
|
u_long dwScanFlag;
|
|
double xyRatio; /**< for scaling */
|
|
u_short wYSum;
|
|
|
|
XY xyPhyDpi; /**< physical resolution of a scan */
|
|
u_long dwPhysBytesPerLine;
|
|
u_long wPhyDataType; /**< how the scanner should scan */
|
|
|
|
u_long dwAsicPixelsPerPlane;
|
|
u_long dwAsicBytesPerPlane;
|
|
u_long dwAsicBytesPerLine;
|
|
|
|
XY xyAppDpi;
|
|
u_long dwAppLinesPerArea;
|
|
u_long dwAppPixelsPerLine;
|
|
u_long dwAppPhyBytesPerLine;
|
|
u_long dwAppBytesPerLine;
|
|
u_short wAppDataType;
|
|
|
|
short siBrightness;
|
|
short siContrast;
|
|
|
|
CropRect crImage;
|
|
} DataInfo;
|
|
|
|
/** this will be our global "overkill" structure
|
|
*/
|
|
typedef struct
|
|
{
|
|
pFnDataProcess DataProcess; /* to convert RGB buffers to RGB pixels */
|
|
pFnBool DoSample;
|
|
pFnBool DataRead; /* function to get data from scanner */
|
|
|
|
long lBufferAdjust;
|
|
u_long dwScanOrigin; /* where to start the scan */
|
|
u_long negBegin; /* used while scanning in TPA modes */
|
|
u_long posBegin;
|
|
SANE_Byte bDiscardAll;
|
|
|
|
union {
|
|
u_short wGreenDiscard;
|
|
u_short wGreenKeep;
|
|
} gd_gk;
|
|
union {
|
|
u_short wBlueDiscard;
|
|
u_short wRedKeep;
|
|
} bd_rk;
|
|
|
|
u_long dpiIdx; /* index to get/set values in the table */
|
|
ExpXStepDef *negScan; /* reference to exposure/xtep table */
|
|
|
|
DataPointer p48BitBuf; /* for handling 48-bit data */
|
|
RBGPtrDef BufBegin; /* for reading/writing the scan-data */
|
|
RBGPtrDef BufEnd;
|
|
RBGPtrDef BufGet;
|
|
RBGPtrDef BufData;
|
|
RBGPtrDef BufPut;
|
|
|
|
/* motor movement stuff */
|
|
u_long dwInterval;
|
|
SANE_Bool refreshState;
|
|
SANE_Bool motorBackward;
|
|
SANE_Byte oldScanState;
|
|
SANE_Byte bRefresh;
|
|
SANE_Byte bModuleState;
|
|
SANE_Byte bNowScanState;
|
|
|
|
/* internal FIFO management */
|
|
u_long dwMinReadFifo;
|
|
u_long dwMaxReadFifo;
|
|
SANE_Byte bFifoSelect; /* defines which FIFO to use */
|
|
|
|
} ScanInfo;
|
|
|
|
/** structure for accessing one buffer in various ways...
|
|
*/
|
|
typedef struct
|
|
{
|
|
union {
|
|
SANE_Byte *pReadBuf;
|
|
SANE_Byte *pShadingMap;
|
|
u_short *pShadingRam;
|
|
DataPointer Buf;
|
|
} b1;
|
|
|
|
union {
|
|
SANE_Byte *pSumBuf;
|
|
RGBUShortDef *pSumRGB;
|
|
} b2;
|
|
|
|
DataPointer TpaBuf;
|
|
} BufferDef;
|
|
|
|
#endif /* guard __U12_SCANNER_H__ */
|
|
|
|
/* END U12-SCANNER.H ........................................................*/
|