# @enzet/roentgen 中文文档

规范地址：https://npmcn.com/package/%40enzet/roentgen/

版本：0\.16\.0
npm 元数据更新时间：2026-06-10T14:45:41.805Z
中文译文更新时间：2026-11-13T23:07:39.850Z
软件包许可：CC-BY-4\.0

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

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

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

- 包体积（解压后）：616 kB，574 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2025-12-16T11:12:25.338Z
- 最新版本发布：2026-06-10T14:45:41.711Z
- 近 30 天下载量：2976（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 8 个）

## 中文简介

一组单色 14 × 14 像素相通地图图标

## 安装

```sh
npm install @enzet/roentgen
```

也可以使用：`pnpm add @enzet/roentgen`、`yarn add @enzet/roentgen`、`bun add @enzet/roentgen`

## README

# 伦特根

Röntgen是一款由14×14像素相通的单色相通图标所构成. 所有图标都是 下划线 [CC BY 4.0 (英语)](http://creativecommons.org/licenses/by/4.0/) 执照 你个 可以自由地使用它们,但请给予适当的承认.

伦特根是为 [地图机](http://github.com/enzet/map-machine) 用于代表OpenStreetMap数据库中不同地图特性的项目. 但是,它很容易用于任何地图项目,甚至用于与地图无关的项目 项目。 一些图标也可以被作为emoji符号. 多个 Röntgen 图标 用于 [iD 编辑器](https://github.com/openstreetmap/iD) 用于 OpenStreet映射 财务报告和审定财务报表 [使用 iD 标记计划图标的其他工程](https://github.com/openstreetmap/id-tagging-schema/wiki/Projects-that-are-using-this-tagging-schema)。 。 。 .

要使用图标,你可以

-   浏览并下载 [伦特根网站](https://enzet.ru/roentgen), (中文(简体) ),
-   [使用情况](https://npmcn.com/package/%40enzet/roentgen/#readme-npm-package) npm 软件包 [@enzet/伦琴](https://www.npmjs.com/package/@enzet/roentgen)数字 : `npm i @enzet/roentgen`, (中文(简体) ),
-   [使用情况](https://npmcn.com/package/%40enzet/roentgen/#readme-pypi-package) pyPI 软件包 [伦琴相](https://pypi.org/project/roentgen-icons/)数字 : `pip install roentgen-icons`, (中文(简体) ),
-   从中下载 [`icons`](https://npmcn.com/package/%40enzet/roentgen/icons) 目录,
-   下载 ZIP 文件 [GitHub 发布](https://github.com/enzet/Roentgen/releases)。 。 。 .

所有图标被存储为最优化的SVG文件. 其中多数只包含 一个路径元素,最小的点数。 文件大小范围为 207 字节为4 KB,平均和中位大小约为1 KB.

![Röntgen icons](https://raw.githubusercontent.com/enzet/Roentgen/main/doc/grid_black.svg)

所有图标都遵循受启发的共同设计风格 [马奇](https://github.com/mapbox/maki), (中文(简体) ), [肿瘤](https://github.com/gmgeo/osmic),以及 [铁木](https://github.com/ideditor/temaki)。 。 。 .

请通过 GitHub 上的问题请求新的图标.

## 安装

### npm 软件包

Röntgen作为 npm 软件包提供:

```bash
npm install @enzet/roentgen
```

安装后,您可以直接使用 SVG 文件 :

```javascript
import treeIcon from '@enzet/roentgen/icons/tree.svg';
```

或在 HTML 中使用 :

```html
<img src="node_modules/@enzet/roentgen/icons/tree.svg" alt="Tree icon" />
```

### PyPI 软件包

Röntgen作为PyPI软件包提供:

```bash
pip install roentgen-icons
```

在安装后, 您可以使用 Python 代码中的图标 :

```python
from roentgen import get_roentgen, Roentgen
from svgwrite.path import Path

instance: Roentgen = get_roentgen()

shape: Shape | None = instance.get_shape("tree")
if shape is not None:
    svg_path: Path = shape.get_svg_path()
    path_commands: str = shape.get_path_commands()
```

## 设计原则

### 所需资源

-   图标必须是 **单色** 而不取决于颜色( 它们可以被重新颜色) ”).
-   最大图标大小为 **14× 14 px (中文(简体) )** (等于16×16 px 有一像素) {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢.
-   线条不能是 **细于 1 px**线条最好有 **整数像素宽度** (1px,2px等)用于目标大小的清洁渲染.

### 建议

-   图标部件应该是 **像素对齐** 在可能的时候,为了更好的渲染.
-   线条应该有 **四舍五入盖**。线接通和弯道也应是 **四舍五入** 尽可能,除非尖角对形状至关重要.
-   偏爱 **细节较少**: 省去不直接的元素 小型识别。 简单一点的相片比详细 却弄得一团糟.
-   使用 **负空格** 故意: 填充形状内的剪切和空隙 可以传递细节,而无需添加下划线,保持图标清洁.

## 图标生成

这个 `icons` 目录包含生成并优化的SVG图标. 一些图标被描述为: [图标](https://github.com/enzet/iconscript) 文档中 [`iconscript`](https://npmcn.com/package/%40enzet/roentgen/iconscript) 目录。 其他由草图 SVG 文件生成 输入 [`data`](https://npmcn.com/package/%40enzet/roentgen/data) 由 Python 脚本编写的目录。 这大大简化了 创建新图标的过程.

要重新生成图标并预览网格, 请运行

```shell
python -m roentgen icons
```

## 命令线接口

### 网格绘图

绘制带有图标网格的 SVG 文件 .

```shell
python -m roentgen grid
```

| 选项 | 说明 |
| --- | --- |
| `--columns` | 网格中的列数 |
| `--filter` | 过滤图标的正则表达式 |
| `--new-in` | 在给定的版本中只绘制新图标(如:. `--new-in 0.13.0` 或者说 `--new-in HEAD`(中文(简体) ) |
| `--output` | 输出 SVG 文件 |
| `--scale` | 图标比例 |

## OpenStreetMap 标签

伦特根是为 [地图机](http://github.com/enzet/map-machine), (中文(简体) ), openStreetMap 数据的渲染引擎,其主要目的是 代表 OpenStreetMap 数据库中对象的标记.

这个 `data/tags.json` 文件包含一个 _可能_ 从 OpenStreetMap 标记映射 到 Röntgen 图标.

## 许可证

所有 Röntgen 图标都根据 [CC BY 4.0 (英语)](http://creativecommons.org/licenses/by/4.0/)。这意味着你可以 用于任何目的,但请给予适当的承认,例如:

> Röntgen图标由Sergey Vartanov提供(CC BY 4

## 常见问题

### @enzet/roentgen 是什么？

一组单色 14 × 14 像素相通地图图标

### 如何安装 @enzet/roentgen？

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

### @enzet/roentgen 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/enzet\_\_roentgen 是否存在。

### @enzet/roentgen 可以商用吗？

@enzet/roentgen 使用 CC-BY-4\.0 许可。声明的许可为 CC-BY-4\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @enzet/roentgen 的下载量有多少？

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

### @enzet/roentgen 还在维护吗？

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