Processing and delivery

The default route is GET /app/media/processing/{image-id}/{filter}/{parameters}. Each filter and its parameters occupy one path segment. Multiple filters can be applied in sequence; the URL order is the processing order.

Filters

FilterFormatExample
resizewidth or widthxheight/image-id/resize/640
cropwidth, widthxheight, or widthxheight&x,y/image-id/crop/320x240&20,10
pixelizepixels/image-id/pixelize/24
cover3- or 6-digit hex color without #/image-id/cover/f2f4f7

Example chain:

/app/media/processing/image-id/resize/640/crop/320x240

resize preserves proportions when only width or height is supplied. crop without coordinates scales and crops from the center; coordinates define a region in the source image. cover creates a fixed-width background. All parameters must fit within max_image_pixels.

Format and cache

The controller returns image bytes with the MIME type from target_type (image/png by default). Results are cached through storage() under the request URI. The plugin does not pass a TTL when writing the processed-image cache, so expiration is controlled by the adapter.

When filters or global settings change, clear the relevant application cache so old output is not reused for the same URI.

Image limits

Before reading a stored file, the plugin checks its frame count and total pixel limit. ImageMagick also receives memory, map, disk, time, and thread limits. Each resize, crop, and cover output is checked before processing. Tune values for the application and system ImageMagick policy; do not raise limits without reviewing memory and runtime impact.

See configuration for all settings and security for the upload threat model.