DWV 项目技术文档

1. 安装指南

1.1 环境准备

在开始安装之前，请确保您的系统已经安装了以下软件：

• Node.js：DWV 项目依赖于 Node.js 环境。
• Yarn：推荐使用 Yarn 作为包管理器，但也可以使用 npm。

1.2 安装步骤

1. 克隆代码库：

   git clone https://github.com/ivmartel/dwv.git
   

2. 进入项目目录：

   cd dwv
   

3. 安装依赖：

   yarn install
   

   或者使用 npm：

   npm install
   

4. 启动项目：

   yarn run start
   

   这将启动一个本地服务器，并在默认浏览器中打开示例页面。

2. 项目使用说明

2.1 概述

DWV（DICOM Web Viewer）是一个开源的零足迹医学图像查看器库。它仅使用 JavaScript 和 HTML5 技术，因此可以在任何支持现代浏览器的平台上运行（如笔记本电脑、平板电脑、手机甚至现代电视）。它可以加载本地或远程的 DICOM 格式数据（如 MR、CT、Echo、Mammo、NM 等），并提供标准工具来操作这些图像，如对比度调整、缩放、拖动、在图像上绘制区域以及应用图像滤镜（如阈值和锐化）。

2.2 功能介绍

• DICOM 数据加载：支持本地和远程 DICOM 文件的加载。
• 图像操作工具：包括对比度调整、缩放、拖动等功能。
• 图像滤镜：支持阈值和锐化等图像处理滤镜。
• 区域绘制：可以在图像上绘制区域进行标记。

2.3 示例页面

启动项目后，浏览器将打开示例页面，您可以通过这些页面了解 DWV 的基本功能和使用方法。

3. 项目 API 使用文档

3.1 初始化

const dwv = require('dwv');
const viewer = new dwv.Viewer();

3.2 加载 DICOM 数据

viewer.loadURL('path/to/dicom/file');

3.3 图像操作

• 调整对比度：

  viewer.adjustContrast(value);
  

• 缩放图像：

  viewer.zoom(factor);
  

• 拖动图像：

  viewer.pan(x, y);
  

3.4 图像滤镜

• 应用阈值滤镜：

  viewer.applyThresholdFilter(min, max);
  

• 应用锐化滤镜：

  viewer.applySharpenFilter();
  

4. 项目安装方式

4.1 通过 npm 安装

npm install dwv

4.2 通过 Yarn 安装

yarn add dwv

4.3 手动下载

您也可以直接从 GitHub 仓库下载源代码，然后按照安装指南中的步骤进行安装。

---

通过以上文档，您应该能够顺利安装和使用 DWV 项目。如果在使用过程中遇到问题，请参考项目的 GitHub Issues 页面寻求帮助。