# @bjornlu/colorblind 中文文档

规范地址：https://npmcn.com/package/%40bjornlu/colorblind/

版本：1\.0\.3
npm 元数据更新时间：2022-05-07T12:28:52.522Z
中文译文更新时间：2026-11-08T05:24:40.378Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40bjornlu/colorblind
原文对照：https://npmcn.com/package/%40bjornlu/colorblind/?lang=original
项目主页：https://github.com/bluwy/colorblind
源码仓库：https://github.com/bluwy/colorblind

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：11.8 kB，11 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2020-06-28T13:38:33.866Z
- 最新版本发布：2020-10-22T13:00:58.558Z
- 近 30 天下载量：3582（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 0 个）

## 中文简介

模拟色盲

## 安装

```sh
npm install @bjornlu/colorblind
```

也可以使用：`pnpm add @bjornlu/colorblind`、`yarn add @bjornlu/colorblind`、`bun add @bjornlu/colorblind`

## README

# 颜色盲

[![package version](https://img.shields.io/npm/v/@bjornlu/colorblind)](https://www.npmjs.com/package/@bjornlu/colorblind) [![npm downloads](https://img.shields.io/npm/dm/@bjornlu/colorblind)](https://www.npmjs.com/package/@bjornlu/colorblind)

零依赖相色盲模拟库.

它基于 [色彩失明模拟研究](https://ixora.io/projects/colorblindness/color-blindness-simulation-research/) 联 合 国 [处理库](https://github.com/hx2A/ColorBlindness) 以 [hx2A (韩语)](https://github.com/hx2A)。 。 。 .

[**演示**](https://bluwy.github.io/colorblind)

## 安装

```bash
$ npm install @bjornlu/colorblind
```

或使用CDN直接用于浏览器,例如:

```html
<!-- jsDelivr -->
<script src="https://cdn.jsdelivr.net/npm/@bjornlu/colorblind"></script>

<!-- unpkg -->
<script src="https://unpkg.com/@bjornlu/colorblind>"></script>
```

CDN 版本设置全球 `colorblind` 对象,例如:. `colorblind.simulate(...)`。 。 。 .

## 使用量

```js
import { simulate } from '@bjornlu/colorblind'

simulate({ r: 120, g: 50, b: 30 }, 'protanopia')
// => { r: 62, g: 62, b: 30 }
```

色彩不足可设定为:

| 缺陷 | 说明 |
| --- | --- |
| `'protanopia'` | 没有红色 |
| `'deuteranopia'` | 没有绿色 |
| `'tritanopia'` | 没有蓝色 |
| `'achromatopsia'` | 无颜色 |

## 高级

图书馆还输出两个功能:

1.  `simulateDichromatic(rgb: RGB, simMatrix: Array<number>): RGB`
2.  `simulateMonochromatic(rgb: RGB, simMatrix: Array<number>): RGB`

你几乎永远不会使用这个 除非你需要进行自定义的颜色模拟.

`simulateDichromatic()` 接受以9个数字组成的数组表示的模拟矩阵,而 `simulateMonochromatic()` 接受3个数字的数组.

看看这个 [研究](https://ixora.io/projects/colorblindness/color-blindness-simulation-research/) 用于计算模拟矩阵.

## 补充说明

-   文库不假设该颜色的γ,因此在需要时必须手动应用或去除γ校正.
-   该算法不使用daltonization计算结果值.

## 捐款

任何打字或文件问题都欢迎公关。 关于模拟算法的编辑必须以研究为后盾,最好先在一个问题中讨论.

## 先前的研究

图书馆实际上计划 是一个重写 [颜色盲](https://github.com/skratchdot/color-blind) 删除 [单色](https://github.com/One-com/one-color) 依赖和增加打字。 在理解代码如何运作的过程中,我发现 [原文参考](https://galactic.ink/sphere/js/Color.Blind.js) 已经过时了,有一个 [较新的版本](https://galactic.ink/labs/Color-Vision/Javascript/Color.Vision.Simulate.js)。 。 。 .

我也发现了 [LMS 版本](https://galactic.ink/labs/Color-Vision/Javascript/Color.Vision.Daltonize.js) 聚变装置,恰好是 [色彩失明模拟研究](https://ixora.io/projects/colorblindness/color-blindness-simulation-research/)。唯一的区别是用于色彩缺陷的模拟矩阵及其后色校正计算.

我最终决定从研究中遵循算法,因为它是我发现的唯一来源,它支撑了数值的计算方式. 所以这意味着这个库不使用分解来计算颜色.

由于我不是这个领域的专家,我将非常赞赏对执行的验证,以及达尔顿化是否是更好的选择.

## 许可证

麻省理工学院

## 常见问题

### @bjornlu/colorblind 是什么？

模拟色盲

### 如何安装 @bjornlu/colorblind？

在项目目录运行 npm install @bjornlu/colorblind，或使用 pnpm add / yarn add / bun add。

### @bjornlu/colorblind 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @bjornlu/colorblind 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @bjornlu/colorblind 可以商用吗？

@bjornlu/colorblind 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @bjornlu/colorblind 的下载量有多少？

根据 npm 官方下载统计，@bjornlu/colorblind 在 2026/10/08 – 2026/11/06 这 30 天内被下载 3,582 次，日均约 119 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @bjornlu/colorblind 还在维护吗？

最新版本 1\.0\.3 发布于 2020/10/22（6 年前）；至今共发布 4 个版本，其中过去 12 个月发布了 0 个；首次发布于 2020/06/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。