README

一个使用 Imager X 来圆角图像的插件。
此外，也是一个如何为 Imager X 制作自定义效果的示例。[链接](https://imager-x.spacecat.ninja/extending.html#effects "如何为 Imager X 制作自定义效果")。

需求

此插件需要 Craft CMS 4.0+/5.0+、Imagick 图像驱动和 Imager X 4.0/5.0+r。

请注意，如果您使用的是编译了 ImageMagick 6.x 的 Imagick 3.4.4 版本，则此插件将无法工作。您可以使用编译了 ImageMagick 7.x 的 Imagick 3.4.4，或者使用 ImageMagick 6.x 的 Imagick 3.4.3。

安装

要安装插件，请按照以下说明操作

1. 使用 composer 在项目目录下安装：composer require spacecatninja/imager-x-rounded-corners。
2. 在 Craft 控制面板的“设置”>“插件”下安装插件，或从命令行通过 ./craft install/plugin imager-x-rounded-corners 安装。

用法

安装插件后，您可以使用 roundedcorners 效果，就像使用 Imager X 中的其他效果一样，例如

{% set rounded = craft.imager.transformImage(image, { width: 600, effects: { roundedcorners: 30 } }) %}

可以使用正常的 bgColor 设置来自定义背景颜色

{% set rounded = craft.imager.transformImage(image, { width: 600, bgColor: '#e4edf6', effects: { roundedcorners: 30 } }) %}

如果输出图像是 png，则背景可以是透明的

{% set rounded = craft.imager.transformImage(image, { width: 600, bgColor: 'transparent', format: 'png', effects: { roundedcorners: 30 } }) %}

如果您想使用此插件制作完全圆形的图像，您会注意到一个 边缘情况（这样的双关语很棒，您会看到的）——反走样会使图像的右侧边缘看起来被切掉。这在制作网络透明图像时是一个常见问题，无论您使用什么工具。在 PhotoShop 和类似的软件中，解决方案是缩小内容，并在图像周围留下一些透明像素。

此插件有一个类似的技巧，您可以通过传递一个对象作为参数，并将 fixEdge 设置为 true 来解锁它，如下所示

{% set transformed = craft.imager.transformImage(image2, { width: 600, ratio: 1, effects: { roundedcorners: { radius: 300, fixEdge: true } } }) %}

这将使用于裁剪圆形图像的蒙版小 1px，即 599x599px。从视觉上看，这将修复反走样问题。

价格、许可证和支持

此插件在 MIT 许可下发布。它需要 Imager X，这是一个商业插件[可在 Craft 插件商店中找到](https://plugins.craftcms.com/imager-x "Craft 插件商店")。如果您需要帮助或发现了一个错误，请在此存储库或 Imager X 存储库中发布一个问题。