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

From Apache OpenOffice Wiki
Jump to: navigation, search
Line 5: Line 5:
 
Improve it is mandatory
 
Improve it is mandatory
  
====Important Links====
 
  
[http://www.sane-project.org/ Sane Project]
+
Todo: analyse current implementation
  
[http://www.sane-project.org/sane-supported-devices.html Supported devices]
+
== '''Current design in OpenOffice.org''' ==
 
+
[http://www.ellert.se/twain-sane/ Mac OS X Sane]
+
 
+
[http://www.hamrick.com/vsm.html Vuescan]
+
  
 
===OpenOffice.org code location===
 
===OpenOffice.org code location===
Line 36: Line 31:
 
sane, sandlg scanunx and grid
 
sane, sandlg scanunx and grid
  
 +
=== Code documentation ===
  
Todo: analyse current implementation
 
  
== Interface description ==
+
[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 )
 +
 
 +
 
 +
scanner.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++ )
 +
 
 +
 
 +
=== Interface description ===
 +
 
 +
==== Offapi ====
  
 
The complete interface is defined in  (list to be confirmed ):
 
The complete interface is defined in  (list to be confirmed ):
Line 67: Line 90:
  
 
*
 
*
 
+
==== Dialog boxes ====
== 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 ==  
+
  
 
The dialog boxes are defined in :
 
The dialog boxes are defined in :
Line 109: Line 102:
  
 
GridWindow
 
GridWindow
 +
 +
 +
==Important Links==
  
 
===Mac OS X side===
 
===Mac OS X side===
Line 132: Line 128:
 
[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
+
[http://www.sane-project.org/ Sane Project]
  
 +
[http://www.sane-project.org/sane-supported-devices.html Supported devices]
 +
 +
[http://www.ellert.se/twain-sane/ Mac OS X Sane]
 +
 +
[http://www.hamrick.com/vsm.html Vuescan]
 +
 +
===Mac port Links===
 +
 +
This work is part of http://wiki.services.openoffice.org/wiki/Mac_OS_X_Porting_-_Work_Areas/Todo%27s
  
  

Revision as of 08:01, 29 February 2008

Draft :

Current Scanner implementation is .. hmm

Improve it is mandatory


Todo: analyse current implementation

Current design in OpenOffice.org

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

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 )


scanner.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++ )


Interface description

Offapi

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

Dialog boxes

The dialog boxes are defined in :

extensions/source/scanner/sanedlg.src

extensions/source/scanner/grid.src


Implementation description

GridWindow


Important Links

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)


Sane Project

Supported devices

Mac OS X Sane

Vuescan

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