onyx · pdf filecontent i content release 1 ipreface 3 iiinstallation 5 1overview

Copyrights © Image Instruments GmbH 2001-2007

image

Digital Cephalometric Imaging in Orthodontics and OMS

instruments

Onyx Ceph ™Technical Manual Version 2.7

© Image Instruments GmbH 2001-2007

Onyx Ceph™

Support


All rights reserved. No parts of this work may be reproduced in any form or by any means - graphic,electronic, or mechanical, including photocopying, recording, taping, or information storage and retrievalsystems - without the written permission of the publisher.

Products that are referred to in this document may be either trademarks and/or registered trademarks of therespective owners. The publisher and the author make no claim to these trademarks.

While every precaution has been taken in the preparation of this document, the publisher and the authorassume no responsibility for errors or omissions, or for damages resulting from the use of informationcontained in this document or from the use of programs and source code that may accompany it. In noevent shall the publisher and the author be liable for any loss of profit or any other commercial damagecaused or alleged to have been caused directly or indirectly by this document.

Chemnitz, Januar 2007

Onyx Ceph™ - Digital Cephalometric Imaging Software

Functionality and layout of the software Onyx Ceph™ is aligned tothe workflow in orthodontic diagnostic imaging and treatmentplanning. Most of the implemented features can be customized.The variety of diagnostic and treatment concepts in orthodonticsand oral-maxillofacial surgery may require additional features.Image Instruments is grateful for each such hint and will implementeach new feature that may improve the usability of the software.

Image Instruments GmbHOlbernhauer Str. 5D 09125 ChemnitzGermanyPhone +49 371 9093 140Fax +49 371 9093 149

www.onyx-ceph.de - [email protected]

printed: 10.01.2007

IContent

Content

Release 1

I Preface 3

II Installation 5

................................................................................................................................... 61 Overview

.......................................................................................................................................................... 8Install / Update Onyx Server

......................................................................................................................................................... 8Install Server

......................................................................................................................................................... 8Update Server

.......................................................................................................................................................... 9Install Workstation

.......................................................................................................................................................... 10Install Tools

.......................................................................................................................................................... 11Browse CD

.......................................................................................................................................................... 12Help

.......................................................................................................................................................... 13Exit

................................................................................................................................... 142 License Types

.......................................................................................................................................................... 15Trial

.......................................................................................................................................................... 16OSL

.......................................................................................................................................................... 17RL+

................................................................................................................................... 183 Registration

.......................................................................................................................................................... 19Step 1

.......................................................................................................................................................... 20Step 2

.......................................................................................................................................................... 21Step 3

................................................................................................................................... 224 Deinstallation

................................................................................................................................... 235 Pricelist

................................................................................................................................... 246 Contacts

III Interfaces 26

................................................................................................................................... 271 Practice Management

.......................................................................................................................................................... 27Onyx PMS Interface ......................................................................................................................................................... 27Interface Implementation

......................................................................................................................................... 27Preface

......................................................................................................................................... 28Module Calls

......................................................................................................................................... 29Results

......................................................................................................................................... 30Image Files......................................................................................................................................................... 31Interface Configuration

.......................................................................................................................................................... 34VDDS Media Interface

................................................................................................................................... 352 Digital XRay

.......................................................................................................................................................... 35Duerr Dental - DBSWin

......................................................................................................................................................... 35Settings in Onyx Ceph

......................................................................................................................................................... 35Settings in DBSWin

......................................................................................................................................................... 36Capturing Images

.......................................................................................................................................................... 37Duerr Dental - VistaScan Easy


......................................................................................................................................................... 37Settings in VistaScan Easy


.......................................................................................................................................................... 39Gendex - VixWin


......................................................................................................................................................... 40Settings in VixWin 2000


......................................................................................................................................... 41Clipboard

IIContent

......................................................................................................................................... 41Patient Record

......................................................................................................................................... 41Onyx View

.......................................................................................................................................................... 42Instrumentaruim Imaging - Cliniview

......................................................................................................................................................... 42Settings in Cliniview



.......................................................................................................................................................... 44Morita

.......................................................................................................................................................... 45Orex - Digident

......................................................................................................................................................... 45Settings in Dent-A-View


......................................................................................................................................................... 45Capturing images

.......................................................................................................................................................... 47Planmeca - Dimaxis

......................................................................................................................................................... 47Settings in Dimaxis



.......................................................................................................................................................... 49Sirona - Sidexis

......................................................................................................................................................... 49Settings in Sidexis

......................................................................................................................................... 49Step 1

......................................................................................................................................... 49Step 2

......................................................................................................................................... 50Step 3



......................................................................................................................................... 52Mailslot

......................................................................................................................................... 52Patient record

.......................................................................................................................................................... 53Soredex - Digora

......................................................................................................................................................... 53Settings in Digora



.......................................................................................................................................................... 55Trophy

1Versionsinformation


Release 2.7.70 (613) [Mittwoch, 10. Januar 2007]

Onyx Ceph™ Software

Preface

Preface 3


1 Preface

Find here detailed information about installation and interface configuration for Onyx Ceph™Version 2.7.

Installation

Installation 5


2 Installation

Generally, Onyx Ceph™ can be used in a local network (LAN). For that, all files for commonuse have to be installed on a PC that represents the so-called file-server. This Server-Installation can be done via CD-R or by means of the install setup that wasdownloaded from the Internet.

To use Onyx Ceph™ on any client-PC, a Client-Installation has to be performed there tomanage all required local software settings. This is done by searching the program file path ...\OnyxServer on the server-PC via local network (LAN) and executing the fileOnyxClientSetup.exe. Also the server-PC itself can be used as client.

To install and use Onyx Ceph™ only locally, server and client installation have to beperformed on a single PC.

An Onyx Ceph™ installation can be updated anytime via CD-R or Internet. To do so, thecurrent install-CD has to be inserted into the CD-R drive of any Onyx Ceph™ client PC thatis connected to the server and run menu item Server Update. In that, all required files will beupdated in the whole LAN.

Hint:To install or update Onyx Ceph™ properly, you must have read/write access on theserver-PC.

InstallationOverview 6


2.1 Overview

It is recommended to establish a concept for the use of the software within the practicebefore installation of the trial version in order to prevent unnecessary un- and reinstallationand loss of time and possibly data.

Fundamentally it must be defined

(a) on which PC the Onyx database server should run, (b) on which PC the Onyx database should lie and (c) on which PCs the software should be used.

It goes without saying that, alternatively to a Client/Server installation spread over the localnetwork of the user, a local installation at only one PC or notebook is possible.

Even the trial version should be installed in the configuration required later, so that theevaluations of the trial period stay available after registration. If no registration is desired thecomplete installation can be removed from the server and all client PCs by the accessoryuninstallation program of the program group Onyx.

Step 1: Installation of the Server Software

· Insert the installation CD into the computer that should be used as practice server. Thesame computer can also serve as workstation so that setup at a single PC can be done inthe same way. If your disk drive supports the AutoRun function the install menu willappear on the desktop after a few seconds, otherwise start the file InstallMenu.exe fromthe main path of the CD manually.

· Select the menu point Onyx Ceph Installation. Read the license agreement attentively andgo on by the help of the appropriate button.

· If a version of Onyx Ceph® has already been installed on that computer you can decidewhether to maintain or to update this version in the following dialog.

· For installation at another than the present position, the previous version has to beuninstalled by Start|Settings|System Control|Software. In addition please make sure thatthe file Onyx.ini has been deleted in the Windows directory.

· If Onyx Ceph® is installed for the first time you can select the directory for the installationin the next window. You may accept the suggested path or define another position by thehelp of the browse button [...].

· After all files have been decompressed and copied into the defined directory installation issuccessfully completed.

· Now you can start to set up a network station at the same or at another computer orcomputers of the local network at which the software should be used.

Step 2: Setup of Network Stations

· Click OK in the dialog Client Setup to set up a workstation at the practice server or startthe file OnyxClientSetup.exe of the path OnyxServer of the server at each computer thathas to be set up as workstation. There is no limit for the number of stations but you can doevaluations at maximum five computers at the same time.

· The files required at the workstation are set up by the usual Windows routine. You canselect the directory again.

· At the end of the installation the computer has to be restarted. After that the Onyxshortcuts are installed in the directory and on the desktop and the configuration programOnyx Config is started. The suggested directories can be accepted or changed if required.

Closing the dialog finishes the setup and Onyx Ceph™ can be started at the workstation.Please note that Onyx Ceph™ can only be used when the program OnyxDBServer isrunning, that manages the database tables. When Onyx is started for the first time you are asked to start the relevant server (locally or



LAN). The registration is done relating to the server program OnyxDBServer. The use ofOnyx Ceph™ as registered version therefore requires a connection to the registered server.These settings may also be edited and adjusted after the program start by the menu itemOptions|Onyx Server. That also applies for the available start options of the server program.



2.1.1 Install / Update Onyx Server

You can use this CD-ROM for a first time installation or an update of Onyx Ceph™.Depending on that, the menu items

· Install Onyx Server or· Update Onyx Server

are offered.

2.1.1.1 Install Server

1. Carefully read the software license agreement and thereafter continue with one of thebuttons below.

2. In the next dialog the software destination is displayed. It is recommended to retain theproposed folder but not required. By means of the browse button [...] a new location canbe fixed.

3. After all files have been extracted, the server-installation is successfully completed.

4. Now you can proceed to install one or more client(s) on any PC in the local areanetwork (LAN) of the server to use the software in a multi-user configuration.

2.1.1.2 Update Server

1. Read carefully the software license agreement and thereafter continue with one of thebuttons below.

2. Because a version of Onyx Ceph™ is already installed on your PC, in the next dialogyou can choose to update or retain this version. It is recognized if the version existingon the PC is newer than the version on the Install-CD.

3. After all files have been extracted and copied to the destination folder, the update issuccessfully completed.

Updates can be performed periodically for all license types via Internet(http://www.onyx-ceph.de/downloads.html).

http://www.onyx-ceph.de/downloads.html



2.1.2 Install Workstation

The client installation on any PC in the local network (LAN) is started by running the file

· OnyxClientSetup.exe

in the OnyxServer folder of the previously performed server installation. You also can locateand run this file by means of the Windows-Explorer or by using the menu item

· Install workstation

of this installation program.

To complete the client installation by initializing the database engine the PC has to bere-started before using Onyx Ceph™ for the first time.After restart the links for Onyx Ceph and Onyx View will be established in the programsdirectory and on the icon desktop and the configuration tool Onyx Config will be started.

You can install as many clients you want. Nevertheless, you only can use Onyx Ceph™ on 5PC simultaneously.



2.1.3 Install Tools

Here several drivers are available which may be required in special user configurations.



2.1.4 Browse CD

Here you can browse and display the content of the CD-ROM.



2.1.5 Help

Here some helpful hints are available to assist you during the installation process.



2.1.6 Exit

Exit the install program by a single mouse click on this menu item.

InstallationLicense Types 14


2.2 License Types

For testing Onyx Ceph™ is available in a trial mode free of charge. Registration can be donefor an Open Subscription License (OSL), or a Runtime Plus License (RL+).



2.2.1 Trial

Without registration the software can be used in a trial mode to evaluate its functionality andefficiency for your purpose. It is not allowed to use Onyx Ceph™ commercially beforeregistration.The trial mode causes the following restrictions:

· not more than 10 patients· not more than 50 findings· no print outs· no findings exchange· continuously appearing hint windows

After registration all findings performed in the trial mode are still available.



2.2.2 OSL

An Open Subscription License (OSL) permits to use all software components for one year.Subscription can be renewed anytime. Beside the availability of all software options an OSLlicense automatically includes the software service option

· Hotline· Update Service

If a subscription is not renewed, Onyx Ceph™ can be used further with all findingsevaluated before. However, new findings can not be processed. It is possible to reactivatean expired license.

The Onyx Ceph™ Open Subscription License costs EUR 399,00 plus VAT (if applicable)each year.



2.2.3 RL+

An Runtime Plus License (RL+) permits to use all software components for an unlimited timeperiod. Beside the availability of all software options an RL+ license automatically includesthe software service option

· Hotline· Update Service

An Onyx Ceph™ Runtime License costs EUR 2.800,00 plus annually EUR 99,00 forsoftware service (plus VAT, if applicable).

InstallationRegistration 18


2.3 Registration

The restrictions occurring in the trial mode may be abolished by registration of theinstallation at the developer's.

The registration dialog can be started by the menu point Options|Onyx Registration or theitem Programs|Onyx|OnyxRegister that can be reached via the Windows® Start button.For registration Onyx Ceph™ has to be closed at all workstations.

Step 1:Fill out all fields of the registration dialog and go to Step 2.Please note that the practice name is cAsE-SeNsItIvE and that filling out the colored fields isobligatory.

Step 2:Check the registration data again and save it by the help of the buttons "Save as File >>>" or"Copy to Clipboard >>>". Transmit the content of the file or the clipboard by email or phone

· by email: [email protected]· by phone: +49 371 9093140

After that you receive the key to release the software in Step 3.

Step 3:Load or type the registration key. Capitalization is not necessary. After having read andaccepted the End User License Agreement click the button "Register".

Hint:In addition to the release of his installation in the network of the practice or clinic theregistered user can get a second key for each license in order to use the program at alocally distant workstation (notebook or PC at home), too. This registration provided onrequest is restricted to one workstation whereas the LAN installation can be installed at anarbitrary number of PCs in the network and simultaneously used at up to 5 stations.

If the secondary release is required in the relevant registration dialog the same practicename as for the primary release must be used.Synchronized data exchange between both installations is possible by the Exchangefunction.

mailto:[email protected]



2.3.1 Step 1

Fill in all data fields required for registration. Thereafter, switch to step 2. Please note that the practice name is cAsE-SeNsItIvE.



2.3.2 Step 2

Save and submit Registration Data

· by Email to [email protected]· or by phone +49 371 9093140

Use the "save to file >>> or the "copy to clipboard>>>" button to insert the data to the emailbody or attachment. In response, you will receive the registration key by email or fax that has to be typed in step3.




2.3.3 Step 3

Type in the registration here. The key is not case sensitive. Click on button "Registration".

InstallationDeinstallation 22


2.4 Deinstallation

Onyx Ceph™ can be removed from workstation and server completely by running theprogram Onyx Uninstall in Start|Program Files|Onyx.Or find and run the Uninstall program by means of the Windows-Explorer in folderOnyxServer of the Onyx Ceph™ server installation.

InstallationPricelist 23


2.5 Pricelist

annually * once *

Software License Package

OSL (incl. Software Service) 399,00

RL+ 99,00 2.800,00

Service Options

Home Analysis Implementation (each) 90,00

Printed Manual 45,00

Lexicon of installed standard findings (eBook) 45,00

Briefing, Training per hour 35,00

Travel Expense per 50 miles from/to company 50,00

Hardware Options

Interactive Pen Display WACOM DTU 710 1.750,00

Discount on Pen Display for Onyx Ceph users -140,00

* prices in EUR plus VAT

InstallationContacts 24


2.6 Contacts

Onyx Ceph™ is a product of

imageinstruments GmbHOlbernhauer Str. 5D 09125 ChemnitzGermany

Find recent information on Onyx Ceph™ in the internet:

www.onyx-ceph.de

Questions on distribution, installation, or registration should be send to

[email protected]

http://www.onyx-ceph.de


Interfaces

Interfaces 26


3 Interfaces

All Onyx software components can be used independently of the installed practicemanagement program. The component Onyx View as patient and image database besidemany functions for image processing/ -enhancement and image storing offers the possibilityto assign patients to their images and findings by their number (or other master-data) easilyand clearly.

For effective use of Onyx in the dental practice or clinic integration into the practicemanagement program is useful. Onyx supports integration in several ways according to therequirements of the practice:

For frequently used Windows management software defined interfaces for mutual dataexchange with Onyx are provided, that can be configured in the item Options|ExternalPrograms.

In addition several dental and clinical standards are supported. Patient data can be directlytaken over from the management modules of the digital image sources (e.g. mailslot system[Sidexis], clipboard [Gendex, Soredex])

InterfacesPractice Management 27


3.1 Practice Management

3.1.1 Onyx PMS Interface

The internal Onyx Ceph™ PMS interface permits the exchange of patient master data andfinding results with third party patient- and image management applications.

For activating the data exchange between Onyx Ceph™ and the used patient managementprogram the interface has to be implemented in the practice management softwareaccording to the description in subtopic Interface Implementation and corectly configured bythe user as described in subtopic Interface Configuration.

3.1.1.1 Interface Implementation

This section contains technical information how to implement the Onyx Ceph™ PMS Interfacein a Practice Management Software and may be helpful for software developers. The Onyx Ceph™PMS Interface can be used free of charge according to the description given in the topics

· Preface· Module Calls· Results· Image Files

Hint:The interface is provided "as is", and no representation or warranty, expressed or implied,including, without limitation, any warranty of merchantability or of fitness for a particularpurpose whatsoever is made regarding the interface. No warranty is made that the interfacewill perform without interruption or free from errors.In no event IMAGE INSTRUMENTS will be liable for any direct, indirect, incidental, specialor consequential damages arising from or caused by use of, reliance on, or inability toaccess and use any information provided via the interface, even if user has been previouslyadvised of the possibility of such damages or losses.

3.1.1.1.1 Preface

By means of Onyx Ceph™, all types of visual diagnosis required in orthodontics can be easilyperformed. Basically, Onyx Ceph™ requires digital images which can be imported from external imagesources or disk. In the relational data base, each finding consists of a digital image and adataset that contains image related data like patient record ID, date of image acquisition,type of image, landmark coordinates, etc. Onyx Ceph™ additionally manages a separate patient card index, that may be synchronizedwith the patient card index of linked third party systems (practice management, digital X-ray...). The concept of the Onyx Ceph™ data base presumes that each patient has an individual(unique, unchanging) patient record ID. This ID is a string with max. 20 characters and it isnot case-sensitive. Blanks and the characters ? * / \ | : " are not allowed.

The system Onyx Ceph™ consists of the autonomous software modules:

OnyxCeph Orthodontic AnalysesOnyxPVL Analyses EditorOnyxPrint Print Module

The modules OnyxCeph and OnyxView can be started by a third party (e.g. practicemanagement) software.

Onyx Ceph™ supports the synchronization of patient card file index entries via



communication file. Nevertheless, this interface has to be implemented in the practicemanagement. Data synchronization is only performed when OnyxCeph™ (OnyxView) is started by theexternal software. Onyx modules can be started several times because it is analyzed if thesoftware is already running. In this case the application is displayed in front of the Windowsdesktop and the patient data is updated.

This is the fundamental approach to send patient record data from a management softwareto Onyx Ceph™:

1. Read filepath and filename of the temporary patient-data-file from the Onyx.ini-file 2. Write the temporary patient-data-file with the valid (active) patient data3. Read the filepath of OnyxCeph™ (OnyxView) from the onyx.ini4. Start OnyxCeph™ (OnyxView) together with the patient-ID as first command lineparameter

Optionally, the management software can

· read images from Onyx· open findings directly· write finding results to the patient record· create new finding (if the image already exists)

3.1.1.1.2 Module Calls

Both modules (OnyxCeph™, OnyxView) are completely autonomous Windows applications(9x, Me, NT, 2000, XP) and can be started by CreateProcess() or WinExec(). The modulepath can be read from the file onyx.ini (see topic 4).The temporary patient-data-file has to be generated by the management software before themodule call is sent. The file is immediately deleted by OnyxCeph™ after the call was treated.The module call command line syntax is:

OnyxCeph [PPPPP [BBB]] | PPPPP patient record ID (max. 20 characters) Four types of module calls are supported:

(1) To start Onyx Ceph with the latest finding /photo of the active patient:

Module call: OnyxCeph PPPPP

Onyx will check if the active patient already exists in the internal patient card index. Ifnot, the patient data is read from the temporary patientdatafile (see below) and thepatient record is added. (see topic 4).The latest finding /photo for the active patient is displayed.

(2) To create a new finding for the active patient (only module OnyxCeph) using a newimage:

Module call: OnyxCeph PPPPP -1

Onyx will check if the active patient already exists in the internal patient card index. Ifnot, the patient data is read from the temporary patientdatafile (see below) and thepatient record is added. (see topic 4). A new finding is created and the 'Select Image Type' dialog is opened.

(3) To create a new finding for the active patient using an image that already exists in Onyx:

Module call: OnyxCeph PPPPP –2 (image is copied)OnyxCeph PPPPP –3 (image is deleted)



Onyx will check if the active patient already exists in the internal patient card index. Ifnot, the patient data is read from the temporary patient-data-file (see below) and thepatient record is added. (see topic 4). A new finding is created for the image handed over.Filepath and filename of the image file have to be read from the Onyx.ini in capture [Communication] entry PicDat (see topic 4). This entry is deleted immediately afterthe module call is treated.

(4) To start OnyxCeph™ with a special finding of the active patient:

Module call: OnyxCeph PPPPP BBB

Onyx will check if the active patient already exists in the internal patient card index. Ifnot, the patient data is read from the temporary patient-data-file (see below) and thepatient record is added. (see topic 4).The finding BBB for the active patient is displayed.

(5) To start OnyxCeph without patient selection:

Module call: OnyxCeph

Only a patient record which already exist in Onyx can be opened.

Format temporary patient-data-file:The text file is used to send patient data to Onyx. The calling software has to provide thisservice each time a patient should be handed over to OnyxCeph™. Thereafter, Onyx verifiespatient record data resp. creates a new patient record.

There are 5 lines in the file:

12345 //1: patient-ID (max. length 20 characters)19340430 //2: date of birth (ISO date conversion yyyymmdd)M //3: Gender: Male or FemaleExample //4: namePaul //5: first name

Filepath and filename of the temporary patient-data-file are fixed in the onyx.ini in parameter PatDat in section [Communication]. After import is completed, Onyx will delete this file.

Patient data is only handed over to Onyx if the module call is sent with parameter patient-ID.The patient record is only created or opened in Onyx-Ceph if the patient-ID is added to themodule call as command line parameter.

3.1.1.1.3 Results

All calculated finding results and all of the actions carried out during the processing of thefinding are saved as patient-result-file in txt-format. Path and name of this file can be foundas parameter Results in section [Communication] of the onyx.ini-file.New data is merged to the patient-result-file which can comprise data of multiple patientsand findings. Data reading and deleting has to be ensured by the calling software.

The patient-result-file entries are single lines with the following structure of ANSI -characters:

PPPPPPP:TTMMJJJJIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIINN

PPPPP PPPPP patient record ID (max. 20) followed by ":" TTMMJJJJ 8 characters for date III...II 0-80 characters for finding information to be handed over to the patient record



in the management software NN: 2 characters for linefeed (0x0D, 0x0A)

3.1.1.1.4 Image Files

The finding images are saved in different image file formats. Actually, image files are savedas BMP, CMP (LEAD), JFIF, JPEG, or TIFF. Image resolution, image size, imageconversion (RGB, palette) are not fixed. The structure of the image file name contains image related information:

Filename: PPPPPABBB.FFF

PPPPP: patient record IDA: image type; X cephalometric X-ray (lateral or frontal) M cast (deciduous, mixed or permanent dentition) F facial photo (lateral or frontal) H hand X-ray O OPT (panoramic view X-ray) U user-defined image

E external imageBBB: finding ID; continuously incremented integer for each patient

For each patient up to 1000 findings can be created.

Example: 1893F004.cmp

patient record ID: 1893image type: facial photofinding ID: 4

Using file filter 1893????.* all image files for patient record ID 1893 in the active folder arereturned.The file onyx.ini must exist in the Windows-directory of the PC, where OnyxCeph™ shouldbe started. Beside other parameters, this text file provides information which is needed forthe data exchange between Onyx and the calling application (e.g. management software). Below heading [Module] the location of each module is stored: OnyxCeph = location of OnyxCeph.exeOnyxView = location of OnyxView.exeOnyxPVL = location of OnyxPVL.exe

If one of these lines is empty or does not exist, the corresponding module is not installed. In section [Communication] the files for the data exchange between Onyx and the callingapplication (e.g. management software) are defined. PatDat = Filepath and filename of the temporary patient-data-fileResultate = Filepath and filename of the temporary result-data-filePicDat = Filepath and filename of the image file to be handed over to Onyx

In section [Database] information on location of patient data base and image data base isfixed. The image data base is specified by two directories:

PicDBSave= Name of the folder where image data should be saved inPicDBSearch= Names of the folders where image data should be searched,

single entries are separated by ";"

By means of the separation in PicDBSave and PicDBSearch it is possible to structure theimage data base.



3.1.1.2 Interface Configuration

In Onyx Ceph™ click on menu item Options|External programs.

In addition to the items that are already available in the menu point "Go to" another fiveitems can be defined by the item Options|External Programs. So easy and quick changingbetween Onyx Ceph™ and further programs or documents is possible. Thereupon, handingover of master data from Onyx Ceph™ to the called program is supported. Configuring suchlinkages is done by the help of the dialog of the option External Programs.

To configure the Onyx Ceph™ PMS interface, use first file card Practice Management. Fill inthe name of the practice management software and activate the 'Item Visible' checkboxwhich creates a link to the application in menu item Go to. (Up to now this item does not have any functions. It must be configured by the help of theactions 1 to 4 first.) The activated functions are processed in the following sequence when the program isstarted:

Onyx Ceph™ supports handing over of the master data of the currently selected patient toexternal programs. The information is handed over as formatted text: Onyx Data (mark for identification as Onyx Ceph™ master data) PatID (patient number)



Name (family name of the patient) First Name (first name of the patient) DOB (birthday, format YYYYMMDD) Gender (M for male, F for female) FindingID (code of the finding currently opened in Onyx Ceph™)

These seven lines are written to the stated file and/or to the Windows clipboard. Thereupon,the content of the file as well as the clipboard are overwritten.

Most programs recognize being already active in the case of starting them twice. They onlybring the active program to the foreground then. Several programs, however, do not realizethat. They allow starting the program twice which unnecessarily wastes resources. In orderto avoid this the name of the main window of a program can be inserted in the relevant fieldof the second section of the dialog. Onyx Ceph™ will look for and activate this window. Owing to the class name being undocumented or unknown in most of the cases OnyxCeph™ supports the search by the help of thebutton. Therefore, please start the program to be activated and click on this button. After thatselect the program on the desktop and position the mouse pointer on the title of the mainwindow for five seconds. Thereupon, the class name is taken over to the edit field. In addition the title of the window can be stated. Onyx Ceph™ will search for a window withthe given name and title. Please note that the title has to correspond exactly. In manyprograms the title changes during object time so that Onyx Ceph™ could not find it.Normally stating the class name should be enough.

By the help of this item a message can be sent to which another program can react. Thisfunction requires cooperation of the external program because the message has to beintercepted and processed by it. Onyx sends: SendMessage (HWND_BROADCAST, RegisterWindowMessage(MessageString), 0, 0); Further information to this subject you find in the Windows API documentation.

This is the most common method to start an external program. In the file field a program oran arbitrary file can be stated. If a program is stated this will be started. If a file is statedOnyx Ceph™ will search for a program associated to the given type of file. If a program isfound the relevant file of this program will be opened.

possible entries in the file field: c:\Windows\Pbrush.exe (starts the Windows drawing program) c:\MyFiles\Memos.doc (opens the file Memos.doc in MS-Word) www.onyx-ceph.de (opens the address in the internet browser) c:\ (opens the directory c:\ in the Windows explorer)

In the parameters field start parameters can be stated which will be handed over when theexternal program is called. In order to insert information about the currently selected patient into these parameters (e.g.



for patient selection in the external program) the jokers %1 to %6 can be used. Theseplaceholders are replaced by the relevant patient data as soon as the external program iscalled: %1 patient number %2 family name of the patient %3 surname of the patient %4 birthday, format YYYYMMDD %5 gender (m for male, f for female) %6 findingID (code of the finding currently opened in Onyx Ceph™)

e.g.: name: note file: NotePad.exe parameter: "c:\Patients\%1.txt"

By the help of this configuration the file "patient number.txt" in the path c:\Patients\ is openedby the help of the Windows notepad as soon as the item note in the menu point is selected.In this way patient related data can be easily managed.

Hint: There is no need to activate all actions. Usually one action is enough. If more than oneaction is activated they are executed one following the other. If the actions 2 or 3 aresuccessfully executed processing is aborted and the program stated in action 4 will not bestarted.

Practice management In the first tab sheet it can be configured if the results of the analyses are to be handed overto the practice management program. If this field is activated the itemCommunication|Practice management can be selected in the menu of Onyx Ceph™. Thenthe results of the current analysis or of all analyses can be handed over to the patients filecard in the practice management program provided that this program supports suchfunctions. Please contact the manufacturer of your program. Further information to thisfreely approachable interface is available on: http://www.onyx-ceph.de/installation.html



3.1.2 VDDS Media Interface

The VDDS interface permits the exchange of patient master data between patient- andimage management programs which both support the VDDS standard.

For activating the data exchange between Onyx Ceph™ and the used patient managementprogram the file OnyxVDDSServer.exe in the Onyx-Server path has to be executed. In thedialog merely the interface has to be activated and the used patient management programhas to be selected from the list.

InterfacesDigital XRay 35


3.2 Digital XRay

3.2.1 Duerr Dental - DBSWin

3.2.1.1 Settings in Onyx Ceph

In Onyx Ceph™ click on the menu item Options|Digital X-ray.

In the file card DBSWin enter the program path by the help of the browse button. Thereafter,activate the checkbox Duerr Dental DBSWin – support activated. Activate further options ifrequired:

Panel DBSWin database

By means of the button [test] the database access can be verified for patient data andimages.

3.2.1.2 Settings in DBSWin

No special settings of the software are necessary. The only requirement is an executableversion of the DBSWin software on the local computer.



3.2.1.3 Capturing Images

If the settings have been done as described before, in Onyx Ceph™ you can display, selectand import any image from the DBSWin image database to the patient that is active in OnyxCeph™:

(1) Open the image import dialog by means of the menu item Patient|New image (or Strg+B)in Onyx Ceph™ and click on the button Digital X-ray.

(2) All patient related images in the DBSWin database will be listed. Select the image to beimported and click on [Adoption] after you have corrected the image alignment if necessary.



3.2.2 Duerr Dental - VistaScan Easy



In the file card VistaScan enter the program path by the help of the browse button.Thereafter, activate the checkbox Duerr VistaScan Easy – support activated. Activate furtheroptions if required.

3.2.2.2 Settings in VistaScan Easy

No special settings of the software are necessary. The only requirement is an executableversion of the VistaScan Easy software on the local computer.


The scanning procedure is initiated by the button Digital X-ray of the image acquisition dialog(menu item Patient|New Image). The VistaScan program surface is opened and the scandialog is displayed.

DirectScan works without access to the DBSWin database. That means that the directlyscanned image is not available in the DBSWin database but is only stored in the Onyxpatient card file.



3.2.3 Gendex - VixWin



In the tab sheet VixWin enter the program and database path by the help of the browsebutton. Activate the support of the interface by the checkbox Gendex VixWin – Support activated and select further options.

Panel VixWin pluginActivation of the checkbox show and activate Onyx plugin in VixWin 2000 results inactivating and displaying of Onyx Ceph™ as external program in the VixWin 2000 menuitem External Programs. This permits handing over of patient and image data by the help ofthe Windows clipboard. The VixWin patient database can store several patient IDs for eachpatient:

an internal patient ID that is only used within VixWin and normally is not visiblethe insurance number entered into the relevant fieldthe external patient ID entered into the field "patient ID"

Onyx uses this external patient ID.In a few special cases it can be necessary to use the internal instead of the external patientID. This can be achieved by activation of the checkbox adopt internal VixWin patient ID.Attention! Once set this item must not be changed as otherwise patients would be storedtwice.

Panel VixWin databaseActivation of the checkbox VixWin patient management active activates the internal VixWin



patient management for patient data hand over to Onyx Ceph™.Activation of the checkbox load Images from VixWin-image Database results in display ofthe images that are available in the VixWin database in the patient-related image databaseof Onyx View™, too.Click on the button Search if all images of the VixWin-image database should be attributedto the patients of the Onyx Ceph™ - database. Hint: Allocation requires unequivocal congruence of the patient master data. All manualallocations (e.g. deviations in birthday or spelling) will get lost. Because of that reasonupdating should only be done if new interfaces have to be installed or a new databaseshould be integrated.

Panel Direct ScanAlternatively to using the VixWin-Database the Gendex-Scanner also can be used as pureimage source. Activating the checkbox save a copy of each image in the VixWin systemresults in a copy of each image that was scanned to Onyx Ceph™ in the VixWin database.Pay attention that double disk space is needed for this option.Select one of the available image formats (recommended: JFIF 100%)

Finally, confirm the settings by OK.

3.2.3.2 Settings in VixWin 2000

If the settings in Onyx Ceph™ have been inserted correctly all necessary entries in theVixWin 2000 menu option Options|PlugIns in the tab sheet Onyx Ceph will already be done.

In the VixWin 2000 menu option Plugins the item Onyx Ceph should be available.


If all settings are done according to the above hints, the software Onyx Ceph™ supports allways of data exchange provided by VixWin.



· You can hand over images together with the appurtenant patient data to Onyx Ceph™ viaclipboard.

· You can display, select and adopt the images available for the current patient in theVixWin database in Onyx Ceph™.

· You can use the Gendex scanner as independent image source.

3.2.3.3.1 Clipboard

Put the image to be evaluated in Onyx Ceph™ to the clipboard. For that purpose simplyselect the relevant image in VixWin and click on the menu item External Programs|OnyxCeph.

If the active patient is already available in the Onyx Ceph™ - patient card file the dialogSelect Image Type appears and you can go on as usual when recording and evaluating a

finding. Onyx Ceph™ automatically opens the appropriate patient record.

If the active patient is not yet available in the Onyx Ceph™ - patient card file first the dialogfor handing over of master data is opened. Please complete the entries in the fields, ifnecessary.By a mouse click on the question mark right beside the field Patient ID the next free ID isprovided.

3.2.3.3.2 Patient Record


(2) All patient related images in the VixWin 2000 database will be listed. Select the image tobe imported and click on [Adoption] after you have corrected the image alignment ifnecessary.

3.2.3.3.3 Onyx View

Use the menu item Go to|Onyx View in Onyx Ceph™ to open or activate the imagedatabase Onyx View™. Here, all digital images belonging to the active patient can bedisplayed – even those in the VixWin 2000 image database. Focus the desired image andclick on the context menu item new finding.

Thereupon, a new finding is created for the image in Onyx Ceph™.



3.2.4 Instrumentaruim Imaging - Cliniview

3.2.4.1 Settings in Cliniview

No special settings of the software are necessary. The only requirement is an executableversion of Instrumentarium Imaging CliniView on the local computer.

The interface to the CliniView database is realized by a special module (PracticeManagement Software Interface - PMSIF) that should be activated by the InstrumentariumImaging service. If required you can find an executable module on the Onyx Ceph™installation CD under the item Install Tools | Interface to Instrumentarium Imaging (copy themodule to the system directory ...\Image Instruments\OnyxServer\). After that the OnyxCeph™ program will automatically activate the module.

Please note Instrumentarium Imaging requires the following BDE settings if the module is used togetherwith CliniView 3.0 on Windows 2000 or Windows NT operating systems:SHAREDMEMLOCATION = 0x7bde (via Start | Settings | Control panel | BDE Administrator:Configuration -> System -> INIT)



In the file card CliniView enter the program path by the help of the browse button.Thereafter, activate the checkbox Inst. Imaging CliniView – support activated. Activate



further options if required:

Panel CliniView database

· Activating the checkbox equalize data on handing over causes that patient data issynchronized automatically if different master data is available in both databases foridentically patient record IDs. Otherwise, the synchronization can be done manually.

· Activating the checkbox use internal CliniView patient ID causes that the search requestis performed by means of the internal CliniView patient ID (which can be edited) insteadof the patient record ID. It is strongly recommended not to create new patient recordsinternally in CliniView but to hand over patient records from management systems toensure identically patient record IDs because searching patients by internal IDs is muchmore time consuming.

By means of the button [test] with a valid patient record ID the database access can beverified for patient data and images.


If the settings have been done as described before, in Onyx Ceph™ you can display, selectand import any image from the CliniView image database to the patient that is active in OnyxCeph™:


(2) All patient related images in the CliniView database will be listed. Select the image to beimported and click on [Adoption] after you have corrected the image alignment if necessary.



3.2.5 Morita

We recommend to operate the Morita Ceph Xray unit under Digora for Windows software.See item Soredex - Digora for configuration hints.



3.2.6 Orex - Digident

3.2.6.1 Settings in Dent-A-View

No special settings of the software are necessary. The only requirement is an executableversion of the Dent-A-View software with an USB interface on the local computer.



In the file card for Digident set the Dent-A-View program path and the path for the Digidentimage transfer file by the help of the browse button [...]. Thereafter, activate the checkboxDigiSys Digident – support enabled.

Activate further options if required.

3.2.6.3 Capturing images

If the settings have been done as described before, in Onyx Ceph™ You can display, selectand import any image from the Digident image database to the patient that is active in OnyxCeph™:




(2) All patient related images in the Digident database will be listed. Select the image to beimported and click on [Adoption] after you have corrected the image alignment if necessary.



3.2.7 Planmeca - Dimaxis

3.2.7.1 Settings in Dimaxis

No special settings of the software are necessary. The only requirement is an executableinstallation of a Dimaxis version on the local computer.



In the file card for Planmeca set the Dimaxis program path by the help of the browse button[...].

If Dimaxis was correctly installed in step 1, all necessary settings will be automatically doneafter that. Otherwise change the name of the database in the edit field or use the button [...]beside the relevant field for changing the path of the thumbnails. By means of the button [test] with a valid patient ID the database access can be verified forpatient data and images.

Activate support of the interface by marking the checkbox Dimaxis Planmeca – supportactivated.

Panel hand over Onyx master data

Activating the checkbox new patients / changes causes that changes to the patient record in



Onyx Ceph™ will be hand over to Dimaxis automatically.


If the settings have been done as described before, in Onyx Ceph™ you can display, selectand import any image from the Dimaxis image database to the patient that is active in OnyxCeph™:


(2) All patient related images in the Dimaxis database will be listed. Select the image to beimported and click on [Adoption] after you have corrected the image alignment if necessary.



3.2.8 Sirona - Sidexis

3.2.8.1 Settings in Sidexis

3.2.8.1.1 Step 1

Click Utilities – System setup... – Service... and enter the service-password.(for login use date DdMm from the right to the left: mMdD)

In the panel Database check the Path for the database and activate both checkboxes"Multistation capability" and "Further communication partners". Click on the button"Multistation..." to continue with step 2 and thereafter on button "Partners..." to continue withstep 3.

3.2.8.1.2 Step 2

Activate both checkboxes "Orders can be produced here" and "Orders can be acceptedhere". Refer to the Sidexis manual for the configuration which is needed to accept orders bya sidexis client.



3.2.8.1.3 Step 3

In the dialog Configure communication partners, click on New and overwrite Name:unknown with Onyx Ceph (recommended), and fill in c:\sidexis\slot\onyx.sdx(recommended) as Mailbox file. Activate the checkboxes "Patient database" and Image"Exchange".





In the file card Sidexis enter the program path by the help of the browse button. Thereafter,activate the checkbox Sirona Sidexis – support enabled. If Sidexis is correctly installed allnecessary entries will be inserted automatically. Activate further options if required:

Because Sidexis manages images "upside down", the checkbox adjust image on handingover to Onyx (tilt) enables to tilt images by default. Since the image direction can be adjustedindividually by import, usually the checkbox should remain empty.


· Activating the checkbox changes causes that changes to the patient record in OnyxCeph™ will be hand over to Sidexis automatically.

· Activating the checkbox new patients causes that new patient records in Onyx Ceph™will be hand over to Sidexis automatically.

· Clicking the button all patients causes that all patient records in Onyx Ceph™ will behand over to Sidexis. Do not use this option in case of large data bases !!!

Panel searching Sidexis - images

· Activate the checkbox support vowel mutations to identify patient names with Germanumlauts in the Sidexis Image database.

· Click the button update to hand over all images in the Sidexis image database to theappropriate patients in Onyx Ceph™.



Hint: Automatic handing over is only performed if the patient record is identically. Use thisoption only when installing the interface, because manual imported data may be deleted inthe Onyx Ceph™ data base.


If the settings have been done as described before, in Onyx Ceph™ all possibilities for dataexchange provided by Sidexis are supported:

· You can hand over a Sidexis image via Mailslot to Onyx Ceph™.· You can display, select and import any image from the Sidexis image database to the

patient that is active in Onyx Ceph™.

3.2.8.3.1 Mailslot

(1) Put all images which should be traced in Onyx Ceph™ into the Sidexis mailslot. You canexport several images of different patients by means of one mailslot. These data is saved infile sidexis.sdx and not deleted even if Sidexis is closed.

(2) Open the Sidexis Mailslot by the menu item Patient|Select patient|Mailslot (or Strg+M) in Onyx Ceph™.

(3) Select the image to be imported and click on [Adoption] after you have corrected theimage alignment if necessary.

(4) If the patient already exists in Onyx Ceph™, the image is imported without patient recordverification and the appropriate patient record is opened.

3.2.8.3.2 Patient record

(1) Open the image import dialog by means of menu item Patient|New image (or Strg+B) inOnyx Ceph™ and click on button Digital X-ray.

(2) All patient related images in the Sidexis database and in the mailslot will be listed. Selectthe image to be imported and click on [Adoption] after you have corrected the imagealignment if necessary.



3.2.9 Soredex - Digora

3.2.9.1 Settings in Digora

No special settings of the software are necessary. The only requirement is an executableversion of Soredex Digora for Windows (DfW) on the local computer.



In the file card Digora enter the program path by the help of the browse button. Thereafter,activate the checkbox Soredex Digora – support enabled. Activate further options if required:


· Activating the checkbox new patients / changes causes that changes to the patientrecord in Onyx Ceph™ will be hand over to DfW automatically.

· Clicking the button all patients causes that all patient records in Onyx Ceph™ will behand over to Digora. Do not use this option in case of large data bases !!!




If the settings have been done as described before, in Onyx Ceph™ you can display, selectand import any image from the Digora image database to the patient that is active in OnyxCeph™:

(1) Open the image import dialog by means of the menu item Patient|New image (or Strg+B)in Onyx Ceph™ and click on button Digital X-ray.

(2) All patient related images in the Digora database and in the mailslot will be listed. Selectthe image to be imported and click on [Adoption] after you have corrected the imagealignment if necessary.



3.2.10 Trophy

Trophypan-C interface is provided via VDDS. For questions, please contact Image Instruments directly on [email protected].


Onyx Ceph™ Software development

Image Instruments GmbHOlbernhauer Str. 509125 ChemnitzPhone +49 371 9093 140Fax +49 371 9093 149Email [email protected]

onyx · pdf filecontent i content release 1 ipreface 3 iiinstallation 5 1overview

Documents