Image URLs
Brightspot uses an open-source Apache module (DIMS) which incorporates ImageMagick to perform image manipulations. Many of Brightspot鈥檚 native themes involve cropping and resizing, all of which go through DIMS.
See also:
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.
DIMS URL
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."
 Raw image (bowtie.jpg)
|
 Edited image (bowtie-small.jpg)
|
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鈥檚 syntax, see . |
|
| 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鈥檚 final size. |
Integers. For an explanation of this option鈥檚 syntax, see . |
|
| rotate |
Degrees by which image is rotated. |
Integer. |
Previous Topic
Retrieving image information
Next Topic
Troubleshooting images