1 背景

上一篇本来就想写这个读取的。想起来先看下 VTK 是否能正常显示，结果出了一堆意外。这一篇开始填充之前的框架。怎么说呢，

2 正文

模型

Frame

存储图像数据用 GDCM。存储 tag 等用 DCMTK，后面用混合的组成 Frame。

#pragma once
#include 
#include 
#include 
#include 
class Frame{
从public来看，explicit Frame;~Frame = default;private:
再看std:，vector pixels;int rows，int cols;double pixelSpacingX;double pixelSpacingY;std::array imagePositionPatient;std::array imageOrientationPatient;std::string sopInstanceUid;int frameIndex;// 多帧中的编号
double slope;double intercept;public:
double getSlope const;void setSlope;double getIntercept const;其实，void setIntercept;int getFrameIndex const;void setFrameIndex;const std::vector& getPixels const;void setPixels;int getRows const;void setRows;int getCols const;void setCols;double getPixelSpacingX const;void setPixelSpacingX;double getPixelSpacingY const;说起来，void setPixelSpacingY;const std::array& getImagePositionPatient const;void setImagePositionPatient;const std::array& getImageOrientationPatient const;void setImageOrientationPatient;老实说，const std::string& getSopInstanceUid const;void setSopInstanceUid;}，

DisplaySettings

痛点：当前窗宽窗位是硬编码的。导致不同系列的 CT、MR 图像在同一窗口下显示不一致，必须手动调节才能看到正确对比。

#pragma once
class DisplaySettings {
说到public，explicit DisplaySettings;~DisplaySettings = default;private:
double windowWidth = 400.0;// TODO: 从 DICOM tag 中读取
double windowCenter = 40.0;public:
// --- Getters & Setters ---
double getWindowWidth const { return windowWidth;}
void setWindowWidth { windowWidth = w;}
double getWindowCenter const { return windowCenter;}
void setWindowCenter { windowCenter = c;}
}，

StackDisplaySet

这个类存储读取的 DICOM 所有帧、当前显示索引还有当前的窗宽窗位。

#pragma once
#include 
#include 
#include "DisplaySettings.h"
class StackDisplaySet {
说到public，explicit StackDisplaySet;老实说，~StackDisplaySet = default;private:
std:的观点是，vector frameUids;int currentIndex{0};DisplaySettings displaySettings;public:
// --- Getters & Setters ---
int getCurrentIndex const { return currentIndex;}
void setCurrentIndex{ currentIndex = idx;}
const std::vector& getFrameUids const { return frameUids;}
void setFrameUids{ frameUids = uids;怎么说呢，}
const DisplaySettings& getDisplaySettings const { return displaySettings;}
void setDisplaySettings{ displaySettings = ds;}
}，

读取模型

模型缓存接口

兼容 Frame、vtkImageData。还有空指针，以便统一管理不同来源的数据。

#pragma once
#include <memory>
#include "domain/model/Frame.h"
#include <variant>
#include "vtkSmartPointer.h"
#include "vtkImageData.h"
class IFrameCache {
至于public，explicit IFrameCache;~IFrameCache = default;public:
using FramePtr = std::variant<
       std::shared_ptr。vtkSmartPointervtkImageData,nullptr_t
>;virtual void put = 0;virtual FramePtr get = 0;}，话说回来，

通用读取接口类

痛点：单纯读取像素而不考虑 Rescale Slope/Intercept。会导致 CT 图像呈现为全黑或全白。

#pragma once
#include <string>
#include <memory>
#include "domain/model/Series.h"
#include "domain/model/Frame.h"
#include "infrastructure/cache/IFrameCache.h"
class IDicomReader {
再看public，explicit IDicomReader;话说回来，~IDicomReader = default;怎么说呢，virtual void open = 0;virtual Series readSeries = 0;virtual std::unique_ptrFrame readFrameInfo = 0;virtual IFrameCache::FramePtr readFrame;
不过，virtual void close;}，

dcmtk只读取文件信息

#include "DcmtkReader.h"
#include <dcmtk/dcmdata/dcdeftag.h>
// ... or dcmtk includes ...
DcmtkReader::DcmtkReader{}
void DcmtkReader::open{
m_fileFormat = std::make_unique;if).bad){
throw runtime_error;}else{
m_dataset=std::make_unique);}
}
// ... readSeries stub ...
template<size_t N>bool getTagAsArray(
const unique_ptr& dataset。const DcmTagKey&,array& arr){
bool allGood=true;/* omitted for brevity */
}
说到std:，unique_ptr DcmtkReader::
readFrameInfo{
auto frame=make_unique;OFString sopUidStr;/* extract SOPInstanceUID etc */
frame->setSopInstanceUid));
/* extract PixelSpacing、ImagePositionPatient、Orientation、RescaleSlope/Intercept */
/* 注意：如果 tag 不存在需要提供默认值，否则会出现黑屏 */
return frame;}
IFrameCache::FramePtr D...
// omitted or methods

gdcm读取图像数据

痛点：GDCM 返回的像素顺序与 VTK 不一致。需要手动翻转 Y 轴，否则图像上下颠倒。

#include "GdcmReader.h"
#include <gdcmBoxRegion.h>
// ... or gdcm includes ...
GdcmReader::GdcmReader{}
void GdcmReader::open{
m_image_reader=make_uniquegdcm:ImageReader>;m_image_reader->SetFileName) ;if){
throw runtime_error;不过，}
}
/* readSeries stub */
IframeCache::F ramePtr GdcmReader::
readF r ame{
if throw runtime_error;auto image=m_image_reader->GetImage;unsigned rows=image.GetRows,cols=image.GetColumns;vector pixels=extractPixelData;// 包含翻转
auto f=make_uniqueFram e>;f-> GdcmR eader::
extractPixelData{
/* decode according to PixelFormat …*/
/* 翻转 Y轴 : vtk expects origin at lower‑left */
}
// or stubs …不过，

HybridReader

痛点：在多帧提高型 DICOM 中。dcmtk 能读到元数据但无法直接获取每帧像素，需要 hybrid 做一次“拼装”。说起来，目前仅实现单帧拼装。

#include "HybridReader.h"
#include "DcmtkReader.h"
#include "GdcmReader.h"
HybridReader::HybridRea der{
m_dcmtk_reader=make_unique;m_gdcm_reader=make_unique;其实，}
void HybridR eader ::open{
m_dcmt k_rea der->o pen;m_g d cm_ rea der->o pen;}
IframeC ache::Fram ePtr 
HybridRea der ::readF rame{
auto info=m_dc mt k_rea der->r eadF rameInfo;老实说，auto data=m_g d cm_ rea der->r eadF rame;visit{
using T=decay_t<& amp ;decltype>;if constexpr{
arg->setPixelSpac ingX);其实，/* copy all meta …*/
}
},data);return dat a;}
// or methods stubbed …

VTKDicomAdaptReader

痛点：VTK 自带的 DICOM reader 会把 SOPInstanceUID 放进 FieldData。但没有统一的缓存键，导致后续检索时找不到对应帧。老实说，

#inclu de "VTKDicomAdaptR eader.h"
#inclu de <vtkDICOMMetaData.h&g t;>
// ，or vtk includes …VTKDicomAdaptR eader ::VTKDicomAdaptRea der{
m_reader=vtkSmartPointer<vtkDICOMReade r>::New;}
void VTKDicomA daptRea der ::open{
m_filePath=filePath;m_reader-&g t;SetFileName);m_reader->Update;}
IframeC ache ::Fra mePtr VTKDicomA daptReade r ::
readF rame{
if)return nullptr;auto img=m_r eader->GetOutput;vtkDICOMMetaDa ta *meta=m_r eader->GetMetaDa ta;string uid=
meta-&g t;GetAttributeValue,DC:SOPInstanceUID).AsString;auto uidArr=vtkSmartPointer::New;uidArr -& g t;SetName，uidArr -& g t;InsertNextValue;img -& g t，GetFieldDa ta->AddArray;return img，}
// or methods stubbed …

缓存实现

缓存接口

缓存实现 – MemoryFrameCache

# pragma once
# include" I Fram e C ache . h "
# include 
cla ss MemoryFra meCach e : public IFram eC ach e {
publi c :
expli cit Mem o ryFra meC ache;~MemoryFra meC ach e =default;publi c :
voi d put;不过，FrameT Ptr ge t ove rr ide;其实，priva te :
unord ered_ma p cache;}，

# inc lude"MemoryFram eCa che . h "
MemoryFra meCa che : :Memory Fr amec ache {
cache= unordered_map;}
voi d Mem oryFram ecache ::pu t{
if==cache.end){
cache= unordered_map;}
cache=maptr;}
IframeC ache :: Fra meTPtr Mem o ryFrames ca che ::ge t {
if!=cache.end){
au to& frmMap=cache;if，=frmMap.end){
re turn frmMap.at;}
}
retu rn Ifra mec ache ::Fra met Ptr;// nullptr variant
}

解析下载队列

队列接口

#pragma once
#include 
#include 
cla ss ITaskQueue {
publi c :
exp lic it ITas kQueue;~ITas kQueue =default;publi c :
vi rtual future submit>task,i nt priority=0)=0;tem plat
au to sub mi tw ithResult
->future {
au to promise=
make_shared;au to fut=
promise->get_future;sub mit]{
try{ promise ->set_value);}
cat ch{ promise ->set_exception);}
},priority );retu rn fut，}
vi rtual vo id cancelAll =0;}，其实，