Difference between revisions of "Education Project/Effort/Improve Scanner Use"

From Apache OpenOffice Wiki
Jump to: navigation, search
Line 67: Line 67:
  
 
*
 
*
 +
 +
== Current design in OpenOffice.org ==
 +
 +
scaner.cxx: uses libsane (3rd part library, must be installed separately). All system calls in libscn extension, are using SANE macros constants, while Apple does provide Twain blob for all scanners.
 +
 +
grid.*  : defines the look of the dialog box + the implementation.
 +
 +
To be done:  thre is an existing Image Capture device, using Twain on Mac OS X. The idea is to bind with Image Capture device instead of the heavy SANE thing.
 +
 +
The Apple Image Capture SDK does contain code sample ( Model View Controler paradigm in objective C ( to be modified in objc++ )
 +
 +
== Code documentation ==
 +
 +
 +
[http://eric.bachard.free.fr/Education/Documentation/AquaScanner/html/ extensions/source/scanner documentation]
 +
 +
-> Generated using Doxygen, made with current code (from DEV300_m0)
 +
 +
Contains: 
 +
 +
* Class description
 +
* Methods description
 +
* some diagrams (inheritance)
 +
* source code
 +
 +
 +
Does not contain :  libscn generation + build process, and Design about the Mac OS X lib
 +
 +
(FIXME )
  
 
== Dialog boxes ==  
 
== Dialog boxes ==  
Line 90: Line 119:
  
 
[http://developer.apple.com/technotes/tn2002/tn2088.html#TAN4  '''TN2088 / Twain Data Sources for Mac OS X''']
 
[http://developer.apple.com/technotes/tn2002/tn2088.html#TAN4  '''TN2088 / Twain Data Sources for Mac OS X''']
 +
 +
[http://www.twain.org/docs/TWAIN19.pdf '''PDF : How use TWAIN'''] (Direct link with a PDF)
 +
 +
[http://dl.valeuf.org/AC20/mac_addendum.pdf '''Some specification to use TWAIN with Mac OS'''] (Direct link with a pdf)
  
 
SDK :  
 
SDK :  
Line 98: Line 131:
  
 
[http://www.twain.org/docs/TWAIN2d_proposal.pdf  '''Twain 2.0 specifications (draft)''']
 
[http://www.twain.org/docs/TWAIN2d_proposal.pdf  '''Twain 2.0 specifications (draft)''']
 +
 +
==Mac port Links==
 +
 +
This work is part of http://wiki.services.openoffice.org/wiki/Mac_OS_X_Porting_-_Work_Areas/Todo%27s
 +
 +
 +
 +
[[User:Ericb|Ericb]] 23:40, 5 October 2006 (CEST)
 +
 +
 +
[[Category:Porting]]
 +
[[Category:MacOSX]]
 +
[[Category:Aqua]]

Revision as of 07:52, 29 February 2008

Draft :

Current Scanner implementation is .. hmm

Improve it is mandatory

Important Links

Sane Project

Supported devices

Mac OS X Sane

Vuescan

OpenOffice.org code location

extensions/source/scanner

[FIXME]: Twain interface should work on Mac OS X version of OpenOffice.org, and configure does accept 
--with-system-sane
--with-sane-headers 
command line options. Tests scheduled

Products built

All : scanner , scnserv

Windows( WNT) : scanwin

Other ( UNX or OS2 ) :

sane, sandlg scanunx and grid


Todo: analyse current implementation

Interface description

The complete interface is defined in (list to be confirmed ):

In OpenOffice.org source code :

offapi/com/sun/star/scanner

ScanError.idl

ScannerContext.idl

ScannerException.idl

ScannerManager.idl

XScannerManager.idl

offapi/com/sun/star/awt ( lot of references )

+Includes :

  • grid.cxx

cstdio, cmath, grid.hxx, /* stl, for ::std::sort */ algorithm ,

+ (from grid.hxx) : vcl/window.hxx, vcl/button.hxx, vcl/listbox.hxx, vcl/dialog.hxx

Current design in OpenOffice.org

scaner.cxx: uses libsane (3rd part library, must be installed separately). All system calls in libscn extension, are using SANE macros constants, while Apple does provide Twain blob for all scanners.

grid.*  : defines the look of the dialog box + the implementation.

To be done: thre is an existing Image Capture device, using Twain on Mac OS X. The idea is to bind with Image Capture device instead of the heavy SANE thing.

The Apple Image Capture SDK does contain code sample ( Model View Controler paradigm in objective C ( to be modified in objc++ )

Code documentation

extensions/source/scanner documentation

-> Generated using Doxygen, made with current code (from DEV300_m0)

Contains:

  • Class description
  • Methods description
  • some diagrams (inheritance)
  • source code


Does not contain : libscn generation + build process, and Design about the Mac OS X lib

(FIXME )

Dialog boxes

The dialog boxes are defined in :

extensions/source/scanner/sanedlg.src

extensions/source/scanner/grid.src


Implementation description

GridWindow

Mac OS X side

Links :

Accessing Hardware from Applications

Twain Mac

TN2088 / Twain Data Sources for Mac OS X

PDF : How use TWAIN (Direct link with a PDF)

Some specification to use TWAIN with Mac OS (Direct link with a pdf)

SDK :

Apple Image SDK

Other :

Twain 2.0 specifications (draft)

Mac port Links

This work is part of http://wiki.services.openoffice.org/wiki/Mac_OS_X_Porting_-_Work_Areas/Todo%27s


Ericb 23:40, 5 October 2006 (CEST)

Personal tools