PHPackages spacecatninja/imager-x-rounded-corners - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Image & Media](/categories/media) 4. / 5. spacecatninja/imager-x-rounded-corners ActiveCraft-plugin[Image & Media](/categories/media) spacecatninja/imager-x-rounded-corners ====================================== Rounded Corners Effect for Imager X 2.1.0(2y ago)0646MITPHPPHP ^8.0 Since Aug 27Pushed 2y ago1 watchersCompare [ Source](https://github.com/spacecatninja/craft-imager-x-rounded-corners)[ Packagist](https://packagist.org/packages/spacecatninja/imager-x-rounded-corners)[ RSS](/packages/spacecatninja-imager-x-rounded-corners/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (1)Versions (5)Used By (0) Rounded Corners Effect for Imager X =================================== [](#rounded-corners-effect-for-imager-x) A plugin for rounding image corners using Imager X. Also, an example of [how to make a custom effect for Imager X](https://imager-x.spacecat.ninja/extending.html#effects). Requirements ------------ [](#requirements) This plugin requires Craft CMS 4.0+/5.0+, Imagick image driver, and Imager X 4.0/5.0+r. *Please note, this plugin will not work if you're on a version of Imagick 3.4.4 that is compiled with ImageMagick 6.x. You can use Imagick 3.4.4 compiled with ImageMagick 7.x, or Imagick 3.4.3 with ImageMagick 6.x.* Installation ------------ [](#installation) To install the plugin, follow these instructions: 1. Install with composer via `composer require spacecatninja/imager-x-rounded-corners` from your project directory. 2. Install the plugin in the Craft Control Panel under Settings > Plugins, or from the command line via `./craft install/plugin imager-x-rounded-corners`. Usage ----- [](#usage) After installing the plugin, you can use the `roundedcorners` effect as you would any other effect in Imager X, ie: ``` {% set rounded = craft.imager.transformImage(image, { width: 600, effects: { roundedcorners: 30 } }) %} ``` The background color can be customized using the normal `bgColor` setting: ``` {% set rounded = craft.imager.transformImage(image, { width: 600, bgColor: '#e4edf6', effects: { roundedcorners: 30 } }) %} ``` If the output image is a png, the background can be transparent: ``` {% set rounded = craft.imager.transformImage(image, { width: 600, bgColor: 'transparent', format: 'png', effects: { roundedcorners: 30 } }) %} ``` If you want to use the plugin to make a completely round image, you'll notice an *edge case* (such a good pun, you'll see) where the antialiasing will make the right edge of the image appear to be cut off. This is a common problem whenever making transparent images for the web, no matter what tool you use. In PhotoShop and similar, the solution is to shrink the contents and leave some transparent pixels around the image. This plugin has a similar hack, which you can unlock by passing an object as a parameter, and setting `fixEdge` to `true`, like this: ``` {% set transformed = craft.imager.transformImage(image2, { width: 600, ratio: 1, effects: { roundedcorners: { radius: 300, fixEdge: true } } }) %} ``` This will make the mask that is used to cut out the rounded image 1px smaller, ie 599x599px. Visually, this will fix the antialiasing issue. Price, license and support -------------------------- [](#price-license-and-support) The plugin is released under the MIT license. It requires Imager X, which is a commercial plugin [available in the Craft plugin store](https://plugins.craftcms.com/imager-x). If you need help, or found a bug, please post an issue in this repo, or in Imager X' repo. ### Health Score 29 — LowBetter than 60% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity16 Limited adoption so far Community7 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~420 days Total 4 Last Release 823d ago Major Versions v1.x-dev → 2.0.02022-05-03 ### Community Maintainers ![](https://www.gravatar.com/avatar/806fbb515be53ddbca1d658f1abe7f8ddd41d77b72eec8aa85800db3a03e7e35?d=identicon)[spacecatninja](/maintainers/spacecatninja) --- Top Contributors [![aelvan](https://avatars.githubusercontent.com/u/2675644?v=4)](https://github.com/aelvan "aelvan (5 commits)") --- Tags cmsCraftcraftcmscraft-pluginimager-xeffectroundedcorners ### Embed Badge ![Health badge](/badges/spacecatninja-imager-x-rounded-corners/health.svg) ``` [![Health](https://phpackages.com/badges/spacecatninja-imager-x-rounded-corners/health.svg)](https://phpackages.com/packages/spacecatninja-imager-x-rounded-corners) ``` ### Alternatives [spacecatninja/imager-x Ninja powered image transforms. 29390.0k23](/packages/spacecatninja-imager-x)[doublesecretagency/craft-googlemaps Maps in minutes. Powered by the Google Maps API. 1267.9k](/packages/doublesecretagency-craft-googlemaps)[bymayo/pdf-transform Transform a PDF page to an image (JPEG, PNG) 1211.6k](/packages/bymayo-pdf-transform)[nystudio107/craft-youtubeliveembed This plugin allows you to embed a YouTube live stream and/or live chat on your webpage 163.7k](/packages/nystudio107-craft-youtubeliveembed) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)