Image URLs
Brightspot uses an open-source Apache module Dynamic Image Manipulation Service (DIMS) which incorporates ImageMagick to perform image manipulations. Many of Brightspot’s native themes involve cropping and resizing, all of which go through DIMS.
See also:
- Image format
- Configuring StorageItem
- Webservice API
- ImageMagick Command-Line Options
You can perform customized image editing through DIMS by constructing a URL that has two components: ImageMagick commands and the URL of the raw image stored in Brightspot.
The following table describes the components of a DIMS URL.
Component | Description |
|---|---|
A | Image editing service to use. |
B | ID of DIMS configuration to use. For information about configuring DIMS, see Configuring a DIMS image editor . |
C | Signature generated by Brightspot. |
D | Epoch time stamp when URL expires. |
E | Editing options. |
F | Encoded URL of image stored in Brightspot. |
The URL in the illustration “DIMS URL” is equivalent to the following ImageMagick command:
convert bowtie.jpg -strip -crop 90x58+156+104 -resize 85x55 bowtie-small.jpgThe following examples show the effect of the URL in illustration “DIMS URL.”
The following table lists the editing options you can submit to DIMS.
Option | ImageMagick Equivalent | Description | Valid Values |
|---|---|---|---|
brightness | Image appears lighter. | [−100,+100] | |
contrast | Enhances difference between lighter and darker elements of an image. | [−100,+100] | |
crop | Eliminates area of an image outside of the crop area. Optional offset is available. | Integers. For an explanation of this option’s syntax, see Image Geometry . | |
filter | Filter to use when resizing an image. |
| |
format | Graphic format into which raw image is converted. |
| |
quality | Quality degradation allowed as result of compressing the image. | [1,100] | |
resize | Image’s final size. | Integers. For an explanation of this option’s syntax, see Image Geometry . | |
rotate | Degrees by which image is rotated. | Integer. |