简介这是一套基于C#与DirectShow技术栈的TCT病理图文分析系统完整源码采用Visual Studio 2008开发数据库为Access可无缝升级为网络版适合医疗信息化开发者、PACS方向学习者及C#桌面应用进阶者参考。源码已在医院实际投入使用涵盖运行期界面设计、所见即所得报告书写窗口、DirectShow音视频与图像采集以及多个自定义组件的开发范例对理解net pacs类系统的业务与实现路径有直接帮助。压缩包共1093个文件约9.54MB以515个rtf报告模板、136个cs源码、109个gif与41个ico界面资源、54个resx与53个resources资源文件为主另含38个dll依赖、9个csproj工程文件及sln解决方案结构完整可直接打开运行。目前已有177人学习下载适合通过真实项目源码掌握C#组件开发、图像采集与医疗报告模块设计。1. TCT病理图文分析系统从玻片扫描到PACS归档的C#落地路径TCT液基薄层细胞学检测病理图文分析系统核心工作流是显微镜相机采集玻片图像C#上位机通过DirectShow驱动UVC相机完成帧回调再对图像做预处理、标注、结构化存储最终以DICOM或自定义格式对接net PACS归档。这套系统解决的是病理科从“肉眼阅片手工报告”转向“数字化采集图文报告网络归档”的问题适合做医疗影像上位机、PACS对接、工业相机采集的C#开发者。标题里的四个关键词——C#、DirectShow、net、pacs——分别对应开发语言、采集框架、网络通信层和归档目标。热词里高频出现的“c#上位机”“c# usb摄像头免费开源第三方组件”“c# directshow uvc 回调里区分多个摄像头”恰好是这套系统最先撞上的三堵墙相机枚举、多路回调区分、帧数据零拷贝。下面按“采集→处理→存储→归档→避坑→进阶”的顺序把每个环节的参数、代码和边界讲清楚。2. DirectShow采集UVC相机枚举、回调与多路区分2.1 为什么在C#里选DirectShow而不是MediaFoundationWindows平台下C#采集UVC相机有三条路DirectShow、MediaFoundation、厂商SDK。厂商SDK最省事但绑定品牌换相机就要重写MediaFoundation是微软主推的现代框架但C#封装少、调试信息晦涩DirectShow虽然老但封装成熟、资料多、对UVC免驱相机兼容性最好。常见做法是用DirectShowLib这个开源封装它把IBaseFilter、ISampleGrabber、ICaptureGraphBuilder2等接口暴露给C#能在WinForm或WPF里直接跑。选DirectShow的另一个理由是回调模型清晰通过ISampleGrabberCB的SampleCB拿到每一帧的原始buffer不需要轮询。对于TCT场景显微镜相机通常是200万到500万像素、帧率15到30fpsSampleCB的零拷贝特性比Bitmap轮询省一半CPU。注意DirectShowLib本身不处理色彩空间转换UVC相机输出的YUY2或MJPG需要自己转RGB否则SaveImage出来是花屏。2.2 枚举设备与构建采集图的完整代码下面这段代码完成三件事枚举所有视频输入设备、按名称匹配目标相机、构建CaptureGraph并挂上SampleGrabber。这是整个采集链路的骨架。using DirectShowLib; using System; using System.Runtime.InteropServices; public class CameraCapture { private IFilterGraph2 _graph; private ICaptureGraphBuilder2 _builder; private IBaseFilter _source; private ISampleGrabber _grabber; private IBaseFilter _grabberFilter; // 枚举所有视频输入设备返回 名称-设备路径 映射 public static DsDevice[] EnumCameras() { return DsDevice.GetDevicesOfCat(FilterCategory.VideoInputDevice); } // 按名称打开指定相机frameCallback 每帧触发 public void Start(string cameraName, ActionIntPtr, int, int, int frameCallback) { DsDevice[] devices EnumCameras(); DsDevice target null; foreach (var d in devices) { if (d.Name.Contains(cameraName)) { target d; break; } } if (target null) throw new Exception(未找到相机: cameraName); _graph (IFilterGraph2)new FilterGraph(); _builder (ICaptureGraphBuilder2)new CaptureGraphBuilder2(); _builder.SetFiltergraph(_graph); // 绑定设备到 Source Filter _graph.AddSourceFilterForMoniker(target.Mon, null, target.Name, out _source); // 创建 SampleGrabber _grabber (ISampleGrabber)new SampleGrabber(); _grabberFilter (IBaseFilter)_grabber; _graph.AddFilter(_grabberFilter, Grabber); // 设置媒体类型RGB24宽高由相机协商 AMMediaType mt new AMMediaType(); mt.majorType MediaType.Video; mt.subType MediaSubType.RGB24; _grabber.SetMediaType(mt); // 连接 Source - Grabber _builder.RenderStream(PinCategory.Capture, MediaType.Video, _source, null, _grabberFilter); // 设置回调1 表示 SampleCB零拷贝0 表示 BufferCB _grabber.SetCallback(new GrabberCallback(frameCallback), 1); IMediaControl control (IMediaControl)_graph; control.Run(); } }逻辑说明EnumCameras用DsDevice.GetDevicesOfCat拿到所有UVC设备这是区分多摄像头的第一步。AddSourceFilterForMoniker把设备moniker绑定成Source Filter比直接按FriendlyName创建更可靠。SetMediaType指定RGB24让SampleGrabber在回调前完成色彩转换省掉手动YUY2转RGB。SetCallback第二个参数传1走SampleCB传0走BufferCB——SampleCB的buffer指针在回调返回后失效必须立即拷贝或处理。参数说明PinCategory.Capture对应预览/采集引脚如果相机有Still Pin需要抓单帧改成PinCategory.Still。RenderStream的第三个参数传null表示自动选引脚多路相机时建议显式指定引脚避免串流。2.3 多摄像头回调里区分数据源的三个手段热词里“c# directshow uvc 回调里区分多个摄像头”是真实痛点。SampleCB是全局回调多个相机共用一个回调实例时buffer里没有设备ID。三种区分手段第一每个相机创建独立的GrabberCallback实例在构造函数里传入cameraIndex回调里直接读成员变量。这是最干净的做法代价是每个相机一套Graph。第二用SampleGrabber的SetCallback时传入不同的callback对象但共享同一个处理队列队列元素带cameraIndex。适合相机数量多、Graph资源紧张的场景。第三在buffer头部写入自定义头相机启动时协商回调里解析头拿ID。不推荐因为UVC相机不一定支持自定义媒体类型。我一般用第一种代码直观调试时看callback实例的hashcode就能定位是哪路相机。多相机场景下每个Graph独立RunCPU占用会线性上升4路200万像素RGB24、15fps大约吃掉25%的i5核心需要评估。3. 图像预处理与TCT图文结构化存储3.1 从帧buffer到可分析Bitmap的转换链SampleCB拿到的IntPtr指向RGB24数据宽高和stride需要从GetCurrentBuffer或媒体类型里取。转Bitmap的常见做法private void OnFrame(IntPtr buffer, int width, int height, int stride) { // RGB24 每像素3字节stride 可能大于 width*3内存对齐 int dataSize stride * height; byte[] managed new byte[dataSize]; Marshal.Copy(buffer, managed, 0, dataSize); // 构造 Bitmap注意 stride 对齐 Bitmap bmp new Bitmap(width, height, stride, System.Drawing.Imaging.PixelFormat.Format24bppRgb, Marshal.UnsafeAddrOfPinnedArrayElement(managed, 0)); // 立即 Clone否则 managed 被 GC 后 bmp 悬空 Bitmap safeCopy (Bitmap)bmp.Clone(); bmp.Dispose(); ProcessFrame(safeCopy); }逻辑说明Marshal.Copy把非托管buffer拷到托管数组这是必须的因为SampleCB返回后buffer失效。new Bitmap用stride构造避免宽度不对齐导致的斜纹。Clone是关键——直接用托管数组构造的Bitmap在数组被回收后会崩溃Clone出一份独立内存。参数说明stride通常等于width*3向上取到4的倍数。如果相机输出MJPG需要先解码再走这条链DirectShowLib不内置MJPG解码常见做法是接一个MJPG Decompressor Filter或用OpenCVSharp的Cv2.ImDecode。3.2 TCT图文报告的数据模型与落库TCT报告的核心字段病例号、采样日期、玻片编号、镜下描述、诊断结论、图像列表。图像不是存BLOB而是存文件路径缩略图BLOB。这样数据库轻图像文件可以单独备份。CREATE TABLE tct_case ( case_id VARCHAR(32) PRIMARY KEY, patient_name VARCHAR(64), slide_no VARCHAR(32), sample_date DATETIME, description TEXT, diagnosis VARCHAR(256), created_at DATETIME DEFAULT GETDATE() ); CREATE TABLE tct_image ( image_id INT IDENTITY PRIMARY KEY, case_id VARCHAR(32) FOREIGN KEY REFERENCES tct_case(case_id), file_path VARCHAR(512), thumb VARBINARY(MAX), capture_time DATETIME, camera_index INT );逻辑说明tct_case存文本报告tct_image存图像元数据和缩略图。camera_index字段对应多相机场景方便回溯是哪路相机拍的。缩略图存VARBINARY控制在50KB以内列表页直接读不用碰磁盘。参数说明file_path用相对路径根目录配置在app.config里迁移服务器时只改配置。thumb建议统一256x256 JPEG质量70太大拖慢列表查询。3.3 图像标注与报告生成的衔接病理医生在图像上画感兴趣区域ROI标注坐标要跟图像一起存。常见做法是存JSON{rois:[{x:120,y:340,w:80,h:60,label:上皮细胞}]}。报告生成时用GDI或iTextSharp把原图ROI框文本拼成PDF。这里不展开PDF库选型只提醒一点ROI坐标基于原图分辨率如果报告里缩放显示要按比例换算否则框会偏。4. net PACS对接DICOM封装与网络传输4.1 为什么TCT图像要封成DICOM而不是直接传JPEGPACS是DICOM的世界。直接传JPEGPACS能存但没法按DICOM标签检索等于存了一堆死图。封成DICOM把病例号、玻片号、采集时间写进标准TagPACS才能按PatientID、StudyDate查询。TCT图像属于Secondary CaptureSC或Visible Light Photographic用SecondaryCaptureImageStorageSOP Class足够。4.2 用fo-dicom构建SC图像的代码fo-dicom是C#里最成熟的DICOM库支持net standardWinForm和WPF都能用。using Dicom; using Dicom.Imaging; public DicomDataset BuildTctDicom(Bitmap image, string caseId, string patientName) { var dataset new DicomDataset(DicomTransferSyntax.ExplicitVRLittleEndian); // SOP Class 和 Instance dataset.Add(DicomTag.SOPClassUID, DicomUID.SecondaryCaptureImageStorage); dataset.Add(DicomTag.SOPInstanceUID, DicomUID.Generate()); // 患者与检查信息 dataset.Add(DicomTag.PatientID, caseId); dataset.Add(DicomTag.PatientName, patientName); dataset.Add(DicomTag.StudyDate, DateTime.Now.ToString(yyyyMMdd)); dataset.Add(DicomTag.Modality, SC); // 图像像素数据 var pixelData DicomPixelData.Create(dataset, true); pixelData.BitsAllocated 8; pixelData.BitsStored 8; pixelData.HighBit 7; pixelData.SamplesPerPixel 3; pixelData.PhotometricInterpretation PhotometricInterpretation.Rgb; pixelData.PlanarConfiguration 0; pixelData.Width image.Width; pixelData.Height image.Height; // Bitmap 转 byte[] byte[] pixels BitmapToRgbBytes(image); pixelData.AddFrame(pixels); return dataset; }逻辑说明SecondaryCaptureImageStorage是SC图像的SOP ClassPACS通用支持。DicomPixelData.Create第二个参数true表示要写像素。PhotometricInterpretation.Rgb对应彩色图像如果是灰度涂片改成Monochrome2。AddFrame传入的byte数组长度必须是WidthHeight3RGB。参数说明BitsAllocated8对应8位每通道TCT彩色图像够用。如果要做16位灰度改成16并调整HighBit。PlanarConfiguration0表示RGB交错存储这是DICOM默认。4.3 C-STORE发送到PACS与超时处理封好DICOM后用DicomClient发C-STOREvar client new DicomClient(); client.NegotiateAsyncOps(); var request new DicomCStoreRequest(dataset); client.AddRequest(request); await client.SendAsync(192.168.1.100, 104, false, TCT_SCU, PACS_AE);逻辑说明SendAsync参数依次是PACS IP、端口、useTLS、调用方AE Title、目标AE Title。104是DICOM标准端口。NegotiateAsyncOps开启异步协商大图像传输时避免阻塞。参数说明AE Title必须和PACS配置里登记的一致否则会被拒绝。超时默认30秒大图像或网络差时在DicomClient上设AssociationRequestTimeout。热词里“c# restclient.execute返回异常无法将数据写入传输连接”在DICOM场景对应的是连接被PACS主动断开常见原因是AE Title不匹配或PACS磁盘满。注意C-STORE失败时先看PACS返回的Status码0x0000成功0xA700拒绝0xA801未授权。别一上来就抓包先核对AE Title和SOP Class。5. 避坑与排查TCT采集归档的五个血泪教训5.1 相机枚举到了但RenderStream失败现象EnumCameras能看到设备AddSourceFilterForMoniker也成功但RenderStream抛异常或返回负值。原因相机被其他进程占用或者UVC驱动没正确加载。Windows下相机是独占设备QQ、钉钉、浏览器都可能偷偷占用。解决先control.Stop()释放Graph再检查设备管理器里相机有没有黄色感叹号。如果是笔记本内置相机和外接USB相机同时存在确认moniker选的是外接那个。实在不行用GraphEdit工具手动连一遍看哪个引脚连不上。5.2 SampleCB回调里Bitmap花屏或斜纹现象保存的图像上半部分正常下半部分斜纹或者整体颜色错乱。原因stride没对齐。RGB24每行字节数必须是4的倍数width641时stride1923但实际分配可能是1924。直接用width*3算偏移就错位。解决从媒体类型里读AMMediaType.lSampleSize或调用GetCurrentBuffer拿实际stride。构造Bitmap时传stride而不是width*3。颜色错乱则检查相机输出是YUY2还是MJPGSetMediaType时指定RGB24让DirectShow自动转。5.3 多相机回调串数据现象两路相机同时跑A相机的图像偶尔出现在B相机的报告里。原因共用了同一个SampleGrabber实例或同一个callback对象回调里没有区分数据源。解决每个相机独立Graph、独立SampleGrabber、独立callback实例。callback构造函数传入cameraIndex处理时按index分发。不要图省事用静态变量存当前相机。5.4 DICOM发送成功但PACS查不到现象C-STORE返回0x0000但PACS客户端按病例号搜不到。原因PatientID或StudyInstanceUID没填或者StudyDate格式不对。PACS按Study级检索没有StudyInstanceUID就归不到一次检查里。解决补DicomTag.StudyInstanceUID和DicomTag.SeriesInstanceUID用DicomUID.Generate()生成。StudyDate用yyyyMMdd别用yyyy-MM-dd。Modality填SC或OT别留空。5.5 net framework 3.5安装报错导致老设备跑不起来现象客户现场是Windows 7或Windows 10 LTSC装net framework 3.5报0x80072f8f或0x80d03805。原因离线环境没有Windows Update源或者系统镜像的sxs目录缺失。解决用离线安装包dotnetfx35.exe配合/lang:zh-cn参数或者挂载系统ISO用dism /online /enable-feature /featurename:NetFx3 /source:D:\sources\sxs。如果目标机器是Windows 11net framework 3.5和4.8可以共存但安装顺序建议先3.5后4.8。6. 进阶用DirectShowfo-dicom做端到端自动化归档把采集、处理、归档串成一条流水线是这套系统从“能用”到“好用”的分界线。我一般会做一个TctPipeline类把相机回调、图像处理、DICOM封装、C-STORE发送串起来用生产者-消费者队列解耦采集和归档避免C-STORE的网络延迟拖慢帧率。using System.Collections.Concurrent; using System.Threading.Tasks; public class TctPipeline { private BlockingCollectionBitmap _queue new BlockingCollectionBitmap(10); private string _pacsIp 192.168.1.100; private int _pacsPort 104; public void Start(string cameraName) { // 消费者后台线程处理归档 Task.Run(() { foreach (var bmp in _queue.GetConsumingEnumerable()) { var ds BuildTctDicom(bmp, CASE001, 张三); var client new DicomClient(); client.AddRequest(new DicomCStoreRequest(ds)); client.Send(_pacsIp, _pacsPort, false, TCT_SCU, PACS_AE); bmp.Dispose(); } }); // 生产者相机回调入队 var cap new CameraCapture(); cap.Start(cameraName, (buf, w, h, s) { var bmp ConvertToBitmap(buf, w, h, s); if (!_queue.TryAdd(bmp, 100)) // 100ms 超时 { bmp.Dispose(); // 队列满丢弃当前帧 } }); } }逻辑说明BlockingCollection容量10采集端TryAdd超时100ms队列满就丢帧保证采集不阻塞。消费端单线程发C-STORE网络慢时队列堆积丢帧比卡死好。BuildTctDicom和DicomClient复用第4章的代码。参数说明队列容量根据PACS响应速度调局域网PACS一般10够用跨网段建议加到30。TryAdd超时别设0否则队列满时直接丢设100ms给一点缓冲。验证方法跑起来后看三个指标——采集帧率是否稳定、队列长度是否持续为0、PACS端Study列表是否按病例号递增。如果队列长度一直涨说明C-STORE太慢先查PACS磁盘和网络RTT。我踩过最深的坑是队列没设上限相机30fps往里灌PACS断网时内存半小时涨到2GB最后OOM。后来所有采集归档链路都加BlockingCollection上限丢帧比崩溃强。希望帮到你。本文还有配套的精品资源点击获取