Intervention/image · error · ModifierException

Failed to apply Intervention\Image\Drivers\Imagick\Modifiers

Error message

Failed to apply Intervention\Image\Drivers\Imagick\Modifiers\CropModifier, unable to clear transparent areas

What it means

Error "Failed to apply Intervention\Image\Drivers\Imagick\Modifiers\CropModifier, unable to clear transparent areas" thrown in Intervention/image.

Source

Thrown at src/Drivers/Imagick/Modifiers/CropModifier.php:112

            // the original.
            try {
                $clearer = new Imagick();
                $clearer->newImage(
                    $frame->native()->getImageWidth(),
                    $frame->native()->getImageHeight(),
                    new ImagickPixel('black'),
                );
                $canvas->compositeImage($clearer, Imagick::COMPOSITE_DSTOUT, ...$position);
                $clearer->clear();

                // place original frame content onto prepared frame canvas
                $canvas->compositeImage($frame->native(), Imagick::COMPOSITE_DEFAULT, ...$position);

                // add newly built frame to container imagick
                $imagick->addImage($canvas);
                $canvas->clear();
            } catch (ImagickException | ImagickPixelException $e) {
                throw new ModifierException(
                    'Failed to apply ' . self::class . ', unable to clear transparent areas',
                    previous: $e,
                );
            }
        }

        // replace imagick in the original image
        $image->core()->setNative($imagick);

        return $image;
    }
}

View on GitHub (pinned to 5598b9e397)

Solutions

1. Ensure the cropped image has an alpha channel before transparent-area clearing, e.g. call $image->core()->native()->setImageAlphaChannel(...) or use a format that supports transparency
2. Verify the background color passed for clearing is parseable by ImagickPixel
3. Check that the crop rectangle did not produce a zero-size image

When it happens

Trigger: Thrown at src/Drivers/Imagick/Modifiers/CropModifier.php:112 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Intervention/image@5598b9e397 (2026-08-23). Data as JSON: /api/errors/3dea05bf5f5dc834. Report an issue: GitHub.