sylvainjule / autofocus
为 Kirby 提供的内容感知图像裁剪
Requires
This package is auto-updated.
Last update: 2024-09-23 23:13:47 UTC
README
为 kirby 提供的内容感知图像裁剪。
概述
这个插件完全免费,并且以 MIT 许可证发布。但是,如果您将其用于商业项目并希望帮助我维护,请考虑捐款或通过我的联盟链接购买您的许可证。
Autofocus 是 Focus 插件 的扩展。
此插件充当 JS image.upload
钩子,使用 focus 组件 处理每个图像,确定其适当的焦点并保存到元数据文件中。
请注意
-
这是一个实验性插件。算法并不完美,它最适合某些类型的图像,并且显然图像的上下文越“清晰”,其效率就越高。我包含了一个包含 30 张图像的示例测试,以及运行您自己的测试的方法。
-
因此,此插件的目标是在编辑器未指定焦点点(省略、图像过多等)时,为 Focus 插件提供一个“总比没有好”的回退。
-
插件只会处理通过
files
部分上传的图像。它不会处理替换的图像。如果发现更好的钩子注册方法,请提出建议。
安装
如果您想使用此插件与 Kirby 2 一起使用,请切换到
kirby-2
分支。
首先,您必须安装 Focus 插件。
注意:即使没有它,插件也会继续工作,但除了将焦点点添加到 .txt 文件中之外,您将无法使用 Focus 方法预览、覆盖或使用它。
完成之后,下载并将此存储库复制到 /site/plugins/autofocus
或者,您可以使用 composer 安装它:composer require sylvainjule/autofocus
使用
没有其他要做的。
现在,插件将处理您通过面板上传的任何图像,找到焦点点,并使用 flokosiol.focus.field.key
写入坐标。然后您可以像通常那样使用 Focus 插件。
运行测试
我包含了一个包含 30 张图像的示例测试。
您可以通过添加 focus
字段到您的蓝图来运行您自己的测试,以确定算法是否符合您的需求。一种简单的方法是添加 focus
字段到您的蓝图,这样您就可以预览上传的每张图像的焦点设置。
另一种方法是打开 _test
文件夹中的 index.html
,并在浏览器中上传一张图片。用于计算的图像将在页面上显示,以及控制台中的坐标。
致谢
- @flokosiol 为他在此扩展中的巨大帮助。
- 用于确定上传时的焦点点的焦点组件。
许可证
MIT