·¬ÇÑÉçÇø

Brightspot CMS Developer Guide

Image URLs


Brightspot uses an open-source Apache module (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:


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 DIMS URL
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.jpg

The following examples show the effect of the URL in illustration "DIMS URL."

Raw image (bowtie.jpg) Raw image (bowtie.jpg)
Raw image (bowtie.jpg)

Edited image (bowtie-small.jpg) Edited image (bowtie-small.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’s syntax, see .
filter

Filter to use when resizing an image.
  • Grayscale
  • Invert
  • Sepia
format

Graphic format into which raw image is converted.
  • jpg
  • png
  • gif
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 .
rotate

Degrees by which image is rotated.
Integer.
Previous Topic
Retrieving image information
Next Topic
Troubleshooting images
Was this topic helpful?
Thanks for your feedback.
Our robust, flexible Design System provides hundreds of pre-built components you can use to build the presentation layer of your dreams.

•
•
•
Brightspot is packaged with content types that get you up and running in a matter of days, including assets, modules and landing pages.

• Content types
• Modules
• Landing pages
Everything you need to know when creating, managing, and administering content within Brightspot CMS.

• Dashboards
• Publishing
• Workflows
• Admin configurations
A guide for installing, supporting, extending, modifying and administering code on the Brightspot platform.

• Field types
• Content modeling
• Rich-text elements
• Images
A guide to configuring Brightspot's library of integrations, including pre-built options and developer-configured extensions.

• Google Analytics
• Shopify
• Apple News