Redactions are black rectangles that are overlaid onto source images in order to obscure parts of them. This can be used for copyright protection, privacy protection, or censorship, without altering any source images. Different redactions can be applied to the same image dynamically for different audiences based on client IP address, cookies, and more.
Redactions are defined with
height properties corresponding to source image coordinates. Redacted regions will be blacked out at every intersecting crop region and scale.
The redaction feature works via the delegate script. First, the delegate script must be enabled, and then,
redactions.enabled must be set to
true in the configuration file. The delegate script must implement a method called
Cantaloupe::redactions that returns an array of source image redaction coordinates in response to a particular request.
Not all processors support redaction; see the table of processor-supported features.