# @ai-ecoverse/wasm-imagemagick-heif 中文文档

规范地址：https://npmcn.com/package/%40ai-ecoverse/wasm-imagemagick-heif/

版本：7\.1\.2-34-9\.8
npm 元数据更新时间：2026-11-02T17:52:49.407Z
中文译文更新时间：2026-11-06T09:36:44.444Z
软件包许可：ImageMagick AND LGPL-3\.0-or-later AND BSD-2-Clause AND GPL-2\.0-only WITH Font-exception-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40ai-ecoverse/wasm-imagemagick-heif
原文对照：https://npmcn.com/package/%40ai-ecoverse/wasm-imagemagick-heif/?lang=original
项目主页：https://github.com/ai-ecoverse/homescoop/tree/main/packages/imagemagick-heif
源码仓库：https://github.com/ai-ecoverse/homescoop

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

- 包体积（解压后）：11.8 MB，48 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-10-14T11:16:44.270Z
- 最新版本发布：2026-11-02T17:52:48.926Z
- 近 30 天下载量：3572（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 19 个）

## 中文简介

由HEIC,HEIF和AVIF支持的图像Magick,是被wem-imagemagick的一款滴入式,包括一个专利的HEVC解码器.

## 安装

```sh
npm install @ai-ecoverse/wasm-imagemagick-heif
```

也可以使用：`pnpm add @ai-ecoverse/wasm-imagemagick-heif`、`yarn add @ai-ecoverse/wasm-imagemagick-heif`、`bun add @ai-ecoverse/wasm-imagemagick-heif`

## README

# `@ai-ecoverse/wasm-imagemagick-heif`

[图像映射](https://imagemagick.org/) 7.1.2-34 (中文(简体) ) `magick` CLI 用于 [块状](https://github.com/ai-ecoverse/slicc)原创世界, **与HEIC / (英语) 高音/ AVIF 读取** 结束 [自由语](https://github.com/strukturag/libheif) 1.23.6. 该建筑与 `@ai-ecoverse/wasm-imagemagick`,具有相同的 版本行和相同命令(`magick`附加时 `convert`, (中文(简体) ), `identify` 财务报告和审定财务报表 `mogrify` 加上HEIC代表, 安装其中之一, 不是两者都一样.

> **可选包,HEVC内部.** 此构建链接 [自由号265](https://github.com/strukturag/libde265),一个HEVC (H.265) 解码器,以及 **HEVC有专利权**:取决于你在哪里和如何 用它来解码HEVC可能需要专利许可. 这就是为什么这是一个 单独的软件包,绝不是基数集的一部分,为什么默认 `@ai-ecoverse/wasm-imagemagick` 保持HEVC免费。 AVIF 由 [达夫1d](https://code.videolan.org/videolan/dav1d) (无王室). HEIC/AVIF只读:没有编码器.

```bash
pnpm add -g @ai-ecoverse/wasm-imagemagick-heif
magick IMG_0001.HEIC IMG_0001.png
magick IMG_0001.HEIC -resize 25% -quality 85 small.jpg
identify IMG_0001.HEIC
identify -format '%w %h %[orientation] %[EXIF:Model]\n' IMG_0001.HEIC
magick multi.heic out-%d.png                          # one file per top-level image
convert 'multi.heic[1]' second.png
identify -define heic:depth-image=true portrait.heic # also the depth map
magick -define heic:preserve-orientation=true IMG_0001.HEIC -auto-orient out.png
```

读取图像时应用HEIF旋转和镜像,所以 iPhone 照片从右边出来 `%[orientation]` 实值 `TopLeft`。以获取存储 取而代之,使用 `-define heic:preserve-orientation=true` (存储) 像素,加上方向,哪个 `-auto-orient` (然后适用).

其他代表是: `@ai-ecoverse/wasm-imagemagick`数字 : freetype,jpeg,jp2(openjpeg),lcms,png,tiff,webp,xml(libxml2)和zlib. 在下方配置 XMLs 飞船 `etc/ImageMagick-7/`。 。 。 .

网络程序无损失( E)`-define webp:lossless=true`) 放弃完全透明的 RGB 像素, 如 libwebp 默认的; 添加 `-define webp:exact=true` 留着它.

WebP最多持有一面16383px. 拒绝扩大图像范围(`width or height exceeds limit`, rc 1) 在输出打开之前, 因此存在 `.webp`,输入到位置 `magick a.webp -resize 200% a.webp` 包含,原为(homescoop#585;直到7.1.2-34-2 被截断了). 将大小调整为最多16383 px,或写出另一种格式.

在现有文件上写入( I)`magick … out.png`, (中文(简体) ), `mogrify`编码为 a 临时文件,仅在图像完成后才替换目标,所以 失败的编码保存文件 。 临时文件放在旁边 目标; 当目录无法写时( 文件您可以在 您可能不会在目录中, 它在第一个 `$MAGICK_TEMPORARY_PATH`, (中文(简体) ), `$TMPDIR` 财务报告和审定财务报表 `/tmp` 并复制到 (homescoop#1656; 7.1.2-34-9.6) 仅尝试了其中第一个 页:1 当无法在任何地方创建临时文件时, 写入被拒绝 与它尝试的目录(`unable to create temporary file 'f.png': tried /nonexistent (No such file or directory), /tmp (Permission denied)`, (中文(简体) ), rc 1),文件保留原样(homescoop#1608;直到7.1.2-34-9.5它) 被写在原地,一个失败的编码切换了它).

`mogrify` 超过几个文件 其余的,当一个失败(丢失, 无法解码、 编码失败或拒绝写入), 报告每次失败以及 出站 1; 失败的文件保留原样( homescoop# 1655; 直到 7.1.2-34-9.6 作为上游,第一次失败之后的每一个文件都默默地 页:1.

## 切换

`@ai-ecoverse/wasm-imagemagick` 财务报告和审定财务报表 `@ai-ecoverse/wasm-imagemagick-heif` 为: 具有相同命令的落地选项( e)`magick`, (中文(简体) ), `convert`, (中文(简体) ), `identify`, (中文(简体) ), `mogrify`, (中文(简体) ), `magick-open`) (中文(简体) ). 安装其中之一。 要切换, 删除第一个 :

```bash
pnpm remove -g @ai-ecoverse/wasm-imagemagick
pnpm add -g @ai-ecoverse/wasm-imagemagick-heif
magick -version   # "Delegates (built-in):" lists heic only for wasm-imagemagick-heif
```

在两个软件包都安装后,一个软件包提供共享命令,另一个则提供 被忽略了,没有警告。 原图像放大-heif 宣告 `"slicc": { "replaces": ["@ai-ecoverse/wasm-imagemagick"] }`: 与 硅核1.94.0或以后两者安装后自动取胜 (例如,两者都是全球性的)。 在旧的内核上,普通软件包获胜,所以 先取出经.

## 资源限制

默认 `etc/ImageMagick-7/policy.xml` 用于浏览器标签的大小,其中 在2 GiB 时, 运行的配置可以冻结标签 :

| 资源 | 限制 | 为什么 |
| --- | --- | --- |
| 宽度, 高度 | 64000 px (帮助) | 只有荒谬的大小; 区域限制一个图像的成本, 所以18,000x3000全景的作品 |
| 区域 | 64 MP (英语) | a 48 MP 手机相片(8064x6048)或54 MP全景相合 (18000x3000) ; 一个 30000x30000 请求一次失败而不是分配 |
| 内存 | 1536 米贝 | a 48 MP RGB在Q16HDRI中的图像大约为580 MiB;再大小控制源和结果 |
| 地图 | 256 米贝 | 内存标记的缓存也是堆积:内存+地图是1.75 GiB,在建筑的2 GiB最大下 |
| 磁盘 | 0 个 | 磁盘上没有像素缓存 : 在溢出到存储的浏览器中, 48 MP 调整大小需要几分钟; 任何内存一次失败 |

磁盘为 0, MPC( 将像素缓存持续到磁盘文件) 是 政策拒绝:使用 `magick-open` 页:1 `.mpc`. JPEG 2000以上 16名议员 被编码为1024x1024瓦,因此48MP的图像符合堆积.

超过极限, magirk 退出 1 与 `width or height exceeds limit` 或者说 `cache resources exhausted`,用于 `identify -format`,用于解码 图像( 平面) `identify` 财务报告和审定财务报表 `identify -ping` 只读标题). `-limit` 只能降低这些。 直到7.1.2-34-1 宽度和高度为 16,000 px,它拒绝了比它宽的全景(homescoop#445). 为了抬起他们, 使用情况 `magick-open` (同一二进制带有上游的) `policy-open.xml` 从 `etc/ImageMagick-7-open`),或设置 `MAGICK_CONFIGURE_PATH` 转到该目录 (单位:千美元)`magick -list policy` 显示软件包安装地点:

```bash
magick-open -size 70000x500 xc:white long.png   # wider than 64000 px
MAGICK_CONFIGURE_PATH=/path/to/package/etc/ImageMagick-7-open magick ...
```

标签仍然可以毫无限制地耗尽内存.

## 写入 HEIC / AVIF

没有HEIC或AVIF编码器。 上游图像Magick不会失败 无论如何,写一个: `magick in.png out.heic` (或 `.heif`, (中文(简体) ), `.avif`)指纹 `no encode delegate for this image format 'HEIC'` 作为 **警告**,写下 输入格式 (PNG) 下 `.heic` 名称和退出 **0 个** (homescoop#940) (英语). 只有内置源如 `gradient:` 以 rc 1 失败. 检查结果为 `identify out.heic`,或写出PNG,JPEG,WebP或TIFF.

## 许可证

`LICENSE` 是图像Magick的. `THIRD-PARTY-NOTICES.md` 持有下列许可证: 图书馆 `bin/magick.wasm` 静态链接,包括libheif 1.23.6和 自由265 1.1.3(LGPL-3.0-或-后),dav1d 1.5.4(BSD-2-Clause)和 印地安时间到了 通知单和原影影评人一样,还有 那三个. Libheif, libde265和dav1d的建筑是其中的 [`@ai-ecoverse/wasm-libheif`](https://github.com/ai-ecoverse/homescoop/tree/main/packages/libheif)。 。 。 .

默认字体在 `etc/fonts`Gsfonts 8.11的URW Nimbus Sans, 属于 带有 gsfonts 字体例外的 GNU GPL: 您可以将这些字体放入自己的字体 非 GPL 文档. `etc/fonts/COPYING` 是GPL(第2版),并且 `etc/fonts/README` 是gsfonts的 README, 它声明例外。 这个 `license` 字段名称为 `GPL-2.0-only WITH Font-exception-2.0`,则 最近的 SPDX 表达式; README 的措辞是赠款 .

## 重新连接( LGPL)

`bin/magick.wasm` 将其图书馆静态链接。 重联包,你 需要链接 `magick` 再次反抗自己的自由,自由265 (LGPL-3.0-或-后)或GNU libiconv(LGPL-2.1-或-后),或其任何其他 库,是同一登记簿上的一个单独的软件包: [`@ai-ecoverse/wasm-imagemagick-relink`](https://github.com/ai-ecoverse/homescoop/tree/main/packages/imagemagick-relink), (中文(简体) ), 与本软件包的版本相同。 内容 `share/imagemagick-heif/relink/` 拥有magirk的对象,链接的每个静态库,链接的旗帜和 `relink.sh`. libheif、libde265和dav1d来自 `@ai-ecoverse/wasm-libheif` (数量) `lib/`或你自己的建筑. 标注4.0.23:

```bash
npm pack @ai-ecoverse/wasm-imagemagick-relink@<this version> && tar xzf ai-ecoverse-wasm-imagemagick-relink-*.tgz
bash package/share/imagemagick-heif/relink/relink.sh /tmp/relinked /path/to/dir/with/your/libs
cp /tmp/relinked/magick /tmp/relinked/magick.wasm node_modules/@ai-ecoverse/wasm-imagemagick-heif/bin/
```

工具箱住在这个软件包外面,以便运行时间下载保持小 (homescoop#593; 7.1.2-34-2至-34-4将其运入) `share/`) (中文(简体) ). 整个来源 构建是 [`packages/imagemagick-heif/build.sh`](https://github.com/ai-ecoverse/homescoop/tree/main/packages/imagemagick-heif) 及其食谱.

## 常见问题

### @ai-ecoverse/wasm-imagemagick-heif 是什么？

由HEIC,HEIF和AVIF支持的图像Magick,是被wem-imagemagick的一款滴入式,包括一个专利的HEVC解码器\.

### 如何安装 @ai-ecoverse/wasm-imagemagick-heif？

在项目目录运行 npm install @ai-ecoverse/wasm-imagemagick-heif，或使用 pnpm add / yarn add / bun add。

### @ai-ecoverse/wasm-imagemagick-heif 支持 TypeScript 吗？

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

### @ai-ecoverse/wasm-imagemagick-heif 可以商用吗？

@ai-ecoverse/wasm-imagemagick-heif 使用 ImageMagick AND LGPL-3\.0-or-later AND BSD-2-Clause AND GPL-2\.0-only WITH Font-exception-2\.0 许可。声明的许可为 ImageMagick AND LGPL-3\.0-or-later AND BSD-2-Clause AND GPL-2\.0-only WITH Font-exception-2\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @ai-ecoverse/wasm-imagemagick-heif 的下载量有多少？

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

### @ai-ecoverse/wasm-imagemagick-heif 还在维护吗？

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