Jeremy White : twain_32: Remove obsolete README files.

Alexandre Julliard julliard at winehq.org
Mon Mar 9 09:40:39 CDT 2009


Module: wine
Branch: master
Commit: 7a0a5c746fda38f6215053eef983088083ee9f0c
URL:    http://source.winehq.org/git/wine.git/?a=commit;h=7a0a5c746fda38f6215053eef983088083ee9f0c

Author: Jeremy White <jwhite at codeweavers.com>
Date:   Fri Mar  6 10:53:56 2009 -0600

twain_32: Remove obsolete README files.

---

 dlls/twain_32/README |   54 ----------------
 dlls/twain_32/TWAIN  |  172 --------------------------------------------------
 2 files changed, 0 insertions(+), 226 deletions(-)

diff --git a/dlls/twain_32/README b/dlls/twain_32/README
deleted file mode 100644
index 0b75a36..0000000
--- a/dlls/twain_32/README
+++ /dev/null
@@ -1,54 +0,0 @@
------ Old Corel README, probably outdated ----------------------------------
-1. INTRODUCTION
-
-This library (twain_32.dll) is an implementation of TWAIN API for providing image acquisition devices (scanner or digital camera) support.  It uses SANE drivers as the backend and translates TWAIN API calls into SANE API calls.  Unlike the twain32 library on Windows platform, it combines the Data Source Manager and Data Sources into a single library.  Thus it is our responsiblity to provide a graphical user interface and capability negotiation, which usually are performed by data sources.
-
-
-2. WHAT'S IMPLEMENTED
-
-- Functions that dispatch operations specified by the operation triplets to the corresponding function.
-
-- All the operation triplets related to the Data Source Manager are implemented.  Appplication is able to enumerate data sources and open them.
-
-- The operation triplets that deal with the UI (such as DG_CONTROL/DAT_USERINTERFACE/MSG_ENABLEDS, MSG_DISABLEDS and MSG_ENABLEDSUIONLY) are partially implemented although it does not really do much.
-
-- The operation triplets that deal with native image transfers (DG_IMAGE/DAT_IMAGENATIVEXFER/MSG_GET) are also partially implemented.  Still need to figure out how to convert the image data obtained from sane to the Windows DIB format.
-
--  Only the CAP_ICAPXFERMECH capability is implemented.
-
-
-3. TO-DO
-
-- Image native transfer is not working correctly right now.  It crashed the application due to the invalid DIB created.  We need to fix this.
-
-- Implement other image transfer mode such as file transfer and memory transfer.
-
-- Support all required TWAIN capabilities that have not been implemented currently.  There are a fixed number of capabilities specified by the TWAIN Specification.  However, device capabilities are dynamic in SANE and there isn't a standard about the capability names.  It would be difficult to negotiate capabilities in TWAIN given that we don't know what capabilities a SANE driver would provide.  One possible solution to use a device configuration file to describe the mapping between capabilities supported by a SANE driver and those specified by TWAIN.   
-- Build a dynamic user interface that reflects the capabilities of different scanner devices.  According to the TWAIN specification, each TWAIN driver need to provide its own user interface.  However the SANE drivers do not have graphical frontends.  Building a frontend for each SANE driver is a huge task.  It is possible to have a dynamic frontend similar to xscanimage or xsane that works for all the devices.  This is possibly the most difficult part. 
-
-- check into legal issues regarding:
-  - TWAIN header file
-  - linking to SANE (maybe should dynamically link at run time?)
-
-- add autoconf rules for enabling based on whether sane is installed
-
-4. FILE LISTING
-
-twain32_main.c          Functions to regconize operation tripets and dispatch
-                        the requests to the corresponding functions.
-dsm_ctrl.c		Implementation of DG_CONTROL group operation triplets
-                        destinated for source manager.
-ds_ctrl.c               Implementation of DG_CONTROL group operation triplets
-                        destinated for data source.
-ds_image.c              Implementation of DG_IMAGE group operation triplets
-                        destinated for data source.
-ds_audio.c              Implementation of DG_AUDIO group operation triplets
-                        destinated for data source
-capability.c            Functions for negotiating capabilities
-twain.h			The original TWAIN header file
-twain_i.h		Header file for the internal twain functions	
-
-
---
-Shi Quan He
-shiquan at cyberdude.com
diff --git a/dlls/twain_32/TWAIN b/dlls/twain_32/TWAIN
deleted file mode 100644
index b89f6be..0000000
--- a/dlls/twain_32/TWAIN
+++ /dev/null
@@ -1,172 +0,0 @@
-Requirements to be a TWAIN-Compliant Source
-Requirements
-TWAIN-compliant Sources must support the following:
-Operations
-----------
-DG_CONTROL / DAT_CAPABILITY / MSG_GET
-DG_CONTROL / DAT_CAPABILITY / MSG_GETCURRENT
-DG_CONTROL / DAT_CAPABILITY / MSG_GETDEFAULT
-DG_CONTROL / DAT_CAPABILITY / MSG_RESET
-DG_CONTROL / DAT_CAPABILITY / MSG_SET
-DG_CONTROL / DAT_EVENT / MSG_PROCESSEVENT
-DG_CONTROL / DAT_IDENTITY / MSG_GET
-DG_CONTROL / DAT_IDENTITY / MSG_OPENDS
-DG_CONTROL / DAT_IDENTITY / MSG_CLOSEDS
-DG_CONTROL / DAT_PENDINGXFERS / MSG_ENDXFER
-DG_CONTROL / DAT_PENDINGXFERS / MSG_GET
-DG_CONTROL / DAT_PENDINGXFERS / MSG_RESET
-DG_CONTROL / DAT_SETUPMEMXFER / MSG_GET
-DG_CONTROL / DAT_STATUS / MSG_GET
-DG_CONTROL / DAT_USERINTERFACE / MSG_DISABLEDS
-DG_CONTROL / DAT_USERINTERFACE / MSG_ENABLEDS
-DG_CONTROL / DAT_XFERGROUP / MSG_GET
-DG_IMAGE / DAT_IMAGEINFO / MSG_GET
-DG_IMAGE / DAT_IMAGELAYOUT / MSG_GET
-DG_IMAGE / DAT_IMAGELAYOUT / MSG_GETDEFAULT
-DG_IMAGE / DAT_IMAGELAYOUT / MSG_RESET
-DG_IMAGE / DAT_IMAGELAYOUT / MSG_SET
-DG_IMAGE / DAT_IMAGEMEMXFER / MSG_GET
-DG_IMAGE / DAT_IMAGENATIVEXFER / MSG_GET
-
-Capabilities
-------------
-Every Source must support all five DG_CONTROL / DAT_CAPABILITY operations on:
-CAP_XFERCOUNT
-Every Source must support DG_CONTROL / DAT_CAPABILITY MSG_GET on:
-CAP_SUPPORTEDCAPS
-CAP_UICONTROLLABLE
-Sources that supply image information must support DG_CONTROL / DAT_CAPABILITY /
-MSG_GET, MSG_GETCURRENT, MSG_GETDEFAULT on:
-ICAP_COMPRESSION
-ICAP_PLANARCHUNKY
-ICAP_PHYSICALHEIGHT
-ICAP_PHYSICALWIDTH
-ICAP_PIXELFLAVOR
-Sources that supply image information must support DG_CONTROL / DAT_CAPABILITY /
-MSG_GET, MSG_GETCURRENT, MSG_GETDEFAULT, MSG_RESET and MSG_SET on:
-ICAP_BITDEPTH
-ICAP_BITORDER
-ICAP_PIXELTYPE
-ICAP_UNITS
-ICAP_XFERMECH
-ICAP_XRESOLUTION
-ICAP_YRESOLUTION
-All Sources must implement the advertised features supported by their devices. They must
-make these features available to applications via the TWAIN protocol. For example, a Source
-that's connected to a device that has an ADF must support DG_CONTROL /
-DAT_CAPABILITY / MSG_GET, MSG_GETCURRENT, MSG_GETDEFAULT on:
-CAP_FEEDERENABLED
-CAP_FEEDERLOADED
-and DG_CONTROL / DAT_CAPABILITY / MSG_GET, MSG_GETCURRENT,
-MSG_GETDEFAULT, MSG_RESET and MSG_SET on:
-CAP_AUTOFEED
-If the ADF also supports ejecting and rewinding of pages then the Source should also support
-DG_CONTROL / DAT_CAPABILITY / MSG_GET, MSG_GETCURRENT,
-MSG_GETDEFAULT, MSG_RESET and MSG_SET on:
-CAP_CLEARPAGE
-CAP_REWINDPAGE
-
-
-*******************************************************************************
-
-From Application to Source Manager (Control Information)
-
-Data Group		Data Argument Type	Message
-DG_CONTROL		DAT_IDENTITY 		MSG_CLOSEDS
-						MSG_GETDEFAULT
-						MSG_GETFIRST
-						MSG_GETNEXT
-						MSG_OPENDS
-						MSG_USERSELECT
-DG_CONTROL		DAT_PARENT		MSG_CLOSEDSM
-						MSG_OPENDSM
-DG_CONTROL		DAT_STATUS		MSG_GET
-
-From Application to Source (Control Information)
-Data Group		Data Argument Type 	Message
-DG_CONTROL		DAT_CAPABILITY		MSG_GET
-						MSG_GETCURRENT
-						MSG_GETDEFAULT
-						MSG_QUERYSUPPORT
-						MSG_RESET
-						MSG_SET
-DG_CONTROL		DAT_CUSTOMDSDATA	MSG_GET
-						MSG_SET
-DG_CONTROL		DAT_FILESYSTEM		MSG_AUTOMATICCAPTURE
-						DIRECTORY
-						MSG_CHANGEDIRECTORY
-						MSG_COPY
-						MSG_CREATEDIRECTORY
-						MSG_DELETE
-						MSG_FORMATMEDIA
-						MSG_GETCLOSE
-						MSG_GETFIRSTFILE
-						MSG_GETINFO
-						MSG_GETNEXTFILE
-						MSG_RENAME
-DG_CONTROL		DAT_EVENT		MSG_PROCESSEVENT
-DG_CONTROL		DAT_PASSTHRU		MSG_PASSTHRU
-DG_CONTROL		DAT_PENDINGXFERS	MSG_ENDXFER
-						MSG_GET
-						MSG_RESET
-						MSG_STOPFEEDER
-DG_CONTROL		DAT_SETUPFILEXFER	MSG_GET
-						MSG_GETDEFAULT
-						MSG_RESET
-						MSG_SET
-DG_CONTROL		DAT_SETUPFILEXFER2	MSG_GET
-						MSG_GETDEFAULT
-						MSG_RESET
-						MSG_SET
-DG_CONTROL		DAT_SETUPMEMXFER	MSG_GET
-DG_CONTROL		DAT_STATUS		MSG_GET
-DG_CONTROL		DAT_USERINTERFACE	MSG_DISABLEDS
-						MSG_ENABLEDS
-						MSG_ENABLEDSUIONLY
-DG_CONTROL		DAT_XFERGROUP		MSG_GET
-						MSG_SET
-
-From Application to Source (Image Information)
-Data Group		Data Argument Type	Message
-DG_IMAGE		DAT_CIECOLOR		MSG_GET
-DG_IMAGE		DAT_EXTIMAGEINFO	MSG_GET
-DG_IMAGE		DAT_GRAYRESPONSE	MSG_RESET
-						MSG_SET
-DG_IMAGE		DAT_IMAGEFILEXFER	MSG_GET
-DG_IMAGE		DAT_IMAGEINFO		MSG_GET
-DG_IMAGE		DAT_IMAGELAYOUT		MSG_GET
-						MSG_GETDEFAULT
-						MSG_RESET
-						MSG_SET
-DG_IMAGE		DAT_IMAGEMEMXFER	MSG_GET
-DG_IMAGE		DAT_IMAGENATIVEXFER	MSG_GET
-DG_IMAGE		DAT_JPEGCOMPRESSION	MSG_GET
-						MSG_GETDEFAULT
-						MSG_RESET
-						MSG_SET
-DG_IMAGE		DAT_PALETTE8		MSG_GET
-						MSG_GETDEFAULT
-						MSG_RESET
-						MSG_SET
-DG_IMAGE		DAT_RGBRESPONSE		MSG_RESET
-						MSG_SET
-
-From Application to Source (Audio Information)
-Data Group		Data Argument Type	Message
-DG_AUDIO		DAT_AUDIOFILEXFER	MSG_GET
-DG_AUDIO		DAT_AUDIOINFO		MSG_GET
-DG_AUDIO		DAT_AUDIONATIVEXFER	MSG_GET
-
-From Source Manager to Source (Control Information)
-Data Group		Data Argument Type	Message
-DG_CONTROL		DAT_IDENTITY		MSG_CLOSEDS
-						MSG_GET
-						MSG_OPENDS
-
-From Source to Application (Control Information via the Source Manager)
-(Used by Windows Sources only)
-Data Group		Data Argument Type	Message
-DG_CONTROL		DAT_NULL		MSG_CLOSEDSOK
-						MSG_CLOSEDSREQ
-						MSG_DEVICEEVENT
-						MSG_XFERREADY




More information about the wine-cvs mailing list