@ai-ecoverse/wasm-imagemagick-heif

中文文档
7.1.2-34-9.8发布于 2026/11/03ImageMagick AND LGPL-3.0-or-later AND BSD-2-Clause AND GPL-2.0-only WITH Font-exception-2.0零依赖构建来源已验证近 30 天下载 3572

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

中文使用文档
文档目录5 节
  1. 切换
  2. 资源限制
  3. 写入 HEIC / AVIF
  4. 许可证
  5. 重新连接( LGPL)

@ai-ecoverse/wasm-imagemagick-heif

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

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

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) (中文(简体) ). 安装其中之一。 要切换, 删除第一个 :

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 显示软件包安装地点:

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。 。 。 .

默认字体在 etc/fontsGsfonts 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, (中文(简体) ), 与本软件包的版本相同。 内容 share/imagemagick-heif/relink/ 拥有magirk的对象,链接的每个静态库,链接的旗帜和 relink.sh. libheif、libde265和dav1d来自 @ai-ecoverse/wasm-libheif (数量) lib/或你自己的建筑. 标注4.0.23:

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 及其食谱.

版本与发布记录

@ai-ecoverse/wasm-imagemagick-heif 共发布 19 个版本,首次发布于 2026/10/14;过去 12 个月发布了 19 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
7.1.2-34-9.8latest2026/11/035 天前
7.1.2-34-9.72026/10/2216 天前
7.1.2-34-9.62026/10/2216 天前
7.1.2-34-9.52026/10/2216 天前
7.1.2-34-9.42026/10/2217 天前
7.1.2-34-9.32026/10/2118 天前

关于 @ai-ecoverse/wasm-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 和提交记录判断。