# DixelD.ds Installation and Operation Guide

The following page will guide you through the installation and operation of the DixelD.ds TWAIN wrapper for the Dixel driver.

## Caution

When operating the hardware, do not turn it off before the image has been fully imported into the application. Turning off and restarting the hardware will cause any current image data to be lost. Always ensure that the image has been stored within the application prior to turning off the hardware. The TWAIN driver window only shows a preview of the captured data. You must click the import button to ensure that the image is available in the application.

## Installation

Run the setup.exe program included on the installation CD. Follow the steps in the wizard to install the drivers and the DixelD Adjustment application.

Once copied, the selection `J. Morita Dixel Driver` will appear when selecting the scanner source in your image acquisition software of choice

## Operation

The following sections will describe how to acquire an image from the panorama device and transfer it to an application via TWAIN. Note that the DixelD driver supports at most one and only one image at a time and the TWAIN driver makes no attempt to buffer images as the desired storage format may change in the future rendering the buffered images useless. Also note that raw image data must be available on your PC in order to simulate an acquisition.

### Opening the Main Window

Once the driver has been installed and selected as the scanning source for the application, click `File->Acquire...` to open the DixelD.ds main window.
Figure 1: Inital DixelD TWAIN dialog.
At this point the DixelD.ocx is running and waiting for the image to be scanned from the panorama device. When this occurs, the ImageExists event will be posted to the TWAIN wrapper. The ocx and exe versions are displayed for reference.

To simulate the ImageExists event, click the `[Options...]` button to open the DixelD options dialog. Choose a raw image and then click `[OK]` to close the dialog. For an explanation of the functions and usage of this dialog, please refer to the manual that came with your hardware device.

### Simulating ImageExists

Figure 2: DixelD Options dialog
This dialog the DixelD options dialog whose operation is not modified in any way. Click the `[Execute]` button to simulate an image acquisition from the panorama unit.

### ImageExists

Once the ImageExists event has been posted, a preview of the acquired image is displayed in the main window along with the image dimensions for reference.
Figure 3: Acquired image ready for importing

At this time, no more images can be acquired by the DixelD driver. This behaviour is by design. Click the `[Import]` button to transfer the image to the application. When complete, the current buffered image will be deleted and the driver will return to its initial state shown above in Figure 1.

You may also clear the currently buffered image by clicking the `[Delete]` button. You will be prompted to confirm this operation before the image is actually deleted.

Once the image is imported, the application may close the TWAIN driver or leave it open to acquire additional images. This is up to the application's designer and not controllable by Dixel.ds. If the dialog remains open, you may close it by pressing the `[Close]` button in the lower-right of the window or by pressing the `[x]` in the upper-right. You may also close the window before or after an image has been acquired and the driver will close without transferring any data to the application.

## Uninstall

To uninstall the DixelD and TWAIN applications, open your Windows Control Panel and select Add/Remove Programs. Find the section for "DixelD" and choose "Remove". This will delete the drivers from your computer. Alternatively if you have access to the installation CD, you may also run the setup.exe program again which will give you the option of uninstalling DixelD.