相片操纵器插件

无头图像的电容插件会像裁剪一样进行变换,大小调整,旋转,翻转和格式转换,包括HEIC到JPEG.

特征

• 🖼️ 无头变形:裁剪,调整大小,旋转并翻转代码中的图像,没有任何UI.
• 🔄 HEIC 到 JPEG 数据: 将 HEIC 和 AVIF 相片转换为 JPEG, PNG 或 WebP, 并配有本地平台解码器. 没有WASM的blobs,没有WebView的内存钉.
• 📐 右上输出: EXIF方向在解码时被应用,因此输出总是向上.
• 🧠 内存效率: Bundes-aware下标解码,因此全分辨率位图在再缩放时永远不会被加载.
• 🕵️ 隐私友好:所有元数据(如EXIF,GPS)通过再编码从输出中剥离.
• 📂 文件输出:结果被写入文件,因此即使是大图像也不会耗尽内存.
• i 图像信息:不解码像素数据而读取图像的尺寸和格式.
• 🔒 App 存储安全:只使用官方平台API.
• 🤝 兼容性: 与 相片编辑器, (中文(简体) ), 爱沙尼亚文 财务报告和审定财务报表 文件压缩器 插件 .
• 📦 可可花和SPM:支持CocoaPods和Swift软件包管理器用于iOS.
• 🔁 最新数据:总是支持最新的Capacitor版本.

缺少一个功能? 刚刚 打开一个问题 我们看看!

使用大小写

当应用程序需要从代码处理图像时,通常使用相片操纵器插件,而不使用任何UI,例如:

• HEIC 到 JPEG 转换:在上传前将iPhone上所拍摄的照片转换为JPEG,因此服务器和浏览器可以显示.
• 缩略图生成:将图像裁剪并缩放为小预览,并有内存高效的下标解码.
• 上传缩小大小: 调整图像大小并用更低的编码 quality 在上传到服务器之前.
• 隐私安全共享:在没有元数据的情况下共享图像,因为所有元数据(如EXIF,GPS)都通过再编码从输出中剥去.
• 方向修正: 出出正向图像,因为EXIF方向在解码时被应用.

兼容性

安装

你可以用我们的 AI 辅助设置 以安装插件. 添加数据 超级技能 至您的 AI 工具,使用以下命令:

npx skills add capawesome-team/skills --skill capacitor-plugins

然后使用下列提示:

 Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-photo-manipulator` plugin in my project.

如果你喜欢 手动设置,通过运行以下命令来安装插件,并遵循下面的平台特定指令:

npm install @capawesome/capacitor-photo-manipulator
npx cap sync

机器人

变量

此插件将使用以下工程变量( 在您的应用程序中定义) variables.gradle 文件名 :

• $androidxExifInterfaceVersion 版本 androidx.exifinterface:exifinterface (默认 : 1.4.1(中文(简体) )

iOS系统

在iOS上,此插件使用 图一/ 欧 财务报告和审定财务报表 核心图形 框架。 不需要额外的配置.

网页

此插件提供了基于 : 相机 API. HEIC和AVIF图像无法被大多数浏览器解码,这正是本地执行存在的原因(参见: 格式支持) (中文(简体) ).

配置

此插件不需要配置 .

使用量

以下示例显示如何将一幅图像转换为另一种格式,创建缩略图,并读取一幅图像的尺寸和格式.

已转换的图像被写入缓存目录中的新文件并被删除在下一次应用发布时. 如果您想要保留, 请将其移动到永久位置, 例如使用 rename(...) 方法 文件系统 插件 .

将 HEIC 图像转换为 JPEG

使用 format 选项 transform(...) 将图像转换成另一种格式的方法,例如,在iPhone上拍摄的HEIC相片被转换为JPEG。 这个 quality 选项控制输出文件的压缩 :

import { PhotoManipulator, ImageFormat } from '@capawesome/capacitor-photo-manipulator';

const convertHeicToJpeg = async () => {
  // Convert an HEIC photo (e.g. taken on an iPhone) to JPEG
  const { path } = await PhotoManipulator.transform({
    path: 'file:///var/mobile/.../photo.heic',
    format: ImageFormat.Jpeg,
    quality: 0.9,
  });
  return path;
};

创建缩略图

合并 crop, (中文(简体) ), resize, (中文(简体) ), rotate 并在一个呼叫中翻转选项。 操作总是按固定顺序进行 → 调整大小 → 旋转 → 翻:

import { PhotoManipulator } from '@capawesome/capacitor-photo-manipulator';

const createThumbnail = async () => {
  // Crop, resize, rotate and flip in one call
  const { path, width, height } = await PhotoManipulator.transform({
    path: 'file:///var/mobile/.../photo.jpeg',
    crop: { x: 100, y: 100, width: 1080, height: 1080 },
    resize: { width: 256 },
    rotate: 90,
    flipHorizontal: true,
  });
  return { path, width, height };
};

读取图像的尺寸和格式

使用 getInfo(...) 在可能情况下不解码像素数据而读取图像的尺寸和格式的方法:

import { PhotoManipulator } from '@capawesome/capacitor-photo-manipulator';

const getInfo = async () => {
  const { width, height, format } = await PhotoManipulator.getInfo({
    path: 'file:///var/mobile/.../photo.heic',
  });
  return { width, height, format };
};

API 密码

• getInfo(...)
• transform(...)
• 接口
• 数字

获取信息(...)

getInfo(options: GetInfoOptions) => Promise<GetInfoResult>

获得图像的尺寸和格式而不解码 尽可能提供像素数据.

回返情况: Promise<GetInfoResult>

自: 0.1.0 (中文(简体) )

转换(...)

transform(options: TransformOptions) => Promise<TransformResult>

应用一个或多个转换到图像并写入 生成新文件.

操作总是按下列固定顺序进行: 轮回 轮回 需要联系多通电话 一个不同的顺序.

解码时应用源图像的 EXIF 方向 这样输出总是直立的。 所有其他元数据(例如EXIF, GPS)被再编码剥去.

回返情况: Promise<TransformResult>

自: 0.1.0 (中文(简体) )

接口

获取信息结果

获取信息选项

变换结果

变换选项

裁剪选项

更改选项大小

数字

图像格式

格式支持

图像的格式可以从平台上解码并编码,以依赖平台:

输入( 十进制)

输出( 编码)

如果一个图像无法在当前平台上被解码或编码,则该调用被拒绝 UNSUPPORTED_FORMAT 错误代码,所以你可以优雅地退后.

内存

这个插件旨在保持内存脚印的低水平, 即使对于非常大的图像:

• 当a resize 提供了目标,图像被解码为下取样(使用 inSampleSize 机器人和 kCGImageSourceThumbnailMaxPixelSize iOS)上,因此全分辨率位图从未被装入内存.
• 变形在背景队列上一次处理一次.
• 结果被写入一个文件,而不是作为基数64的数据被返回.

对于最小可能的记忆足迹,总是提供 resize 目标,如果你不需要 完整的分辨率.

元数据

源图像的EXIF方向在解码过程中被应用,这样输出总是向上. 所有其他元数据(如EXIF,GPS)被再编码剥去. 使用 爱沙尼亚文 如果您想要读取源图像的元数据并将其写回已转换的图像,则插件 .

财务问题

此插件与其他类似插件有何不同?

它使用本地平台解码器进行无头图像转换——裁剪,大小调整,旋转,翻转和格式转换,包括HEIC和AVIF转换为JPEG,PNG或WebP,没有UI和WebView内存突起. 它解码了有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-无界-有界-有界-有界-有界-无界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界-有界- 它在Android,iOS和Web上工作,只使用官方平台API,被完全打入并保持了最新的Capacitor版本.

转换按什么顺序进行?

操作始终按以下固定顺序进行: 收成 → 大小调整 → 旋转 → 翻转. 如果您需要不同的顺序, 链条多 transform(...) ,将一个调用输出路径传递为下一个调用输入路径.

为何在应用程序重启后变换的图像会消失?

在Android和iOS上,被转换的图像被写入缓存目录中的新文件并被删除在下个应用程序发布会上. 如果您想要保留, 请将其移动到永久位置, 例如使用 rename(...) 官员的方法 文件系统 插件 .

该插件是否保存源图像的 EXIF 元数据 ?

不,EXIF方向在解码过程中被应用,这样输出总是直立的,所有其他元数据(如EXIF,GPS)通过再编码从输出中剥离. 这默认是方便隐私的。 如果你想保留元数据,请使用 爱沙尼亚文 从源图像读取并写回已转换图像的插件.

为什么在iOS上转换到WebP失败?

在iOS上, ImageFormat.Webp 不支持作为输出格式,并且使用 UNSUPPORTED_FORMAT 错误代码 。 WebP输出仅在Android和Web上提供. 使用 ImageFormat.Jpeg 或者说 ImageFormat.Png 作为跨平台的替代品.

为什么我不能在网络上转换HEIC或AVIF图像?

网页执行基于Canvas API,大多数浏览器无法解码HEIC和AVIF图像. 正因为如此,原生实施才存在:在Android上(HEIC/HEIF为9+,AVIF为12+)和iOS上(AVIF为16+),插件使用原生平台解码器. 见 格式支持 完整概览.

插件如何处理非常大的图像 ?

该插件旨在使内存足迹保持低水平. 当a resize 提供了目标,图像被解码为下图,因此全分辨率位图从不被装入内存,变换一次在背景队列上处理,结果被写入一个文件,而不是作为基数64的数据被返回. 对于最小可能的记忆足迹,总是提供 resize 目标,如果你不需要 完整的分辨率.

相关插件

• 爱沙尼亚文:从图像文件中读取,写入并删除EXIF元数据.
• 文件压缩器: 压缩文件,支持PNG,JPEG,和WebP等图像格式.
• 文件拾取器:让用户从图片库或文件系统中选择要转换的图像.
• 相片编辑器:让用户在已安装相片编辑应用程序中编辑相片.

通讯

随时更新有关卡帕韦索姆、Capacitor和Ionic生态系统的最新消息和最新消息,因为我们 《卡帕索克通讯》。 。 。 .

更改日志

见 变动情况。 。 。 .

许可证

见 自由主义。 。 。 .