Optimizing Image Load

Whisk is utilizing CDN when it comes to serving images whether they are Whisk-internal or coming from third-party sources. That provides certain benefits:

Speed

By using distributed across world network, we make sure images are served from locations which are close to end-user
Because of images served from the single domain, a browser doesn't need to perform DNS-resolution for many different domains
Images are served over HTTP/2 protocol, which is super-optimal for loading multiple images at once (e.g. when displaying Recipe Feed)

Secure protocol

All images are served securely through HTTPS (HTTP/2-ready), that provides guarantees that the browser will not provide any warnings about insecure content

Improved UX

In addition to fast baseline speed, a client can choose which image size to load depending on its needs. For example, it is unnecessary to load a big recipe image if you only need to request a thumbnail.
By knowing image parameters in advance, a client application can prepare an optimal layout for displaying a content image.
It is possible to implement graceful image loading by first requesting a lower-quality image and showing it as soon as possible to the end-user. Then when a higher-res image is loaded, the previous image can be replaced.

To see how graceful image loading works in Whisk, it is best to see a demo:

Graceful image loading technique

Download temporary image: We show an image with the following transformation first:

<img alt class="ImageIsLoading" src="https://whisk-res.cloudinary.com/image/upload/c_fill,q_50,f_auto,e_blur:1000,w_200,h_200/v1523012419/recipe/58dd7f2ce37014c67e6550352839da9b.jpg">

where e_bluris a blur effect (range: 1 to 2000, Default: 500), q_50is image quality (range: 1 to 100), f_auto(optional) is the file extension of the requested delivery format for the resource.

Download full image: At the same time, we’re downloading full image. Once it has been downloaded we display it.

Image transformation

resize

Assuming that base image (960x1280) URL has a form of:

https://whisk-res.cloudinary.com/image/upload/v1523012419/recipe/58dd7f2ce37014c67e6550352839da9b.jpg

You can request alternative size (300x300) by modifying url to:

https://whisk-res.cloudinary.com/image/upload/w_300,h_300,c_fill/v1523012419/recipe/58dd7f2ce37014c67e6550352839da9b.jpg

crop

You can extract a region of the given width and height out of the original image. The original proportions are retained and so is the size of the graphics. You can specify the gravity parameter to select which part of the image to extract, or use fixed coordinates cropping.

For example, the jpg image cropped to a width of 300 pixels, a height of 300 pixels, with west gravity:

https://whisk-res.cloudinary.com/image/upload/w_300,h_350,c_crop,g_west/v1523012419/recipe/58dd7f2ce37014c67e6550352839da9b.jpg

fixed coordinates cropping

You can specify a region of the original image to crop by giving the x and y coordinates of the top left corner of the region together with the width and height of the region. You can also use percentage-based numbers instead of the exact coordinates for x, y, w, and h (e.g., 0.5 for 50%). Use this method when you know beforehand what the correct absolute cropping coordinates are, as in when your users manually select the region to crop out of the original image.

To manipulate the picture so that only little white cup is visible, the image is cropped to a 300x200 region starting at the coordinate x = 480 and y = 250:

https://whisk-res.cloudinary.com/image/upload/x_480,y_250,w_300,h_200,c_crop/v1523012419/recipe/58dd7f2ce37014c67e6550352839da9b.jpg

blur

To apply a strong blurring filter (300) to the sample image:

https://whisk-res.cloudinary.com/image/upload/e_blur:300,w_300,h_300,c_fill/v1523012419/recipe/58dd7f2ce37014c67e6550352839da9b.jpg

Set Device Pixel Ratio (DPR)

Different devices support different DPR values, which is defined as the ratio between physical pixels and logical pixels. This means that a device with support for a higher DPR uses more physical pixels for displaying an image, resulting in a clearer, sharper image.

Use the dprparameter to set the DPR value of the delivered image. The parameter accepts a numeric value specifying the DPR multiplier.

https://whisk-res.cloudinary.com/image/upload/dpr_2.0,w_150,h_150,c_fill/v1523012419/recipe/58dd7f2ce37014c67e6550352839da9b.jpg

tint

The tint: effect enables you to blend your images with one or more colors and specify the blend strength. By default, e_tint applies a red color at 60% blend strength.

Specify the colors and blend strength amount in the format:

e_tint:[amount]:[color1]:[color2]:...:[color10],

amount is a value from 0-100, where 0 keeps the original color and 100 blends the specified colors completely.

The color can be specified as an RGB hex triplet (e.g., rgb: 3e2222), a 3-digit RGB hex (e.g., rgb: 777) or a named color (e.g., green).

For example:

https://whisk-res.cloudinary.com/image/upload/e_tint:80:white,w_300,h_300,c_fill/v1523012419/recipe/58dd7f2ce37014c67e6550352839da9b.jpg

Data Structures

ImageContainer

ImageContainer is Whisk's common wrapper around the original image

ATTRIBUTE

TYPE

DESCRIPTION

url*

string

original image url, depricated. Please use field original instead

original

OriginalImage

original image information, e.g. image url

responsive*

ResponsiveImage

Example:

{
  "url": "https://www.bbcgoodfood.com/sites/default/files/styles/recipe/public/recipe_images/omelette-pancakes-with-tomato-pepper-sauce.jpg",
  "responsive": {
    "url": "https://whisk-res.cloudinary.com/image/upload/v1523012138/recipe/758058656142eaae402f1781e18c527c.jpg",
    "width": 500,
    "height": 454
  }
}