Setting up the acquisition agent

Because Dentrix Ascend Imaging is a web-based application, it is available immediately for use once you have purchased it and it is enabled by Henry Schein One. However, for each computer that you want to acquire images from, you must install the following on that computer:

• Drivers - The drivers for the intraoral and/or extraoral acquisition devices that you want to use. For the complete list of acquisition devices that are supported by Dentrix Ascend Imaging, see "Supported Acquisition Devices."

• Acquisition agent - A small application that runs in the background and handles the communication between your acquisition devices and Dentrix Ascend Imaging. You do not need to install the acquisition agent on computers that you will be using to only view images.

  Note: During the installation of the acquisition agent, a security certificate is installed automatically to allow for secure communication between the browser running Dentrix Ascend Imaging and the acquisition agent.

Setting up the acquisition agent consists of the following three tasks:

• Downloading

• Installing

• Configuring

Downloading

You can download the acquisition agent installer by attempting to acquire an image on a computer that you want to use to acquire images. A message will appear and provide you with a link to download the acquisition agent installer.

Note: Alternatively, you can access the link to download the acquisition agent installer in Dentrix Ascend. On a computer that does not have the acquisition agent installed, open the Document Manager while viewing any patient's record, and then click (or tap) Scan.

To download the acquisition agent

1. Attempt to acquire an image (see "Acquiring Images").

   If the acquisition agent is not installed, the Acquisition Activation dialog box appears.

   

2. Click (or tap) the Click here link to download the acquisition agent installer.

3. Click (or tap) Done.

4. When the download is complete, you can install the acquisition agent.

Installing

You must install the acquisition agent on each computer that you want to use to acquire images. Complete the steps that correspond to the operating system of the computer that you are installing the acquisition agent on: Windows or Macintosh.

Notes:

• (Windows only) Prior to installing the acquisition agent, verify that the Microsoft .NET 4.0 framework is installed. If .NET 4.0 is not installed, you must install it before you attempt to install the acquisition agent.

• Before attempting to install the acquisition agent, you should be logged on to your operating system (Windows or Macintosh) as a local administrator (not as a domain administrator).

To install the acquisition agent (Windows)

1. Run Acquisition Agent Installer.exe.

2. On the welcome screen, click (or tap) Next.

3. On the Choose Components screen, leave Acquisition Agent selected, and then click (or tap) Next.

4. On the Choose Install Location screen, leave the default Destination Folder selected, or click (or tap) Browse to select a different location. Then, click (or tap) Install.

5. On the completion screen, click (or tap) Finish.

6. After installing the acquisition agent, you can install the drivers for your acquisition devices and change the default settings of the acquisition agent (even though the defaults should suffice).

To install the acquisition agent (Macintosh)

1. Run Acquisition Agent Installer.pkg.

   Troubleshooting: If an error with the message "Acquisition Agent Installer.pkg can't be opened because Apple cannot check it for malicious software." appears, complete the following steps:

   1. With the error message still open, open the System Preferences.

      

   2. Select Security & Privacy.

      

   3. On the General tab, click the lock icon.

      

   4. If you are prompted to do so, enter your MacOS User Name and Password, and then click Unlock.

   5. Under Allow apps downloaded from, select App Store and identified developers.

      Note: The error message needs to be open to see this option.

   6. Click Open Anyway, follow the prompts, and eventually the acquisition agent installer should start.

2. On the Introduction screen, click Continue.

3. If the Destination Select screen appears, select the disk where you want to install the program. Then, click Continue.

4. On the Installation Type screen, click Install.

5. If the system prompts you to do so, to allow the installer to install the program, enter your MacOS User Name and Password, and then, click Install Software.

6. On the Summary screen, click (or tap) Close.

   Note: After installation, the acquisition agent starts automatically. The first time the acquisition agent starts, it will need 90-120 seconds to finish its configuration. When acquisition agent icon stops bouncing, the configuration is complete.

7. After the initial configuration is complete, right-click the Acquisition Agent icon on the dock, point to Options, and then select Open at Login if the option does not already have a check mark next to it.

   

8. Restart the computer to finish the required setup.

9. After installing the acquisition agent, you can install the drivers for your acquisition devices and change the default settings of the acquisition agent (even though the defaults should suffice).

Configuring

If you need to change the default settings of the acquisition agent (even though the defaults should suffice), after you complete the installation, configure the acquisition agent's options as needed. Complete the steps that correspond to the operating system of the computer that you are configuring the acquisition agent on: Windows or Macintosh.

To configure the acquisition agent (Windows)

1. Click (or tap) the Acquisition Agent icon in the notification area of the Windows taskbar, and then click (or tap) Preferences.

   

   The Preferences dialog box appears.

2. Set up any of the options on the following tabs as needed:

   • General

     General tab

     

     • Joystick - If you use a "Generic" intraoral camera with a joystick button interface instead of proprietary buttons, select the Use Joystick with Generic Camera check box. The camera button will use a specific joystick number. This is typically zero if no other joysticks are installed on the computer. Enter a number from 0 - 10 for Joy Number.

       Note: If you use a Digital Doc camera, and it has been installed to use a port other than zero, you must specify the appropriate joystick number.

     • Still Pin - If you use a "Generic" intraoral camera with a still pin to initiate captures, you must install still pin support for that camera. Make sure that the camera is plugged in and that all the necessary drivers for that device are installed before you attempt to install still pin support. Click (or tap) Install Still Pin Support, click (or tap) OK on the message that appears, select the camera that you want to install still pin support for, and then press the Enter key when the installation is complete. The Use still pin with Generic Camera check box is selected automatically, but you can clear the check box if at any time you decide that you do not want to use a still pin camera.

     • Grayscale JPEG Compression - By default, Dentrix Ascend Imaging uses PNG lossless compression for grayscale images (intraoral and extraoral X-ray images). For each acquisition device, you can specify whether Dentrix Ascend Imaging should use JPEG lossy compression on X-ray images. The JPEG lossy compression that Dentrix Ascend Imaging uses has been optimized for grayscale images and uses a Q factor of 96 to obtain near-perfect-quality images. To specify the compression method for a device, select that Device, and then select or clear the Use JPEG Compression check box. Repeat this as needed for any other devices.

     • Alternate Button Workflow - For the following intraoral cameras, you can specify whether you want to use an alternative functionality for the capture button or use the standard functionality: generic cameras, DEXcam 3 and 4 cameras, Sopro cameras, and Digital Doc Iris and Iris HD cameras. With the alternative button functionality enabled for a camera, after you push the button once to freeze the video stream, you either push once to capture the image or push twice to not capture it. The standard functionality does not support pushing the button twice to not capture the video frame. To specify the button functionality for a camera, select that Device, and then select or clear the Use Pause/Capture Workflow check box. Repeat this as needed for any other devices.

     • Show Log Files - The acquisition agent logs actions that it performs for debugging, troubleshooting, and performance monitoring. To view the log, click (or tap) Show Log Files.

   • Digital Sensor

     Digital Sensor tab

     

     • DEXIS:

       • Use Binned Acquisition - In the Dexis imaging software (versions 9 and 10), "binned" is the default operating mode for Dexis sensors, so this check box is selected by default for Dentrix Ascend Imaging.

       • Correction Path - This is the location of the calibration files for Dexis sensors. The default is C:\Dexis\Flashdir.

     • Hamamatsu Correction Path - This is the location of the calibration files for Hamamatsu sensors. The default is C:\Program Files (x86)\Acquisition Agent\Correction Files.

     • e2v Correction Path - This is the location of the calibration files for e2v sensors. The default is C:\Program Files (x86)\Acquisition Agent\Correction Files.

     • Hamamatsu - The Gamma correction value defines the relationship between a pixel's numerical value and its actual luminance; use it to redistribute the tonal levels of a raw image to be closer to how human eyes perceive them (on a standard monitor). The Integration Time, Incidence Threshold, and Integration End Threshold options determine how Dentrix Ascend Imaging control the integration timing and triggering of sensors. You may want to change these settings if, for example, you use a low-dose, portable X-ray machine.

     • Planmeca - For Planmeca sensors, "binned" is the default operating mode, so the Use Binned Acquisition check box is selected by default for Dentrix Ascend Imaging.

     • e2v Settings - Click (or tap) the button to configure the following settings for size 1 and size 2 e2v sensors:

       • Use Binned Acquisition - Controls whether "binned" operating mode is on or off.

       • Sensor Gain - Controls the output signal strength from sensors.

       • Integration Time - Determines how Dentrix Ascend Imaging controls the integration timing of sensors. You may want to change this if, for example, you use a low-dose, portable X-ray machine.

       • Triggering Level - Determines how Dentrix Ascend Imaging controls the triggering of sensors. You may want to change this if, for example, you use a low-dose, portable X-ray machine.

       • Gamma Level - Defines the relationship between a pixel's numerical value and its actual luminance; use it to redistribute the tonal levels of a raw image to be closer to how human eyes perceive them (on a standard monitor).

       • Do Not Use Sensor Calibration Files - Controls whether the sensor calibration files are used or not.

   • Phosphor Plate

     Phosphor Plate tab

     

     • ScanX - These are filters to use with a ScanX phosphor plate scanner. The Gamma correction value defines the relationship between a pixel's numerical value and its actual luminance; use it to redistribute the tonal levels of a raw image to be closer to how human eyes perceive them (on a standard monitor). The Intraoral Mode, Panoramic Mode, and Cephalometric Mode values indicate the scanning modes being used for intraoral, panoramic, and cephalometric images, respectively. The mode affects image resolution.

     • Optime Settings - Click (or tap) the button to configure the IAM settings for an Optime scanner.

     • OP30 Settings - Click (or tap) the button to configure the IAM settings for an OP30 scanner.

     • VistaScan - The Device Type (the default is IMDA) and the Registered Device of a VistaScan scanner. You can leave the Registered Device box blank to use the first device found that matches the specified type.

   • TWAIN

     TWAIN tab

     

     • TWAIN - The Use Buffered TWAIN Transfer option is selected by default as the transfer method for images from acquisition devices that use a TWAIN driver. If there are issues with TWAIN sources delivering images properly to the acquisition agent, clear this check box to use the native transfer mode, which some TWAIN sources require or recommend.

     • TWAIN Categories - For each TWAIN source, you can specify the applicable acquisition types. Select a TWAIN source from the Device list, and then select the applicable acquisition types (Digital Sensor or Phosphor Plate, Panoramic, Cephalometric, and/or Intraoral Camera). The selected TWAIN source will only be available for selection in the device list when someone is acquiring images for one of the selected acquisition types. Repeat this as needed for any other TWAIN sources.

     • TWAIN Rotation - For each TWAIN source, you can specify the default orientation (rotation and/or flip) to apply to images by acquisition type prior to those images being delivered to Dentrix Ascend Imaging. Select a TWAIN source from the Device list, select an acquisition type (Digital Sensor, Phosphor Plate, Panoramic, Cephalometric, or Intraoral Camera) from the second list, and then select an orientation option (No Rotation, Rotate 90, Rotate 180, Rotate 270, Mirror, Rotate 90 + Mirror, Flip, or Rotate 90 + Flip) from the third list. Repeat this as needed for any other TWAIN sources.

   • Software Bridge

     Software Bridge tab

     

     • DEXIS - If someone selects the Dexis software bridge from the device list when acquiring an image, the Application Path (where the Dexis software is installed; the default is C:\DEXIS) and the Images Path (where the Dexis software stores images; the default is C:\DEXIS\DATA) must be correct, so Dentrix Ascend Imaging can open the Dexis software and have bi-directional communication with it. The Dexis software must be installed to use this software bridge.

     • SIDEXIS - If someone selects the Sidexis software bridge from the device list when acquiring an image, the Application Path (where the Sidexis software is installed; the default is C:\Program Files\Sirona\SIDEXIS4), the SLIDA Mailbox Path (the location of the SLIDA mailbox file; the default is C:\PDATA), the Ascend Mailbox Path (the location of the Dentrix Ascend mailbox file; the default is C:\ProgramData\Acquisition Agent), the SLIDA Mailbox File name (the default is siomin.sdx), and the Dentrix Ascend Mailbox File name (the default is Ascend.sdx) the must be correct, so Dentrix Ascend Imaging can open the Sidexis software and have bi-directional communication with it. The Sidexis software must be installed to use this software bridge.

     • Romexis - You can specify whether Dentrix Ascend Imaging imports the STL model file or not if someone selects the Romexis software bridge from the device list when acquiring a 3D model. With the Import STL Models check box selected, Dentrix Ascend Imaging will import the STL model file. This allows for rotating and zooming of the 3D model in Dentrix Ascend Imaging. With the Import STL Models check box clear, Dentrix Ascend Imaging will import a 2D snapshot image of the 3D model. The Romexis software must be installed to use this software bridge.

       Note: Because Dentrix Ascend Imaging cannot do all the things that a CAD/CAM software can do, whether or not you import the STL model file, you must do the ground design and editing of the 3D model in the Romexis software. If you do not care about having the STL model file uploaded to Dentrix Ascend Imaging for backup, disaster recovery, or sharing purposes, you may want only the minimal viewing capabilities of a 2D image in Dentrix Ascend Imaging.

   • Filters

     Filters tab

     

     • Acquisition Filters - For each acquisition device, you can specify a set of filters to apply to images to fine tune those images more than what Dentrix Ascend Imaging does by default. Select a Device, and then set up the following filters as needed:

       • Apply Gamma Correction - To customize this filter, select the check box, and then enter the amount of Gamma correction. The gamma correction value defines the relationship between a pixel's numerical value and its actual luminance; use it to redistribute the tonal levels of a raw image to be closer to how human eyes perceive them (on a standard monitor).

       • Apply Pre Smoothing - To customize this filter, select the check box, and then enter the Strength of the smoothing effect.

       • Apply Sharpening - To customize this filter, select the check box, and then enter the Effect and the Strength of the sharpening effect.

       • Apply Post Smoothing - To customize this filter, select the check box, and then enter the Strength of the smoothing effect after the sharpening filter is applied. The Apply Post Smoothing check box is available only if the Apply Sharpening check box is selected.

       Repeat this as needed for any other devices.

     • Schick Filter - You can specify the following types of sharpness adjustments to apply to an image that is acquired with a Schick device, according to the type of image that is acquired: General Sharpness, Endodontic Sharpness, Periodontic Sharpness, Caries Sharpness, and Hygiene Sharpness.

3. Click (or tap) Done.

To configure the acquisition agent (Macintosh)

1. Click the Acquisition Agent icon on the dock.

2. From the Acquisition Agent menu, click Preferences.

   

   The Acquisition Agent Preferences dialog box appears.

   

3. Set up any of the following options as needed:

   • Planmeca:

     • Use Binned Acquisition - For Planmeca sensors, "binned" is the default operating mode, so this check box is selected by default for Dentrix Ascend Imaging.

     • Import STL Model - You can specify whether Dentrix Ascend Imaging imports the STL model file or not if someone selects the Romexis software bridge from the device list when acquiring a 3D model. With the Import STL Model check box selected, Dentrix Ascend Imaging will import the STL model file. This allows for rotating and zooming of the 3D model in Dentrix Ascend Imaging. With the Import STL Model check box clear, Dentrix Ascend Imaging will import a 2D snapshot image of the 3D model. The Romexis software must be installed to use this software bridge.

       Note: Because Dentrix Ascend Imaging cannot do all the things that a CAD/CAM software can do, whether or not you import the STL model file, you must do the ground design and editing of the 3D model in the Romexis software. If you do not care about having the STL model file uploaded to Dentrix Ascend Imaging for backup, disaster recovery, or sharing purposes, you may want only the minimal viewing capabilities of a 2D image in Dentrix Ascend Imaging.

   • DEXIS Platinum - For DEXIS Platinum sensors, "binned" is the default operating mode for direct integration, so the Use Binned Acquisition check box is selected by default for Dentrix Ascend Imaging.

   • RealCloud HD1 - Dentrix Ascend Imaging can automatically detect the port that the RealCloud HD1 intraoral camera is using so the buttons function properly, or you can specify a port. By default, Auto-Detect is selected as the Port.

   • Grayscale JPEG Compression - By default, Dentrix Ascend Imaging uses PNG lossless compression for grayscale images (intraoral and extraoral X-ray images). For each acquisition device, you can specify whether Dentrix Ascend Imaging should use JPEG lossy compression on X-ray images. The JPEG lossy compression that Dentrix Ascend Imaging uses has been optimized for grayscale images and uses a Q factor of 96 to obtain near-perfect-quality images. To specify the compression method for a device, select that Device, and then select or clear the Use JPEG Compression check box. Repeat this as needed for any other devices.

   • Show Log Files - The acquisition agent logs actions that it performs for debugging, troubleshooting, and performance monitoring. To view the log, click Show Log Files.

4. Close the dialog box.