Configure and Run the Medical Workstation Viewer Demo - C# .NET WinForms

This tutorial shows how to configure, run, and use the features of the LEADTOOLS Medical Workstation Viewer Demo.

Summary This tutorial covers how to use the DocumentConverter class in a C# .NET Framework 4.8 application.
Completion Time 20 minutes
Platform C# Console Application
IDE Visual Studio 2019, 2022
Runtime Target .NET Framework 4.8
Development License Download LEADTOOLS

Required Knowledge

Download and install the LEADTOOLS v22 SDK here, and make sure that the license and key files are located in the <INSTALL_DIR>\LEADTOOLS22\Support\Common\License directory. To set the license, refer to the Add References and Set a License tutorial.

The LEADTOOLS Medical Workstation Viewer is an end-user like application with functionality comparable to many DICOM viewers used today in the health care industry. The workstation is built on LEADTOOLS PACS Framework components, and supports the below features:

Configure the Medical Workstation Main Demo

Navigate to the example source code for the project:


Open the CSPROJ file, with administrator rights. The demo projects are set up to run out of the box, so you can run the project by pressing F5 or Start. When running the LEADTOOLS Medical Workstation for the first time, the following message will display.

Screenshot saying to run the Configuration Wizard.

Click Yes, which will bring up the below display.

Screenshot saying to run PACS Config.

Click Yes to run the PACS Database Configuration application. Next, click the Configure button in the bottom left, the databases will then be created.

Databases Configured.

Click Close and this will run the 2nd PACS Configuration Demo.

Default AE Titles and ports are provided for each of the servers and clients, but you can change the AE Title to any name and the port to use a unique port number. You can also have this demo automatically start each service.

To reset any previous client configuration, select the Reset Client Configuration check box. Otherwise, the current configuration will be added to any previous configurations.

Screenshot of PACS Config Demo.

Click Configure to create each of the services and client demos. Click Close to close the demo. The Medical Workstation will then automatically launch.

LEADTOOLS Medical Workstation Main Demo

Once you click Close on the PACS Configuration Demo, this will launch the Medical Workstation Demo. The login dialog will then appear. Use the credentials that you entered in the PACS database configuration demo.

Query, Retrieve, and View Images

  1. The Search Control is initially displayed as the default view. The search control lets you specify the query parameters to search the available DICOM Studies/Series and view images. 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).

    Screenshot of Workstation Demo
  2. Click on the Search button to query the studies and series information on that server. You can view all the series images from a study by performing one of the following actions:

    • Right-clicking on the study and selecting Add all series to Queue Manager.
    • Right-clicking on the specified series and selecting Add series to Queue Manager.
    • Double-clicking the series and selecting Add series to the Queue Manager.
  3. When you add a series to the Queue Manager, the Queue Manager dialog will open and show you the progress of the Move operation. 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.


Note that any retrieved images will be automatically stored into the workstation database. Subsequently, you can search for the images and view them by selecting Local Database from the Search control.

  1. 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 windows. 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.

    Screenshot of the Bottom Menu
  2. Click the Database Manager button on the toolbar at the top of the window.

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

    • Add a DICOM file.
    • Add a complete DICOM directory.
    • Delete selected entries from the results grid view.
    • Clear the entire database.
    • View the status report.

      Screenshot of the Database Manager
  4. You can also perform a search as if you were using the Search control. After adding images, close the Database Manager and return to the Search control.

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

  6. 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.

  7. 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 to search images from, click the Configure button located on the toolbar at the bottom of the window.

  2. 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.

    Screenshot of the Workstation Viewer PACS Configuration Window
  3. Click the Add Remote PACS 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 a Default Storage option 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. If you start the PACS Server Manager Demo, this is where the workstation client information would be added to the L22_SERVER64. Notice that the L22_WS_SERVER64 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 L22_WS_SERVER64 server. Therefore, it must also be added to the client list.

  7. Return 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. Use the Search Control, select the Local Database source option and click the Search button.

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

  4. You will see an option to store the study/series to the configured DICOM Servers. Select the default DICOM Server or choose one from the context menu list.

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

Using the Workstation Listener Service

The Workstation Listener Service is used by DICOM clients to communicate with the workstation (Query/Retrieve and store DICOM).

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

  2. Ensure that L22_WS_SERVER64 is running. If it is running, then the Start Server button will be grayed out.

  3. Run the DicomHighlevelClientDemo_Original.exe to connect to the L22_WS_SERVER64. In the drop-down box select L22_WS_SERVER64 and then click Search to query the LEADTOOLS Medical Workstation Viewer.

    Screenshot of the High-Level DICOM Client Demo.
  4. Start the DicomHighlevelStoreDemo_Original.exe, and select L22_WS_SERVER64 in the drop-down box. Then click Store to store the images to the LEADTOOLS Medical Workstation Viewer.

    Screenshot of the High-Level DICOM Store Demo.
  5. 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:

Screenshot of Workstation Client Configuration Overview.

The fields can be described as follows:

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

  2. Enable Debug Mode: 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: 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: 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: 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).

  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 the 3D Viewing section above. Once the image is loaded, select the MPR Icon. You can select either a single or a double line and add more each time you select the icon.

  2. 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.


  1. To view the log, click the Service Manager icon 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.


This tutorial showed how to configure, run, and use the LEADTOOLS Medical Workstation Demo.

See Also

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

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.