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………………………… ProScanner device support added + text updated
Planmeca_Twain_Interface.docx 2
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.’
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 of TWAIN interface to capture medical/dental images maybe subject to regulatory
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: markku.hatakka@planmeca.com
Page 5(29)
TABLE OF CONTENTS
PLANMECA TWAIN SOURCE INTERFACE 7

1.1 INSTALLATION 7
1.2 USING OF TWAIN DATA SOURCE 9
1.2.1 Data Source Name and Supported Devices 10
1.2.2 Device Control Window 11
1.2.3 DIDAPIUI Exposure Window 12
1.2.4 Planmeca 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 Device 20
1.2.8 Twain Log File 20
APPENDIX A. PLANMECA TWAIN SOURCE INTERFACE LAYERS 25

A.1 DIDAPI ACQUISITION INTERFACE 25
APPENDIX B. INFORMATION FLOW GRAPH 27

B.1 DIDAPI CAPTURE 27
B.2 PROSCANNER CAPTURE 28
Page 6(29)
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 SDK
installation setup program, and in DidapiKit CD. The setup program is in
DVD/CD folder ‘DidapiKit\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.
Page 8(29)
The source ‘twaindidapisrc.ds’ file is installed into

<WINDIR>\Twain_32\Planmeca folder.
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 Source …
This must be done only once, if only Planmeca Data Source is used every time the PC is started.
Page 10(29)
1.2.1 Data Source Name and Supported Devices
Planmeca data source name is called ’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.
Page 11(29)
1.2.2 Device Control Window
Application ‘TWAIN acquire’ command starts Planmeca Device Control, e.g. here File->Acquire
…
Planmeca TWAIN Source Control window is then 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 pre-
defined default values in control file in 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 –folder.
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
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 adjusting 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 for Intra all images are taken before they are sent to
TWAIN, 2) AutoCloseWindow=1, default 0, if the exposure window is close immediately
after the image is taken, 3) Resolution=NORMAL (or MEDIUM or HIGH) controls the
sensor binning resolution and 4) BurnImageInfo=1, default 0, if image info is ‘burned’
permanently for the final image.New parameter SaveSettings in new section [GENERAL]
controls whether new Adjust setting are saved or not when window is closed. Look for the
detailed layout of control file in document ‘DidapiUI_Interface.doc’.
The used values are saved into C:\ProgramData\Planmeca\didapi\DidapiUI.ini file when ‘OK’
button is pressed. The image is transferred into application according to TWAIN specification.
Page 14(29)
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.
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\PmTwain.ini’ file, see APPENDIX A.1 information flow
graph. Example default sample values are shown below
[Dialog]
FileName=H:\DOCUME~1\username \LOCALS~1\Temp\PmImage.tif
WindowPosition=TOP_LEFT (TOP_RIGHT, BOTTOM_LEFT, BOTTOM_RIGHT)
PreviewEnabled=1 (= previewing of the image is shown, 0 = not shown)
Bitdepth16Enabled=0 (=8 bit level is used, 1 = use 16 bit)

ImageFormat=0 (tiff=0, jpeg = 1, bmp = 2)
JpegQuality=95 (= percent value for image quality if jpeg format has been
selected)
NOTE! 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 enabled).
Note! If for Intra study exposure mode is enabled, the name will have an extra order number
preceding a zero character ‘0’e.g. the name(s) will be in the example case PmImage01.tif,
PmImage02.tif and so on.
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 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 ( 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= 0.01
DIDAPIUI_CLIPHIGHPCT= 0.01
DIDAPIUI_SHARPENING_ENABLED=1
DIDAPIUI_SHARPENING_FILTERRADIUS=3
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= 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
Page 19(29)
SPARAM_0110=Dixi2/Dixi3 Intra Oral Sensor Ethernet Interface
SPARAM_0111=1.4.2.0.R
SPARAM_0200=b2
SPARAM_0500=720208
EOF
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 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.1 graph. Below is an example of the
‘PmTWain.log’ file for DIDAPI interface capture, and then an example of loggings when
ProScanner -device is used.
Below an example content of the log file for DIDAPI Panoramic sample image.
Note ! Two files for exposure are always saved:
1) raw DIDAPI image <name>_raw<order_number_if_study>.tif
2) Final pre-processed image <name><order_number_if_study>.<format>
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\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
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
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.
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()
function : C:\Users\hatakma\AppData\Local\Temp\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=

Fri Nov 22 10:13:37 2013 X_RAY_DEVICE_SW_VERSION=
Fri Nov 22 10:13:37 2013 X_RAY_DEVICE_PROG_NAME=
Fri Nov 22 10:13:37 2013 X_RAY_DEVICE_PROG_SUB_NAME=
Fri Nov 22 10:13:37 2013 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
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 2014 UI INI file name: C:\ProgramData\Planmeca\Didapi\Config\DidapiUI.ini
Mon Mar 31 14:45:35 2014 SDK DLL version
Mon Mar 31 14:45:35 2014 Ver. 1.0.0.75
Mon Mar 31 14:45:35 2014 ========================
Mon Mar 31 14:45:35 2014
Mon Mar 31 14:45:35 2014 TEMP path: C:\ProgramData\Planmeca\ProScanner
Mon Mar 31 14:45:35 2014 Status: None
Mon Mar 31 14:45:35 2014 Open scanner ...
Mon Mar 31 14:45:35 2014 OK.
Mon Mar 31 14:45:35 2014 Status: Waiting
Mon Mar 31 14:45:35 2014 Status: Waiting - Connection Type: USB
Mon Mar 31 14:45:35 2014 Notify: changeFormat
Mon Mar 31 14:45:35 2014 Image Plate: SIZE3
Mon Mar 31 14:45:35 2014 Scanner Resolution: SD
Mon Mar 31 14:45:35 2014 Status: Connected

Page 23(29)
Mon Mar 31 14:45:35 2014 Status Connected: Scanner SN 'FR11-01CHAA-100205'
Mon Mar 31 14:45:39 2014 RFID read from Image - Serialnumber: DE0E4A46500104E0
Mon Mar 31 14:45:39 2014 Notify: ScanStarted
Mon Mar 31 14:45:39 2014 Status: Transferring
Mon Mar 31 14:45:46 2014 Status Connected: Scanner SN 'FR11-01CHAA-100205'
Mon Mar 31 14:45:48 2014 Notify: Preprocessed
Mon Mar 31 14:45:48 2014 Notify: Image size; w=843, h=421
Mon Mar 31 14:45:48 2014 Notify: Image name=

'C:\ProgramData\Planmeca\ProScanner\Images\_pm_proscanner__1_2014_3_31_144548_w843_h421.ra
w'
Mon Mar 31 14:45:48 2014 16 bit raw image extreme values: min 227 , max 1447
Mon Mar 31 14:45:48 2014 CalcAndSave: Save image as TIFF ...
Mon Mar 31 14:45:48 2014 _pm_proscanner__1_2014_3_31_144548.tif
Mon Mar 31 14:45:48 2014 CalcAndSave: Saved OK.
Mon Mar 31 14:45:48 2014 CalcAndSave: Imageinfo txt file written.
Mon Mar 31 14:45:48 2014 CalcAndSave: Saving filename(s) into file

'C:\ProgramData\Planmeca\ProScanner\_pm_proscanner_files_.txt'
Mon Mar 31 14:45:48 2014 CalcAndSave: ok
Mon Mar 31 14:45:48 2014 Sending Pages message
Mon Mar 31 14:45:48 2014 Notify: Preprocessed END.
Mon Mar 31 14:48:33 2014 TWAIN image file name: C:\Users\hatakma\AppData\Local\Temp\PmImage.tif
Mon Mar 31 14:48:33 2014 Bit depth 8
Mon Mar 31 14:48:33 2014 Sending image size for TWAIN: 840 421
Mon Mar 31 14:48:33 2014 Sending NotifyXferReady message to TWAIN
Mon Mar 31 14:48:33 2014 Closing connection.
Page 24(29)
Mon Mar 31 14:48:33 2014 Disconnect(): Closing scanner and SDK
Mon Mar 31 14:48:38 2014 ------ END ------------------------- END --------
Page 25(29)
APPENDIX A. Planmeca TWAIN 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).
- 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’ for detailed information.
- Layer one, TWAIN application
During the TWAIN DIDAPI grabbing procedure, the image is saved twice. DIDAPI interface layer
grabs the X-ray image and saves it always 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 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 layer,
look at Planmeca TWAIN Control File. The both layer settings are saved into 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. Planmeca TWAIN Source interface layer opens the image file and
finally sends the image data into the TWAIN Interface of the application.
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 functions 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 functions for
handling user interface (UI) and the whole scanning procedure. See ProScanner application
document for detailed information.
- Layer one, Layer one, TWAIN application
Page 27(29)
APPENDIX B. Information Flow 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.

Level 1
Twain Source Manager
<WINDIR>\twain_32.dll
DIDAPI Twain Capture: Source Level

File: twaindidapi.src
Planmeca TWAIN Source

PmTwain.log
<ALLUSERSPROFILE>\Planmeca\Didapi\Logs\
<WINDIR>\twain_32\Planmeca\
’PmTWain.ini’
Planmeca TWAIN Device Control Dialog
Level 2
<ALLUSERSPROFILE>\Planmeca\Didapi\Config\
’DidapiUI.ini’
DidapiUI Capture Dialog
%temp%\PmImage.tif <ALLUSERSPROFILE>\Planmeca\Didapi\Config\
Didapi TWAIN Capture: Device Driver Level

File: Didapi.dll
’Didapi.ini’
Didapi Level functions via ’didapi.dll’
%temp%\PmImage_raw.tif <ALLUSERSPROFILE>\Planmeca\Didapi\Config\
Level 3
Device level logging ’Didapi.log’

Page 28(29)
B.2 ProScanner Capture
ProScanner Twain Capture: Application Level

App exe
A medical application using Twain Interface.

Level 1
Twain Source Manager
<WINDIR>\twain_32.dll
ProScanner Twain Capture: Source Level

File: twaindidapi.src
Planmeca TWAIN Source

PmTwain.log
<WINDIR>\twain_32\Planmeca\
’PmTWain.ini’
Planmeca TWAIN Device Control Dialog
Level 2
<ALLUSERSPROFILE>\Planmeca\Didapi\Config\
Result post-processed image(s): ’ProScanner.ini’

_pm_proscanner_<NN>.tif ProScanner Capture Dialog <ALLUSERSPROFILE>\Planmeca\ProScanner\
<ALLUSERSPROFILE>\Planmeca\ Config\
ProScanner\
ProScanner TWAIN Capture: Device Driver Level

File: CRswing.dll
Result raw image(s): <CurrentFolder>FireCR.ini

_pm_proscanner_<NN>.raw ProScanner Device Level Driver ’CRswing.dll’
Level 3
<ALLUSERSPROFILE>\Planmeca\
ProScanner\Images\
Calibration file of scanner

<Current_folder>\<Serial_Number>\section.dat
Page 29(29)

Planmeca Twain Interface

Transféré par

Informations du document

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

Planmeca Twain Interface

Transféré par

Droits d'auteur :

Formats disponibles

TWAIN INTERFACE FOR PLANMECA DEVICES

Important Revision Changes:

2014-04-02………………………… ProScanner device support added + text updated

TWAIN is a ‘Standard for image acquisition systems’. TWAIN

Please send comments etc. to:

PLANMECA TWAIN SOURCE INTERFACE 7

1.2 USING OF TWAIN DATA SOURCE 9

1.2.1 Data Source Name and Supported Devices 10

1.2.2 Device Control Window 11

1.2.3 DIDAPIUI Exposure Window 12

1.2.4 Planmeca 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 Device 20

1.2.8 Twain Log File 20

APPENDIX A. PLANMECA TWAIN SOURCE INTERFACE LAYERS 25

APPENDIX B. INFORMATION FLOW GRAPH 27

B.2 PROSCANNER CAPTURE 28

Planmeca TWAIN Source Interface

The installation of the Twain source interface is included in Romexis

The source ‘twaindidapisrc.ds’ file is installed into

1.2 Using of TWAIN Data Source

First a Planmeca TWAIN Source is selected, e.g. File->Select Source …

1.2.1 Data Source Name and Supported Devices

Planmeca data source name is called ’Planmeca Twain’.

1.2.2 Device Control Window

Planmeca TWAIN Source Control window is then opened.

1.2.3 DIDAPIUI Exposure Window

1.2.4 Planmeca ProScanner Capture Window

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

1.2.5 Planmeca TWAIN Device Control File for DIDAPI Devices

WindowPosition=TOP_LEFT (TOP_RIGHT, BOTTOM_LEFT, BOTTOM_RIGHT)

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

Bitdepth16Enabled=0 (=8 bit level is used, 1 = use 16 bit)

NOTE! NOTE! If the application sends SupportedBitDepthGray=16 capability message, then

1.2.6 Image Information File of DIDAPI Devices

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

PARAM_kV=66 (** old parameter )

SPARAM_0110=Dixi2/Dixi3 Intra Oral Sensor Ethernet Interface

1.2.7. Image Control of ProScanner Device

1.2.8 Twain Log File

Note ! Two files for exposure are always saved:

1) raw DIDAPI image <name>_raw<order_number_if_study>.tif

2) Final pre-processed image <name><order_number_if_study>.<format>

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\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

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

Fri Nov 22 10:13:28 2013 twaindidapisrc.ds version: 5.0.1.0

Fri Nov 22 10:13:28 2013 Read DidapiUI.ini values.

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 Getting and setting device parameters

Fri Nov 22 10:13:28 2013 Reading sensor data

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.