Planmeca Twain Interface

TWAIN INTERFACE FOR PLANMECA DEVICES

Revision 4.4.0

PLANMECA TWAIN

2014-05-12 Page 2(29)

Important Revision Changes:

2014-04-02………………………… 2014-04- 02…………………………

Planmeca_Twain_Interface.docx

ProScanner device support added + text updated

2

PLANMECA TWAIN

2014-05-12 Page 3(29)

PREFACE

TWAIN is a ‘Standard for image acquisition systems’. TWAIN specification and developer toolkit is available in www.twain.org Internet site. According to TWAIN Working Group: ‘ The three key elements in TWAIN are the application software, the Source Manager software and the Data Source software.’


3

PLANMECA TWAIN

2014-05-12 Page 4(29)

This document describes Planmeca TWAIN Source interface. At the moment the Planmeca TWAIN layer works on MS Windows and Mac OS X operation systems. (There is a separate document for Mac OS X.) Use X.) Use of TWAIN interface to capture c apture medical/dental images maybe subject to regulatory r egulatory control and it is the responsibility of the deplorer to ensure that all relevant requirements are fulfilled. Note! Dimax1 sensor is supported only if Didapi 4.1.0 or newer is used. Please send comments etc. to: Markku Hatakka Planmeca Oy Asentajakatu 6 00810 HELSINKI FINLAND

Or Email: [email protected]


4

PLANMECA TWAIN

2014-05-12 Page 5(29)

TABLE OF CONTENTS

PLANMECA TWAIN SOURCE INTERFACE

7

1.1 I NSTALLATION

7

1.2 USING OF TWAIN DATA SOURCE

9

1.2.1 Data Source Name and Supported Devices Devices

10

1.2.2 Device Control Window

11

1.2.3 DIDAPIUI DIDAPIUI Exposure Window

12

1.2.4 Planmeca ProScanner ProScanner Capture Window

15

1.2.5 Planmeca TWAIN Device Control File for DIDAPI Devices

16

1.2.6 Image Information File of DIDAPI Devices

17

1.2.7. Image Control of ProScanner ProScanner Device

20

1.2.8 Twain Log File

20

APPENDIX A. PLANMECA TWAIN SOURCE INTERFACE LAYERS

A.1 DIDAPI ACQUISITION I NTERFACE APPENDIX B. INFORMATION FLOW GRAPH

25

25 27

B.1 DIDAPI CAPTURE

27

B.2 PROSCANNER CAPTURE

28


5

PLANMECA TWAIN

2014-05-12 Page 6(29)


6

PLANMECA TWAIN

2014-05-12 Page 7(29)

Planmeca TWAIN Source Interface

This chapter describes installation, using and model of Planmeca TWAIN Data Source in MS Windows OS. Use of TWAIN interface to capture medical/dental images maybe subject to regulatory control and it is the responsibility of the deployer to ensure that all relevant requirements are fulfilled.

1.1 Installation

The installation of the Twain source interface is included in Romexis program installation DVD disk as a component in DIDAPI DIDAPI SDK installation setup program, and in DidapiKit CD. The setup program is in DVD/CD folder ‘DidapiKit\ ‘DidapiKit\Setup’. Setup’. A DLC license is needed, and it should be located in the working folder or in any system environment ‘Path’ folder. Make sure that the necessary device drivers are installed. For more information, see the installation manual of the device in question. question .


7

PLANMECA TWAIN

2014-05-12 Page 8(29)

The source ‘twaindidapisrc.ds’ file is installed into \Twain_32\Planmeca folder.


8

PLANMECA TWAIN

2014-05-12 Page 9(29)

1.2 Using of TWAIN Data Source

Any program that supports TWAIN interface, e.g. TWAIN sample program ‘Twack_32.exe’, can use in principal Planmeca TWAIN Data Source interface, but please note that the use of TWAIN interface to capture medical/dental images maybe subject to regulatory control and it is the responsibility of the deployer to ensure that all relevant requirements are fulfilled! Here TWAIN_32 Twacker application is used only for demonstration purpose!

First a Planmeca TWAIN Source is selected, e.g. File->Select File- >Select Source … This must be done only once, if only Planmeca Data Source is used every ti me the PC is started.


9

PLANMECA TWAIN

2014-05-12 Page 10(29)

1.2.1 Data Source Name and Supported Devices

Planmeca data source name is called c alled ’Planmeca Twain’.

Planmeca TWAIN supports image capturing with Planmeca 2D intraoral and extraoral X -ray devices. With Planmeca ProScanner only 1-to-1 ETH and USB modes are supported. supported .


10

PLANMECA TWAIN

2014-05-12 Page 11(29)

1.2.2 Device Control Window

Application ‘TWAIN acquire’ acquire’ command starts Planmeca Device Control, e.g. e.g. here File->Acquire … Planmeca TWAIN Source Control window is then t hen opened.

When the user presses any DIDAPI device button (IntraOral, Panoramic or Cephalo), TWAIN Source calls DIDAPIUI layer library function (see ‘DidapiUI_Interface.doc’ document) using prepre defined default values in control file in C:\ProgramData\Planmeca\didapi\PmTwain.ini’. C:\ProgramData\Planmeca\didapi\ PmTwain.ini’. See for additional information 1.2.5 Device Control File section )

When the user selects ProScanner -device, ProScanner level window and scan functions are called. The control file of ProScanner ‘ProScanner.ini’ is installed into C:\ProgramData\Planmeca\ProScanner\Config – C:\ProgramData\Planmeca\ProScanner\Config – folder. folder.


11

PLANMECA TWAIN

2014-05-12 Page 12(29)

1.2.3 DIDAPIUI Exposure Window

A DidapiUI layer exposure window is opened when any DIDAPI device button is pressed. Window will wait for the start of Planmeca device exposure in DIDAPI layer interface. When the exposure is on, a preview window is updated during the exposure when using Panoramic or Cephalostatic Dimax2/3 sensor, but not when IntraOral Dixi2/3 sensor is used.

When the exposure is done, ‘Adjust’ and ‘OK’ buttons are activated. Additional image processing can be done, if necessary, when ‘Adjust’ button is pressed.

If ‘Adjust’ button is pressed, the default values are read from C:\ProgramData\Planmeca\didapi DidapiUI.ini control file


12

PLANMECA TWAIN

2014-05-12 Page 13(29)

-

‘Input Levels’ can be adjusted only when ‘Level’ check box has been first selected. In ‘Input Level’ window the ‘blue’ grab line is for a djusting gamma value, and ‘red’ grab lines for clipping low and high levels.

-

Sharpening filter can be adjusted if ‘Sharpen’ check box has been first selected.

-

‘Soft Tissue Filter’ check box is activated only if DIDAPI driver pre -processing has not already done the filtering (see ‘Didapi.ini file’ file setting). Note! When using demo images the ini setting have no effect.

- Note ! There are two manually settable parameters that have effects on the exposure workflow and two how the final image are looking. Workflow parameters: 1) StudyExposureEnabled=1, default 0, if 0, if for Intra all images are a re taken before they are sent to to TWAIN, 2) AutoCloseWindow=1, default 0, if 0, if the exposure window is close immediately after the image is taken, 3) Resolution=NORMAL 3) Resolution=NORMAL (or MEDIUM MEDIUM or HIGH) controls HIGH) controls the sensor binning resolution and 4) BurnImageInfo=1, 4) BurnImageInfo=1, default 0, if image info is ‘burned’ permanently for the final image.New parameter SaveSettings in SaveSettings in new section [GENERAL] controls whether new Adjust setting are saved or not when window is close d. Look for the detailed layout of control file in document ‘DidapiUI_Interface.doc DidapiUI_Interface.doc’’.

The used values are saved into C:\ProgramData\Planmeca\didapi\DidapiUI.ini C:\ProgramData\Planmeca\didapi\ DidapiUI.ini file when ‘OK’ button is pressed. The image is transferred into application according to TWAIN specification.


13

PLANMECA TWAIN

2014-05-12 Page 14(29)


14

PLANMECA TWAIN

2014-05-12 Page 15(29)

1.2.4 Planmeca ProScanner Capture Window

ProScanner interface layer is activated when ‘ProScanner’ –button is pressed.

For ProScanner image capture description, see Planmeca Romexis user’s manual and Planmeca ProScanner user’s&installation manual.


15

PLANMECA TWAIN

2014-05-12 Page 16(29)

1.2.5 Planmeca TWAIN Device Control File for DIDAPI Devices

When Planmeca TWAIN image DIDAPI grabbing is completed successfully, the default values for DIDAPI X-ray control are saved or updated in ‘C:\ProgramData\Planmeca\didapi\Config\P C:\ProgramData\Planmeca\didapi\Config\PmTwain.ini’ mTwain.ini’ file, see APPENDIX A.1 A. 1 information flow graph. Example default sample values are shown below

[Dialog] FileName=H:\DOCUME~1\username FileName=H:\DOCUME~1\ username \LOCALS~1\Temp\PmImage.tif \LOCALS~1\Temp\PmImage.tif WindowPosition=TOP_LEFT WindowPosition=TOP_L EFT

(TOP_RIGHT, BOTTOM_LEFT, BOTTOM_LEFT, BOTTOM_RIGHT)

PreviewEnabled=1

(= previewing of the image is shown, 0 = not shown)

Bitdepth16Enabled=0 ImageFormat=0

(=8 bit level is used, 1 = use 16 bit) (tiff=0, jpeg = 1, bmp = 2)

JpegQuality=95

(= percent value for image quality if jpeg format has been selected)

NOTE! NOTE! If NOTE! If the application sends SupportedBitDepthGray=16 capability message, then Bitdeph16Enabled is set to 1, although the user has set the value to 0 (not e nabled). stud y exposure mode is enabled, the name will have an extra order number Note! If for Intra study preceding a zero zero character ‘0’e.g. the name(s) will be in the example case PmImage01.tif, PmImage02.tif and so on.


16

PLANMECA TWAIN

2014-05-12 Page 17(29)

1.2.6 Image Information File of DIDAPI Devices

The resulting image parameters are saved into text file in %temp% folder, default file name as ‘PmImage_tif.txt’. The DIDAPI interface (‘Didapi.ini’) settings start with ‘DIDAPI_ ‘ string and DIDAPIUI interface values with ‘DIDAPIUI_’ string. Note! In this example case no DIDAPI interface layer corrections has been made, but only in DIDAPIUI interface layer. Note! The resulting TWAIN DIDAPI image contains contains DPI resolution value calculated using sensor pixel size and magnification factor.

DATE=20040824 TIME=130742 TYPE=DIMAX2_P WIDTH=2200 HEIGHT=920 BIT_DEPTH=8 PIXELSIZE=132 PIXELSIZEIMAGE=139.92 PIXELSIZEIMAGE=139. 92

( PIXELSIZE*DIDAPI magnification factor; in this case 1.06)

DIDAPI_AUTOLEVELS_ENABLED=1 DIDAPI_GAMMA= 1.00 DIDAPI_CLIPLOWPCT= 0.00 DIDAPI_CLIPHIGHPCT= 0.00 DIDAPIUI_LEVELS_ENABLED=1 DIDAPIUI_GAMMA= 0.40 DIDAPIUI_CLIPLOWPCT= DIDAPIUI_CLIPLOWPC T= 0.01 DIDAPIUI_CLIPHIGHPCT= 0.01 DIDAPIUI_SHARPENING_ENABLED=1 DIDAPIUI_SHARPENING_FILTERRADIUS=3 Planmeca_Twain_Interface.docx

17

PLANMECA TWAIN

2014-05-12 Page 18(29)

DIDAPIUI_SHARPENING_SCALEFACTOR=189 DIDAPIUI_MEDIANFILTER_ENABLED=1 PARAM_kV=66

(** old parameter )

PARAM_mA=8 PARAM_s= 15.00 SENSOR_NUMBER= SENSOR_NUMBER= 020202 DPARAM_0100=66.0 DPARAM_0101=6.0 DPARAM_0102=80.0 DPARAM_0106=100.0 (because image magnification is taken care; Original DIDAPI value 106.0) DPARAM_0107=24.3 DPARAM_0108=2.0 DPARAM_0109=5.0 DPARAM_0201=1.0 DPARAM_0202=1.0 DPARAM_0203=1.0 DPARAM_0204=1.0 DPARAM_0205=1.0 DPARAM_0206=0.0 DPARAM_0207=0.0 DPARAM_0208=0.0 DPARAM_0209=0.0 DPARAM_0210=0.0 DPARAM_0502=0.0 DPARAM_0503=0.0 Planmeca_Twain_Interface.docx

18

PLANMECA TWAIN

2014-05-12 Page 19(29)

SPARAM_0110=Dixi2/Dixi3 SPARAM_0110=Dixi2 /Dixi3 Intra Oral Sensor Ethernet Interface SPARAM_0111=1.4.2.0.R SPARAM_0200=b2 SPARAM_0500=720208 EOF


19

PLANMECA TWAIN

2014-05-12 Page 20(29)

1.2.7. Image Control of ProScanner Device

It is possible to control ProScanner grey levels output image using the control parameter ‘ LevelMinVal’ in

section [Processing] in control file ‘Proscanner.ini’ file (see Appendix B.2) . Default value is 512; 12 bit image scale 0 … 4095.

1.2.8 Twain Log File

A log file ‘PmTWain.log’ is created or the existing exi sting file is opened when device selection window is opened. The log file is located in C:\ProgramData\Planmeca\Logs -folder. DIDAPI interface layer has its own log file ‘Didapi.log’, see APPENDIX A. A.1 graph. Below is an example of the ‘PmTWain.log’ file for file for DIDAPI interface capture, and then an example of loggings when ProScanner -device is used.

B elow an exam examp ple co conte ntent nt of of the log fi f i le for D I D A P I P anoram noramii c sam sample i mage. Note ! Two files for exposure are always saved: 1) raw DIDAPI image _raw.tif 2) Final pre-processed image . Fri Nov 22 10:12:14 2013

------ INIT ---------------------------------------------- INIT -------

Fri Nov 22 10:12:14 2013

UI INI file name: C:\ProgramData\Planmeca\Didapi\Config C:\ProgramData\Planmeca\Didapi\Config\DidapiUI.ini \DidapiUI.ini

Fri Nov 22 10:13:28 2013

UI ini path:

Fri Nov 22 10:13:28 2013

===========

Fri Nov 22 10:13:28 2013

C:\ProgramData\Planmeca\Didapi\Config\DidapiUI.ini C:\ProgramData\Planmeca\Didapi\Config \DidapiUI.ini

Fri Nov 22 10:13:28 2013

DIDAPI ini path:

Fri Nov 22 10:13:28 2013

================ ================

Fri Nov 22 10:13:28 2013

C:\ProgramData\Planmeca\Didapi\Config\Didapi.ini C:\ProgramData\Planmeca\Didapi\Config \Didapi.ini

Fri Nov 22 10:13:28 2013

twaindidapisrc.ds version: 5.0.1.0

Fri Nov 22 10:13:28 2013

The folder of image will be: C:\Users\hatakma\AppData\Local\Temp

Fri Nov 22 10:13:28 2013

Read DidapiUI.ini values.


20

PLANMECA TWAIN

2014-05-12 Page 21(29)

Fri Nov 22 10:13:28 2013

MEDIUM resolution used.

Fri Nov 22 10:13:28 2013

Patient Information Input:

Fri Nov 22 10:13:28 2013 Fri Nov 22 10:13:28 2013

DidapiUI member variables initialised

Fri Nov 22 10:13:28 2013

ERROR: NO license file found. Should be installed on Planmeca DIDAPI

'Program Data' Config- folder(Didapi 5.0 or higher). Fri Nov 22 10:13:28 2013

Getting and setting device parameters

Fri Nov 22 10:13:28 2013

Reading sensor data

Fri Nov 22 10:13:28 2013

Sensor Image size - width: 2200 height:920

Fri Nov 22 10:13:28 2013

Initializing DIDAPI grabbing

Fri Nov 22 10:13:28 2013

DidapiUI dialog window initialised

Fri Nov 22 10:13:28 2013

Starting Panoramic grabbing.

Fri Nov 22 10:13:37 2013

Exposure ready.

Fri Nov 22 10:13:37 2013

Raw DIDAPI Image saved in TIFF format (16 bit) using DIDAPI_save_image() DIDAPI_save_image()

function : C:\Users\hatakma\AppData\Local\T C:\Users\hatakma\AppData\Local\Temp\PmImage_raw.tif emp\PmImage_raw.tif Fri Nov 22 10:13:37 2013

TIFF image read into memory.

Fri Nov 22 10:13:37 2013

Exposured portion of the image re-mapped.

Fri Nov 22 10:13:37 2013

Image histogram loaded.

Fri Nov 22 10:13:37 2013

Image regenerated in memory. Settings in didapiUI.ini used.

Fri Nov 22 10:13:37 2013

X_RAY_DEVICE_NAME= X_RAY_DEVICE_NAME=

Fri Nov 22 10:13:37 2013

X_RAY_DEVICE_SW_VERSI X_RAY_DEVICE_SW_VERSION= ON=

Fri Nov 22 10:13:37 2013

X_RAY_DEVICE_PROG_NAME= X_RAY_DEVICE_PROG_NAME=

Fri Nov 22 10:13:37 2013

X_RAY_DEVICE_PROG_SUB_ X_RAY_DEVICE_PROG_SUB_NAME= NAME=

Fri Nov 22 10:13:37 2013

SENSOR_NUMBER= SENSOR_NUMBER=

Fri Nov 22 10:13:37 2013

Exposure values:

Fri Nov 22 10:13:37 2013

- 60 kV 4 mA 15.900 s

Fri Nov 22 10:13:37 2013

Image info saved into :

C:\Users\hatakma\AppData\Local\Temp\PmImage_raw_tif.TXT Planmeca_Twain_Interface.docx

21

PLANMECA TWAIN

2014-05-12 Page 22(29)

Fri Nov 22 10:13:37 2013

Sending Pages message

Fri Nov 22 10:13:41 2013

Start of adjusting levels in preview mode.

Fri Nov 22 10:13:42 2013

Adjust dialogs and control initialised.

Fri Nov 22 10:13:46 2013

For TWAIN: Sending CLOSE message

Fri Nov 22 10:13:46 2013

Closing didapiUI window: Clearing memory ...

Fri Nov 22 10:13:46 2013

OK. ... Close logfile.

Fri Nov 22 10:13:46 2013

------ END ------------------------------------------------ END --------

Below a log file for ProScanner capture:

Mon Mar 31 14:45:33 2014 ------ INIT ---------------------------------------------- INIT ------------Mon Mar 31 14:45:33 14:45:33 2014 2014 UI INI file name: C:\ProgramData\Planmeca\Didapi\Config\DidapiUI.in C:\ProgramData\Planmeca\Didapi\Config\DidapiUI.inii Mon Mar 31 14:45:35 14:45:35 2014 SDK DLL DLL version Mon Mar Mar 31 14:45:35 2014 Ver. 1.0.0.75 1.0.0.75 Mon Mar Mar 31 14:45:35 2014 ====================== ======================== == Mon Mar 31 14:45:35 2014 Mon Mar 31 14:45:35 14:45:35 2014 TEMP path: C:\ProgramData\Planmeca\ProScanner Mon Mar 31 14:45:35 2014 Status: None None Mon Mar Mar 31 14:45:35 2014 Open scanner ... Mon Mar 31 14:45:35 2014 OK. Mon Mar Mar 31 14:45:35 2014 Status: Waiting Waiting Mon Mar 31 14:45:35 14:45:35 2014 2014 Status: Waiting - Connection Connection Type: USB USB Mon Mar Mar 31 14:45:35 2014 Notify: changeFormat changeFormat Mon Mar Mar 31 14:45:35 2014 Image Plate: SIZE3 Mon Mar 31 14:45:35 14:45:35 2014 Scanner Resolution: Resolution: SD Mon Mar Mar 31 14:45:35 2014 Status: Connected Connected Mon Mar Mar 31 14:45:35 2014 Status: Connected Connected Planmeca_Twain_Interface.docx

22

PLANMECA TWAIN

2014-05-12 Page 23(29)

Mon Mar 31 14:45:35 2014 Status Connected: Scanner SN 'FR11-01CHAA-100205 'FR11-01CHAA-100205'' Mon Mar 31 14:45:39 14:45:39 2014 2014 RFID read from Image - Serialnumber: DE0E4A46500104E0 DE0E4A46500104E0 Mon Mar Mar 31 14:45:39 2014 Notify: ScanStarted ScanStarted Mon Mar Mar 31 14:45:39 2014 Status: Transferring Transferring Mon Mar Mar 31 14:45:46 2014 Status: Connected Connected Mon Mar Mar 31 14:45:46 2014 Status: Connected Connected Mon Mar 31 14:45:46 2014 Status Connected: Scanner SN 'FR11-01CHAA-100205 'FR11-01CHAA-100205'' Mon Mar Mar 31 14:45:48 2014 Notify: Preprocessed Preprocessed Mon Mar 31 14:45:48 14:45:48 2014 2014 Notify: Image size; w=843, w=843, h=421 h=421 Mon Mar Mar 31 14:45:48 2014 Notify: Image Image name= name= 'C:\ProgramData\Planmeca\ProScanner\Images\_pm_prosc 'C:\ProgramData\Planmeca\ProScan ner\Images\_pm_proscanner__1_201 anner__1_2014_3_31_14 4_3_31_144548_w84 4548_w843_h421.ra 3_h421.ra w' Mon Mar 31 14:45:48 2014 16 bit raw image image extreme values: values: min 227 , max 1447 1447 Mon Mar 31 14:45:48 14:45:48 2014 2014 CalcAndSave: Save image as TIFF ... Mon Mar 31 14:45:48 14:45:48 2014 2014 _pm_proscanner__1_2014_3_31 _pm_proscanner__1_2014_3_31_144548.tif _144548.tif Mon Mar 31 14:45:48 14:45:48 2014 CalcAndSave: Saved OK. Mon Mar 31 14:45:48 14:45:48 2014 2014 CalcAndSave: Imageinfo txt file written. Mon Mar 31 14:45:48 14:45:48 2014 2014 CalcAndSave: Saving filename(s) filename(s) into file 'C:\ProgramData\Planmeca\ProScanner\_pm_proscanner_files_.txt' Mon Mar Mar 31 14:45:48 2014 CalcAndSave: ok Mon Mar 31 14:45:48 2014 Sending Pages message Mon Mar 31 14:45:48 14:45:48 2014 Notify: Preprocessed Preprocessed END. END. Mon Mar 31 14:48:33 14:48:33 2014 2014 TWAIN image file name: C:\Users\hatakma\AppData\Local\Temp C:\Users\hatakma\AppData\Local\Temp\PmImage.tif \PmImage.tif Mon Mar Mar 31 14:48:33 2014 Bit depth 8 Mon Mar 31 14:48:33 2014 Sending image size for TWAIN: TWAIN: 840 421 Mon Mar 31 14:48:33 2014 Sending NotifyXferReady message to TWAIN Mon Mar Mar 31 14:48:33 2014 Closing connection. Planmeca_Twain_Interface.docx

23

PLANMECA TWAIN

2014-05-12 Page 24(29)

Mon Mar 31 14:48:33 14:48:33 2014 2014 Disconnect(): Closing scanner and SDK Mon Mar 31 14:48:38 2014 ------ END ------------------------------------------------ END ---------------


24

PLANMECA TWAIN

2014-05-12 Page 25(29)

APPENDIX A. Planmeca TWAIN Source Source Interface Layers

A.1 DIDAPI Acquisition Interface Interface for DIDAPI devices consists of three interface layers, 1) TWAIN application 2) data source + DIDAPIUI and 3) DIDAPI. (See the APPENDIX B.1 the graph graph)). -

Layer three, DIDAPI library interface, contains functions for communicating with Planmeca device drivers and pre-processing of the image. See document ‘DIDAPI_5_0.doc for detailed descriptions of that layer.

- Layer two, DIDAPIUI layer consist Planmeca TWAIN Data Source that handles communication to TWAIN Manager interface, contains device control UI and a function for handling user interface (UI) and the whole DIDAPI grabbing procedure. See and/or document ‘DidapiUI_Interface.doc DidapiUI_Interface.doc’’ for detailed information. informa tion. - Layer one, TWAIN application

During the TWAIN DIDAPI grabbing procedure, the image is saved twice. DIDAPI interface la yer grabs the X-ray image and saves it alwa ys as a 12(16)-bit TIFF image just after exposure is finished. DIDAPI has pre-processes the ‘raw’ image according to ‘didapi.ini’ control file settings. The DIDAPIUI layer modifies the X-ray X-ray image using the settings of ‘didapiui.ini’ control file and saves the final image as a 8 or 12(16)-bit TIFF format (=by default) image when leaving the la yer, look at Planmeca TWAIN Control File. File. The both layer settings are saved into i nto image information file ‘PmImage_tif.txt’ (=the default value). The file contains image information and device parameter values, see Image Information File section. DIDAPIUI layer notifies the TWAIN Source layer that the image is ready. read y. Planmeca TWAIN Source interface layer opens the image fil e and finally sends the image data into the TWAIN Interf ace of the application.


25

PLANMECA TWAIN

2014-05-12 Page 26(29)

A.2 ProScanner Capture Interface

Interface consists of three interface layers, 1) TWAIN 2) ProScannerApp and 3) Device driver. - Layer three, scanner device driver, contains functi ons for sending to and getting information from scanner device. See ProScanner application document for detailed information. - Layer two, ProScanner layer consists of Planmeca TWAIN Data Source that handles communication to TWAIN Manager interface and to ProScanner capture, contains f unctions for handling user interface (UI) and the whole scanning sc anning procedure. See ProScanner application document for detailed information. - Layer one, Layer one, TWAIN application


26

PLANMECA TWAIN

2014-05-12 Page 27(29)

APPENDIX B. Information Flow Graph Graph B.1 Didapi Capture

See also 1.2.7 Twain Log File of event logging DIDAPI Twain Capture: Application Level App exe

A medical application using Twain Interface.

1 l e v e L

Twain Source Manager \twain_32.dll

DIDAPI Twain Capture: Source Level File: twaindidapi.src

Planmeca TWAIN Source \twain_32\Planmeca\

2 l e v e L

%temp%\PmImage.tif

PmTwain.log \Planmeca\Didapi\Logs\

Planmeca TWAIN Device Control Dialog

’PmTWain.ini’ \Planmeca\Didapi\Config\

DidapiUI Capture Dialog

’DidapiUI.ini’ \Planmeca\Didapi\Config\

Didapi TWAIN Capture: Device Driver Level File: Didapi.dll

%temp%\PmImage_raw.tif 3 l e v e L


Didapi Level functions via ’didapi .dll’

’Didapi.ini’ \Planmeca\Didapi\Config\

Device level logging ’Didapi .log’ \Planmeca\Didapi\Logs\

27

PLANMECA TWAIN

2014-05-12 Page 28(29)

B.2 ProScanner Capture

ProScanner Twain Capture: Application Level App exe

A medical application using Twain Interface.

1 l e v e L

Twain Source Manager \twain_32.dll

ProScanner Twain Capture: Source Level File: twaindidapi.src

Planmeca TWAIN Source \twain_32\Planmeca\

2 l e v e L

Result post-processed image(s): _pm_proscanner_.tif \Planmeca\ ProScanner\

PmTwain.log \Planmeca\Didapi\Logs\

Planmeca TWAIN Device Control Dialog

’PmTWain.ini’ \Planmeca\Didapi\Config\

ProScanner Capture Dialog

’ProScanner.ini’ \Planmeca\ProScanner\ Config\

ProScanner TWAIN Capture: Device Driver Level File: CRswing.dll

3 l e v e L

Result raw image(s): _pm_proscanner_.raw \Planmeca\ ProScanner\Images\

ProScanner Device Level Driver ’CRswing .dll’

FireCR.ini

Calibration file of scanner \\section.dat


28

PLANMECA TWAIN

2014-05-12 Page 29(29)


29

Planmeca Twain Interface

Recommend Documents