- Dynamic Media Developer Resources Home
- Dynamic Media Image Serving and Image Rendering API Home
- About this release
- System requirements and prerequisites
- Disk space requirements and recommendations
- Restrictions and known issues
- Technical support
- Document conventions
- Installation
- Image Serving API
- Image Serving API
- Intended audience
- Image Serving components
- Configuration and administration
- Serving static (non-image) contents
- Troubleshooting
- HTTP protocol reference
- HTTP protocol reference overview
- HTTP protocol introduction
- Syntax and features
- Syntax and features
- Image Serving HTTP protocol basic syntax
- Image Serving HTTP protocol command
- Layering
- Layer effects
- Request nesting and embedding
- Substitution variables
- Command macros
- Image catalogs
- Object ID translation
- Text string localization
- SVG support
- Request preprocessing
- Image maps
- Image Serving color management
- Image Serving HTTP encoding
- Request locking
- Request obfuscation
- Watermarks
- Serving static (non-image) content
- Media set requests
- Text formatting
- Data types
- Command reference
- Command reference overview
- align
- anchor
- bfc
- bgc
- bgColor
- blendMode
- cache
- clipPath
- clipXPath
- color
- crop
- cropPathE
- defaultImage
- effect
- effectMask
- extend
- fit
- flip
- fmt
- hei
- hide
- icc
- iccEmbed
- id
- imageSet
- jpegSize
- layer
- locale
- map
- mask
- maskUse
- op_blur
- op_brightness
- op_colorbalance
- op_colorize
- op_contrast
- op_grow
- op_growMask
- op_growMaskR
- op_hue
- op_invert
- op_noise
- op_saturation
- op_sharpen
- op_usm
- op_usmR
- opac
- origin
- pathAttr
- pathEmbed
- perspective
- pos
- printRes
- pscan
- qlt
- quantize
- rect
- req
- res
- resMode
- rgn
- rotate
- scale
- scl
- size
- src
- template
- text
- textAngle
- textAttr
- textFlowPath
- textFlowXPath
- textPath
- textPs
- type
- wid
- xmpEmbed
- Response data
- Server behavior
- Templates
- FXG server protocol reference
- Image catalog reference
- Attributes
- Attributes reference
- AllowDirectAccess
- AllowDirectUrls
- ApplyEffectMask
- AudioBitRate
- Bfc
- BkgColor
- CacheValidationPolicy
- ClientAddressFilter
- CatalogFile
- DefaultExpiration
- DefaultExt
- DefaultFont
- DefaultImage
- DefaultImageMode
- DefaultLocale
- DefaultPix
- DefaultThumbPix
- DigimarcId
- DigimarcInfo
- ErrorImage
- ErrorDetail
- Expiration
- FontMapFile
- FullMatch
- HttpAppleStreamingContext
- HttpFlashStreamingContext
- IccBlackPointCompensation
- IccDither
- IccProfileCmyk
- IccProfileGray
- IccProfileMapFile
- IccProfileRgb
- IccProfileSrcCmyk
- IccProfileSrcGray
- IccProfileSrcRgb
- IccRenderIntent
- JpegQuality
- LocaleMap
- LocaleStrMap
- MacroFile
- MaxPix
- NonImgExpiration
- PublishInfo
- PrintResolution
- RequestLock
- RequestObfuscation
- ResMode
- Resolution
- RootId
- RootPath
- RootUrl
- RuleSetFile
- SavePath
- StaticContentCatalogFile
- StaticContentRootPath
- SvgCatalogFile
- SynthesizeFontStyles
- ThumbBkgColor
- ThumbHorizAlign
- ThumbRes
- ThumbType
- ThumbVertAlign
- TimeStamp
- TotalStreamBitRate
- TrustedDomains
- UseLastModified
- VideoBitRate
- VideoSize
- Watermark
- Image/SVG data reference
- Macro definition
- Font map
- ICC profile map reference
- Rule set reference
- Image server proxy
- Image Server examples
- Responsive Static Image Library
- Image Rendering API
- Image Rendering API
- Configuration
- Server administration
- Server administration
- Server administration preface
- Server administration overview
- Configuring and managing the server
- Configuration settings reference
- HTTP protocol reference
- HTTP protocol reference
- Introduction
- HTTP protocol syntax and features
- HTTP protocol syntax and features
- Image Rendering HTTP protocol basic syntax
- Image Rendering HTTP protocol command overview
- Vignettes
- Materials
- Advanced Render effects
- Request nesting and embedding
- Material catalogs
- Request pre-processing *
- Custom variables
- Command macros *
- Image Rendering color management *
- Color values
- Image Rendering HTTP encoding
- HTTP protocol command reference
- HTTP protocol response data
- Material catalog
- Material catalog
- Introduction
- Material catalog overview
- Attributes reference
- Attributes reference
- AllowDirectURLs
- CacheValidationPolicy
- CatalogFile
- ClientAddressFilter
- DefaultPix
- ErrorDetail
- ErrorImage
- Expiration
- Format
- IccBlackPointCompensation
- IccDither
- IccProfileCmyk
- IccProfileGray
- IccProfileMapFile
- IccProfileRgb
- IccProfileSrcCmyk
- IccProfileSrcGray
- IccProfileSrcRgb
- IccRenderIntent
- JpegQuality
- MacroFile
- MaxPix
- OnFailObj
- OnFailSel
- RenderSettings
- ResMode
- Resolution
- RootId
- RootPath *
- RootUrl *
- RuleSetFile
- Sharp
- Sharpen
- ShowOverlapObjs
- TiffEncoding
- TimeStamp
- TrustedDomains *
- UseLastModified
- VignetteMapFile
- Material data reference
- Vignette map reference
- Macro definition reference
- ICC profile map reference
- Rule set reference
- Utilities
color
Color Values. You can specify color values using either hexadecimal notation, a comma-separated list of component values, or decimals.
| color |
{{ gray[, alpha][g]}| { red, green, blue[ , rgbAlpha][r]}| { cyan, magenta, yellow, black[,alpha]k}| {0x{hex2|hex4}[g]}| {[0x]{ hex6| hex8}[r]}| {[0x]{ hex8| hex10}k}}[s] |
| red, green, blue, rgbAlpha |
color component value (0...255, decimal int) |
| cyan, magenta, yellow, black, alpha |
CMYK color component value (0..100 %, decimal int) |
| gray, alpha |
gray color component value (0…100%, decimal int) |
| hex2 |
packed two digit hex gray color value (GG) |
| hex4 |
packed four digit hex gray with alpha color value (GGAA) |
| hex6 |
packed six digit hexadecimal RGB color value (RRGGBB) |
| hex8 |
packed eight digit hexadecimal RGBA (RRGGBBAA) or CMYK (CCMMYYKK) color value (if specified with 'k' suffix) |
| hex10 |
packed ten digit hexadecimal CMYK with alpha value (CCYYMMKKAA) |
Decimal component values for RGB colors are in the range 0…255. Decimal component values for CMYK and gray are in the range 0…100%. All hexadecimal component values are in the range 0…0xFF.
Color component values are assumed to be independent of the alpha value (not pre-multiplied).
All color values, prefixes, and suffixes are not case sensitive.
The type suffix ‘k’ is required for CMYK color values. A type suffix can be optionally specified for RGB and gray color values.
The prefix ‘0x’ is required for hexadecimal gray color values.
The ‘s’ suffix specifies that the color value is associated with the input (source) color space corresponding to the pixel type of the color value (defined with attribute::IccProfileSrc*). If this suffix is not present, the color value is associated with the output (destination) color space (defined with icc= or attribute::IccProfile*).
Default
If an alpha value is not specified explicitly it is assumed to be 255, 0xFF, or 100% (fully opaque).
Examples
Some examples of valid color specifiers, and their corresponding pixel type, color value, alpha value, and default color space:
| color | Pixel Type | Color Value | Alpha Value | Default Color Space |
|---|---|---|---|---|
| 0,100,200 |
RGB |
0,100,200 |
255 |
IccProfileRgb |
| 0,100,200,200rs |
RGB |
0,100,200 |
200 |
IccProfileSrcRgb |
| 0x010203S |
RGB |
1,2,3 |
255 |
IccProfileSrcRgb |
| a0b1c2d3R |
RGB |
160,177,194 |
211 |
IccProfileRgb |
| 100S |
gray |
100% |
100% |
IccProfileSrcGray |
| 50,75g |
gray |
50% |
75% |
IccProfileGray |
| 0X70G |
gray |
44% |
44% |
IccProfileGray |
| 0xddeegs |
gray |
87% |
93% |
IccProfileSrcGray |
| 94,11,50,33k |
CMYK |
94-11-50-33% |
100% |
IccProfileCmyk |
| 22,23,24,25,26KS |
CMYK |
22-23-24-25% |
26% |
IccProfileSrcCmyk |
| 38393A3bK |
CMYK |
56-57-58-59% |
100% |
IccProfileCmyk |
| 0x0a0b0C0d0eks |
CMYK |
10-11-12-13% |
14% |
IccProfileSrcCmyk |
The output color space specified with icc= applies instead of the default color space when the pixel type of an output color corresponds to the pixel type of the output image.