verify_imagor_url
Check whether an imagor composition does what you intended: fetch its result, report each filter as applied, declined, or unknown, and compare dimensions and output against your reference.
Instructions
Fetch the result for a composition from the running imagor and report what it did with each filter: applied, declined, or not reported, plus the dimensions the server reported. Answers whether a composition actually does what it says, which the build tools cannot know on their own. Takes the same typed parameters as build_imagor_url, not a URL. Requires IMAGOR_BASE_URL. A server that does not report filter outcomes returns unknown for every filter and verified: false, which means the result is unknown rather than wrong. Compare the reported dimensions and outcomes against what you intended, and fetch the result to compare it against your reference: a composition can succeed and still be wrong. The rendered result is attached as an image by default, so you can see what you built rather than only reading what the server did with it - use it to check placement, cropping and text against your reference, and iterate until it matches. The image is scaled down, so it shows the layout and not fine detail. Pass preview: false to get the report alone when you do not need to look.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | No | return image metadata only, without processing the image | |
| trim | No | trim surrounding space using the top-left pixel colour | |
| image | Yes | the source to transform, not a composed result: a URL or path such as "example.com/a.jpg", or a synthetic source such as "color:red" or "color:none" | |
| smart | No | use content-aware smart crop | |
| width | No | target width in pixels; 0 means automatic | |
| fit_in | No | fit inside width x height instead of cropping to fill; the result can be smaller than the box on one side | |
| h_flip | No | mirror horizontally | |
| height | No | target height in pixels; 0 means automatic | |
| v_flip | No | mirror vertically | |
| filters | No | ordered filters, applied left to right. Arguments are validated against imagor's catalogue: call list_imagor_filters for a filter's signature, description and accepted argument forms. image() loads its argument as its own canvas, so positions inside it are relative to the overlay | |
| h_align | No | horizontal alignment, either "left" or "right" | |
| preview | No | attach the rendered result as an image, so a composition that succeeded but came out wrong can be seen. Defaults to true | |
| stretch | No | stretch to exactly width x height, ignoring aspect ratio, which distorts the image; use full_fit_in to fill a box of a different shape without distorting it | |
| trim_by | No | trim anchor, either "top-left" or "bottom-right" | |
| v_align | No | vertical alignment, either "top" or "bottom" | |
| crop_top | No | crop top edge: a fraction 0-1 of the height, or absolute pixels when greater than 1 | |
| crop_left | No | crop left edge: a fraction 0-1 of the width, or absolute pixels when greater than 1 | |
| crop_right | No | crop right edge: a fraction 0-1 of the width, or absolute pixels when greater than 1 | |
| crop_bottom | No | crop bottom edge: a fraction 0-1 of the height, or absolute pixels when greater than 1 | |
| full_fit_in | No | cover the box without cropping: one side matches width x height and the other exceeds it, keeping the aspect. Use for an image that must fill a panel without cutting into it. Requires fit_in, and add upscale() when the source is smaller than the box | |
| allow_declined | No | return the report instead of an error when a filter was recognised but left the image unchanged. Set this for a filter that is deliberately conditional; leave it unset to treat a decline as the failure it usually is | |
| preview_region | No | attach part of the result at native resolution as x,y,w,h in result pixels, for checking text and fine detail that a scaled preview cannot show. Takes precedence over preview | |
| trim_tolerance | No | trim tolerance from 0 to 255 | |
| adaptive_fit_in | No | invert width and height when that yields better definition; requires fit_in | |
| max_age_seconds | No | add a max_age() filter limiting how long the response may be cached | |
| expire_unix_millis | No | add an expire() filter so the URL stops working after this unix-milliseconds timestamp |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | a request path ready to send to imagor, including its signature or unsafe prefix | |
| mode | Yes | how the path was produced: signed or unsafe | |
| note | No | human-readable notes about the result | |
| path | Yes | the imagor path, without any signature or unsafe prefix | |
| width | No | the result width the server reported, 0 when it reported none | |
| height | No | the result height the server reported, 0 when it reported none | |
| server | Yes | ||
| signed | Yes | whether the URL carries a signature | |
| status | Yes | the HTTP status the metadata request returned | |
| results | No | ||
| meta_url | No | the request path for the metadata that was read; its signature differs from the image URL because the signature covers the whole path | |
| verified | Yes | ||
| warnings | No | compositions that are valid but will not do what was intended | |
| absolute_url | No | the full URL to fetch, present only when IMAGOR_BASE_URL is configured | |
| meta_absolute_url | No | the full metadata URL that was fetched, present only when IMAGOR_BASE_URL is configured |