Documentation Center

Known issues in Contextual Image Delivery

Issues known to exist in CID at the time of release.

Contextual Image Delivery cannot process transparent grayscale images in PNG format

To work around this problem, convert your transparent grayscale PNG image to a transparent color PNG image.

API call to obtain cache hit ratio sometimes returns a cache hit ratio of "NaN" (Not a Number)
In some cases, the following calls may return the value NaN (not a number):
  • In .NET: ContextualImageDeliveryAdministrator.Instance.Statistics.CacheHitRatio
  • In Java: contextualImageDeliveryAdministrator.getStatistics().getCacheHitRatio()
Aliases referring to images with reserved characters must be doubly escaped in the image transformation URL
For example, let's say that you configured the following image location alias in cwd_engine_conf.xml:
<sources>
  <urls>
    <local>file:///C:/workspaces/images</local>
  </urls>
</sources>
If you would now want to refer to an image in that location called WeGive100%.jpg (on the file system), create a transformation URL that looks as follows:
http://localhost/cidparth/fit/100/source/local/WeGive100%2525.jpg

The final part of the URL is processed twice: first, the string %25 is recognized as an escape string for %, resulting in WeGive100%25.jpg; next, the %25 in this filename is again processed, resulting in the original filename WeGive100%.jpg

To work around this problem, avoid having image files in your alias locations that contain any of the URL reserved characters :
  • Any whitespace character
  • Any of the following characters: : / ? # [ ] @ $ & ' * + , ; = % { }