LEADTOOLS SDK 将 DICOM 图像提取为 PNG 文件

📅 2026/7/20 19:42:47
LEADTOOLS SDK 将 DICOM 图像提取为 PNG 文件
提取、编辑和替换 DICOM 图像 - C# .NET 6本教程演示如何使用 LEADTOOLS SDK 将 DICOM 图像提取为 PNG 文件然后替换 C# .NET 6 应用程序中的 DICOM 图像。概述概括本教程介绍了如何在 C# .NET 6 应用程序中提取和替换 DICOM 图像。完成时间20分钟Visual Studio 项目下载教程项目2 KB平台C# .NET 6 控制台应用程序集成开发环境Visual Studio 2022运行时目标.NET 6 或更高版本开发许可证下载 LEADTOOLS所需知识在开始学习本教程之前请先查看“添加引用和设置许可证”教程熟悉创建项目的基本步骤。创建项目并添加 LEADTOOLS 引用首先请使用“添加引用和设置许可证”教程中创建的项目副本。如果您没有该项目请按照该教程中的步骤创建它。所需的参考文献取决于项目的目的。可以通过以下两种方法中的一种但不能同时使用两种方法添加参考文献。本项目需要以下参考文献如果使用 NuGet 引用本教程需要以下 NuGet 包Leadtools.Dicom.Pacs.Scu如果使用本地 DLL 引用则需要以下 DLL 文件。这些 DLL 文件位于INSTALL_DIR\LEADTOOLS23\Bin\netLeadtools.dllLeadtools.Codecs.dllLeadtools.Dicom.dllLeadtools.Dicom.Tables.dllLeadtools.ImageProcessing.Core.dll有关应用程序所需的 DLL 文件的完整列表请参阅“应用程序中包含的文件”。设置许可证文件许可证用于解锁项目所需的功能。必须在调用任何工具包函数之前设置许可证。有关详细信息包括不同平台的教程请参阅“设置运行时许可证”。运行时许可证有两种类型评估许可证在下载评估工具包时获得。它允许对工具包进行评估。部署许可证。如果需要部署许可证文件和开发者密钥请参阅“获取许可证”部分。添加 DICOM 图像提取代码项目创建完毕参考文献添加完毕许可证设置完毕就可以开始编码了。在解决方案资源管理器中打开Program.cs。将以下语句添加到using顶部的代码块中Program.csC#using System;using System.Collections.Generic;using System.IO;using Leadtools;using Leadtools.Codecs;using Leadtools.Dicom;RasterCodecs在 Program 类中添加以下全局变量。C#static RasterCodecs codecs new RasterCodecs();在类中添加一个名为 ExtractPngFromDicom(string dicomFile, string outDir)inside的新方法。如下所示Program该方法将在方法内部调用以返回提取为 PNG 文件的 DICOM 图像的字符串数组。Main()请确保该Main()方法包含以下代码直至此处。C#static void Main(string[] args){string dicomFile C:\LEADTOOLS23\Resources\Images\DICOM\image3.dcm;// Create a local output directory for the files to be savedstring outDir OUTPUT DIRECTORY;InitLEAD();DicomEngine.Startup();var extractedFrames ExtractPngFromDicom(dicomFile, outDir);}添加以下代码以将 DICOM 图像提取为 PNG 文件。C#private static string[] ExtractPngFromDicom(string dicomFile, string outDir){// Create a list of output filesvar outputFiles new Liststring();if(!Directory.Exists(outDir))Directory.CreateDirectory(outDir);// Load the DICOM pixel datavar ds new DicomDataSet();ds.Load(dicomFile, DicomDataSetLoadFlags.None);var pixelDataElement ds.FindFirstElement(null, DicomTag.PixelData, true);if (pixelDataElement ! null) throw new Exception(This dataset is missing the pixel data element);var imageCount ds.GetImageCount(pixelDataElement);var imageInformation ds.GetImageInformation(pixelDataElement, 0);if (imageCount 0) throw new Exception(This dataset has no images);if (imageInformation null) throw new Exception(Cant retrieve image information);// Get all the images based on pixel data and image informationusing var image ds.GetImages(pixelDataElement, 0, imageInformation.FrameCount, 0, RasterByteOrder.Gray, DicomGetImageFlags.AllowRangeExpansion | DicomGetImageFlags.AutoApplyModalityLut | DicomGetImageFlags.AutoApplyVoiLut);for (int i 1; i image.PageCount; i){var outFileName Path.Combine(outDir, Path.GetFileNameWithoutExtension(dicomFile) .png);// Save the image as a PNG filecodecs.Save(image, outFileName, RasterImageFormat.Png, 0, i, i, 1, CodecsSavePageMode.Overwrite);// Add the output file name to the list of output filesoutputFiles.Add(outFileName);}return outputFiles.ToArray();}添加替换 DICOM 图像代码在类中添加一个名为 ReplaceDicomImages(string dicomFile, string outDir, params string[] imageFiles)inside的新方法Program。该方法将在 on 方法内部调用Main()位于对 on 方法的调用下方ExtractPngFromDicom()如下所示。此外在 on 方法的底部添加一行代码Main()以关闭 on 方法DicomEngine。C#static void Main(string[] args){string dicomFile C:\LEADTOOLS23\Resources\Images\DICOM\image3.dcm;// Create a local output directory for the files to be savedstring outDir OUTPUT DIRECTORY;InitLEAD();DicomEngine.Startup();var extractedFrames ExtractPngFromDicom(dicomFile, outDir);// Apply Redaction, anonymization, etc. to PNGReplaceDicomImages(dicomFile, outDir, extractedFrames);DicomEngine.Shutdown();}添加以下代码将ExtractPngFromDicom()方法中创建的 PNG 图像添加回 DICOM 图像。C#private static string ReplaceDicomImages(string dicomFile, string outDir, params string[] imageFiles){// Load the DICOM pixel datavar ds new DicomDataSet();ds.Load(dicomFile, DicomDataSetLoadFlags.None);// Changing ImageType to DERIVED to meet DICOM standards, since we are changing the imageListstring it ds.GetValueListstring(DicomTag.ImageType, null);if (it.Contains(ORIGINAL)){it.Remove(ORIGINAL);it.Insert(0, DERIVED);}ds.InsertElementAndSetValue(DicomTag.ImageType, it.ToArray());var pixelDataElement ds.FindFirstElement(null, DicomTag.PixelData, true);if (pixelDataElement null)pixelDataElement ds.InsertElement(null, false, DicomTag.PixelData, DicomVRType.UN, false, 0);// Create a new RasterImageset to nullRasterImage img null;foreach (var imageFile in imageFiles){// Load the image fileif (img null)img codecs.Load(imageFile);elseimg.AddPage(codecs.Load(imageFile));}// Set the image back to a DICOM fileds.SetImages(pixelDataElement, img, DicomImageCompressionType.J2kLossless, DicomImagePhotometricInterpretationType.Monochrome2, 0, 2, DicomSetImageFlags.AutoSetVoiLut);var outFileName Path.Combine(outDir, Path.GetFileNameWithoutExtension(dicomFile) _replaced.dcm);ds.Save(outFileName, DicomDataSetSaveFlags.None);return outFileName;}运行项目按F5运行项目或者选择“调试”-“开始调试”。如果步骤正确控制台将显示并确认许可证已正确设置。然后应用程序会从 DICOM 图像中提取 PNG 文件替换原图像并将其保存到指定位置。包起来本教程演示了如何创建一个简单的基于控制台的图像提取应用程序该应用程序初始化 LEAD DICOM 引擎从 DICOM 文件中提取 PNG 图像并将其替换。