LEADTOOLS Medical Workstation Viewer

The following sections describe how to configure and use the LEADTOOLS Medical Workstation Viewer:


Perform a Query / Retrieve Images

Storing Images on Remote DICOM Servers

Using the Workstation Listener Service

Workstation Client Configuration Overview



When running the LEADTOOLS Medical Workstation Viewer for the first time, the following message will be displayed:


LEADTOOLS Medical Workstation Viewer Database Configuration Wizard

  1. Start the Database Configuration Wizard, and click Yes.

  2. Choose the “Create new Databases” option if configuring a LEADTOOLS Medical Workstation Viewer for the first time. If you have already configured a medical workstation, you can choose the second option to connect to an existing database.

  3. Select the databases you would like to connect to or create. If this is your first time running this, ensure all databases are checked.

  4. Enter a user name and password, which will be used to create a LEADTOOLS Medical Workstation Viewer administrator account. When starting the LEADTOOLS Medical Workstation Viewer, you will be prompted to enter this user name and password. Click Next.

  5. You can connect to Microsoft SQL Server Compact, or click Change to choose a different data source. Next, click the 'Browse' button to choose a folder location to store the database file. When you are finished, click Next. Do this for each database selected in the previous screen. Click Next to advance to the next database.

  6. After you have set up each database, review the information in the summary. Click Back to go back and make any changes, or click Next to create each database.

  7. Once you see the following dialog, you have successfully created all of the databases. Click OK and then the Close button to close the application. This will then launch the PACS configuration demo.

  8. LEADTOOLS PACS Configuration Demo

    The PACs configuration demo allows you to configure each of the PAC servers. This initial dialog lets you know which settings are optional and which are required.

  9. Default AE Titles and ports are provided for each of the servers, but you can change these to any name or port number you like. Each port number must be unique. You can also have this demo automatically start each service.

  10. Default AE Titles and port numbers are provided for each of the clients as well. You may change these to any name or port number you like. Each port number must be unique. Check the “Reset Client Configuration” to reset any previous configurations. Otherwise the current configuration will be added to any previous configurations.

  11. Click Configure to create each of the services and configure each of the client demos. Click Remove to remove a service (you would do this during an uninstall).

    Click Close to close the demo. The Medical Workstation will then automatically launch.


LEADTOOLS Medical Workstation Viewer

When the viewer is launched for the first time (and whenever the PACS configuration is run again and the workstation reconfigured), you will have the opportunity to download a sample series stack in order to generate a 3D volume. Simply click on the link in the dialog and unzip the file.


The login dialog will then appear. Use what you entered in the database configuration wizard for the user name and password.


Perform a Query/Retrieve Images Operation from Local Database and Remote DICOM Servers and View Them in the Viewer Control.

  1. The "Search" Control is initially displayed as the default view.

  2. The search control lets you specify query parameters in order to search the available DICOM Studies/Series and view images.

  3. On the right side of the Search control above the Search button you can select whether you want to perform the query against a local database or a configured DICOM Server (source).

  4. Notice that on the initial run of the LEADTOOLS Medical Workstation Viewer, there will not be any information in the local database. However, notice that the “PACS Server” option is selected and populated with the DICOM server created previously.

  5. Click on the “Search” button to query the studies and series information on that server.

  6. You can view all the series images from a study by performing one of the following actions:

    1. Right-clicking on the study and selecting “Add all series to Queue Manager”

    2. Rght-clicking on the specified series and selecting “Add series to Queue Manager”.

    3. Double-clicking the series and selecting "Add series to the Queue Manager".

  7. When you add a series to the “Queue Manager” the Queue Manager dialog will open and show you the progress of the Move operation.

  8. You can configure the “Queue Manager” to load the retrieved images directly into the Viewer control. Also, you have the option to auto-clear the task from the list when an image is retrieved successfully.

  9. Note that any retrieved images will be automatically stored into the workstation database and now you can make a search and view them by selecting “Local Database” from the Search control.

  10. Click on the Viewer button from the toolbar located at the bottom of the window to view the retrieved images.


User Accounts

You can add new users into the workstation by clicking the “User Accounts” button on the toolbar located at the bottom of the window. Users can be either administrators or non- administrators.


A non- administrator does not have access to the Workstation Configuration or the Service Manager.

Service/Database Manager

  1. To add images directly into the database, click the "Service Manager" button on the toolbar at the bottom of the window.

  2. Click the "Database Manager " button on the toolbar at the top of the window.

  3. Use the Database Manager to perform the following tasks from the toolbar at the top of the window:

    1. Add a DICOM file

    2. Add a complete DICOM Directory

    3. Delete selected entries from the results grid view

    4. Clear the entire database

    5. View the status report

  4. You can also perform a search as if you were using the "Search" control.

  5. After adding images, close the Database Manager and return to the "Search" control.

  6. Select the "Local Database" option from the "Source" box and click the "Search" button.

  7. You can view a complete study's series or a specific study directly by right-clicking on the Study/Series and selecting "Add study to viewer" or "Open in Viewer".

  8. If you select "Add Series/Study to Viewer" the images will be loaded in the viewer but you will remain in the Search control. If you select "Open in Viewer" you will be navigated to the Viewer control.

Adding a PACS Server

  1. To add and configure a DICOM Server from which to search images, click the "Configure" button located on the toolbar at the bottom of the window.

  2. This will open the Configuration control for the workstation. The initial view contains configuration information for the workstation client. Click the "Remote PACS" button on the toolbar at the top of the application in order to display the PACS configuration.

  3. Click the "+ Add AE Title" button on the toolbar at the top of the window.

  4. Enter the information for one or more DICOM Servers on which you want to perform a query/retrieve operation. Note that the High-Level DICOM Server is already added to the list. You can also enter the low level DICOM server installed with the toolkit. Note that there is an option for “Default Storage”. This is for storing information from the local database to the server.

  5. To configure the DICOM Server with workstation client information (Add a client to the DICOM Server demo), click the Workstation Client Button and use the displayed workstation client information.

  6. For example, if you start the PACS Server Manager demo CSLeadtools.Dicom.Server.Manager.exe), this is where the workstation client information would be added to the L19_SERVER32 DICOMservice.

  7. Notice that the L19_WS_SERVER32 has also been added to the list of clients. This is because when a Query/Retrieved is performed, the retrieved dataset is placed in the L19_WS_SERVER32. Therefore it must also be added to the client list.

  8. Now return back to the Search Control and notice that you can select the DICOM servers you just entered previously.


Storing Images On Remote DICOM Servers

  1. After inserting images into the Workstation database you can store them to other DICOM servers.

  2. Start the LEADTOOLS Medical Workstation Viewer.

  3. Make sure you have configured a DICOM Server in the PACS Configuration control. (see “Adding a PACS Server”)

  4. Make sure you have configured the DICOM Server to allow store requests from the workstation client. (As in step #5 from “Adding a PACS Server”)

  5. Using the Search control, select the “Local Database” source option and click the search button.

  6. Select a study/series from the results view and right-click on it.

  7. You should see an option to store the study/series to the configured DICOM Servers.

  8. Select the default DICOM Server or choose one from the context menu list.

  9. The Store operation will be added to the Queue Manager to show the operation status.

Note: If you try storing a dataset to the L19_SERVER32 that was retrieved from the L17_SERVER_32 server, the store will fail since the dataset already exists on the server. (It will fail with a DuplicateInstance being the reason). To store the dataset successfully, either remove the dataset from the L19_SERVER32 prior to storing, or store it to a different server.

Using the Workstation Listener Service

The workstation listener service is used by DICOM clients to communicate with the workstation (Query/Retrieve and store DICOM). Perform the following steps to use the Workstation Listener Service:

  1. Open the LEADTOOLS Medical Workstation Viewer.

  2. Click the "Service Manager" button on the toolbar in the bottom of the window.

  3. Make sure that the L19_WS_SERVER32 is running. If it is running, then the Start Server button will be grayed out, as shown in the following figure:

  4. Run the CSDicomHighlevelClientDemo.exe client demo to connect to the L19_WS_SERVER32. In the drop-down box select "L19_WS_SERVER32" and then click Search to query the LEADTOOLS Medical Workstation Viewer.

  5. Start the CSDicomHighlevelStoreDemo.exe, and click Yes in the initial dialog if this is your first time running the CSDicomHighlevelStoreDemo.exe. Once started, select "L19_WS_SERVER32" in the drop-down box. Then click Store to store the images to the LEADTOOLS Medical Workstation Viewer.

  6. Make a search in the workstation's Search control to verify that the image has been successfully stored.

Workstation Client Configuration Overview

The Workstation Client Configuration dialog is shown in the following figure:


The fields can be described as follows:

  1. DICOM Client group: Contains information about the workstation client which will connect to remote DICOM servers to query, retrieve and store images.

  2. Enable Debug Mode group: Allows you to run the workstation in debug mode. Check box options allow you to display detailed debug messages, and generate a log file for DICOM communication.

  3. Enable Viewer Lazy Loading: When this is enabled, the viewer control does not load the series images into memory, but loads them only when they need to be displayed on the screen. This makes the initial image display faster and does not take as much memory as it would if they were all loaded. However, Cine playing speed can be slower than it would when all of the images are loaded.

    To overcome slow Cine speed, specify how many hidden sequential images should be loaded in addition to the displayed images.

  4. DICOM Retrieve group: If this check box is clear, when retrieving images from DICOM Servers should one or more images be found to be currently existing in the workstation local database, the retrieve operation will fail. When this check box is selected, the workstation will continue retrieving the rest of the images even if they currently exist in the local database.

  5. Auto Size Overlay Text group: If this check box is selected, any overlay text is automatically sized. If this check box is clear, the text is set to the specified fixed size.

  6. Run Viewer in Full Screen Mode check box: If this check box is selected, the viewer will run in full screen mode the next time it is started. If this check box is clear, the viewer can be sized, maximized, and minimized.

3D Viewing

  1. To view images in 3D, load a 3D dataset into the Medical Workstation's local database. (Refer to the Service/Database Manager section) You can use any DICOM dataset composed of a series of 2D slices (stack), or download one form our FTP site. It is faster to use the DICOMDIR button and load the DICOMDIR file, if one is present.

  2. Once loaded, close the Database Manager and go back to the search screen. Change the source from 'PACS Server' to 'Local Database' and perform a search. Right-click on the study or series found corresponding to the 3D dataset and select 'Open in Viewer'.

  3. It may take a few seconds to load all the frames. Once loaded, select the 'Create a 3D Volume' icon.

  4. The 3D volume screen is divided into the volume and the original slices along with two other generated slices. There are scout lines you can adjust as well as a slab rectangle which can be used to modify the clipping of the volume. The volume can be rotated, magnified, panned, and window-leveled, with many other options as well.

  5. To change the type of volume that is rendered, right-click on the volume and select one of the options in the menu that appears. We support Maximum Intensity Projection (MIP), Minimum Intensity Projection (MinIP), Multi-Planar Reconstruction (MPR), Surface-Shaded Display (SSD), and Volume Rendering Technique (VRT).

  6. You can also store the 3D volume once it is rendered. Any workstation connecting to the workstation database will then be able to load the 3D volume without having to regenerate it. This allows for faster load times. You can store the state of the 3D volume as well. Simply right-click on the volume and select 'Store Volume' or 'Store Volume State'.

MPR Viewing

  1. To perform MPR viewing, follow the first two steps from "3D Viewing". Once the image is loaded, select the MPR Icon, as shown in the following figure:

  2. You can select either a single or a double line and add more each time you select the icon. To view the corresponding images, right-click on the image and select "Series Layout". Then select a layout so that all corresponding images can be seen, as shown in the following figure:



  1. To view the log, click Service Manager and then select the “Event Log Viewer” button. You can filter the results of the log or leave all filters blank and click Single Query to display all logs.

  2. Double-click an item to see more information. If a dataset was part of the communication it will also be available. The dataset can be saved as text, XML, or as a DICOM file to disk.

  3. To view logs as they happen in real time, click Start Continuous Query.




Medical Workstation Diagram

Help Version 20.0.2020.4.3
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Imaging, Medical, and Document