Cloudinary - Cookbook

Find recipes by tags:

Generate your photo collage online

Take your base image and use the overlay parameter (l in URLs) to add any further images. Set the required width and height (w and h in URLs) with the required crop mode, and add any further transformations, effects and texts.

Various images

Collage with text

Another collage

URL Ruby PHP Python Node.js Java JS jQuery React Angular .Net Android All

URL:

https://res.cloudinary.com/demo/image/upload/w_220,h_140,c_fill/l_brown_sheep,w_220,h_140,c_fill,x_220/l_horses,w_220,h_140,c_fill,y_140,x_-110/l_white_chicken,w_220,h_140,c_fill,y_70,x_110/l_butterfly.png,h_200,x_-10,a_10/w_400,h_260,c_crop,r_20/l_text:Parisienne_35_bold:Memories from our trip,co_rgb:990C47,y_155/e_shadow/yellow_tulip.jpg

Ruby:

cl_image_tag("yellow_tulip.jpg", :transformation=>[
  {:width=>220, :height=>140, :crop=>"fill"},
  {:overlay=>"brown_sheep", :width=>220, :height=>140, :x=>220, :crop=>"fill"},
  {:overlay=>"horses", :width=>220, :height=>140, :y=>140, :x=>-110, :crop=>"fill"},
  {:overlay=>"white_chicken", :width=>220, :height=>140, :y=>70, :x=>110, :crop=>"fill"},
  {:overlay=>"butterfly.png", :height=>200, :x=>-10, :angle=>10},
  {:width=>400, :height=>260, :radius=>20, :crop=>"crop"},
  {:overlay=>"text:Parisienne_35_bold:Memories%20from%20our%20trip", :color=>"#990C47", :y=>155},
  {:effect=>"shadow"}
  ])

PHP:

cl_image_tag("yellow_tulip.jpg", array("transformation"=>array(
  array("width"=>220, "height"=>140, "crop"=>"fill"),
  array("overlay"=>"brown_sheep", "width"=>220, "height"=>140, "x"=>220, "crop"=>"fill"),
  array("overlay"=>"horses", "width"=>220, "height"=>140, "y"=>140, "x"=>-110, "crop"=>"fill"),
  array("overlay"=>"white_chicken", "width"=>220, "height"=>140, "y"=>70, "x"=>110, "crop"=>"fill"),
  array("overlay"=>"butterfly.png", "height"=>200, "x"=>-10, "angle"=>10),
  array("width"=>400, "height"=>260, "radius"=>20, "crop"=>"crop"),
  array("overlay"=>"text:Parisienne_35_bold:Memories%20from%20our%20trip", "color"=>"#990C47", "y"=>155),
  array("effect"=>"shadow")
  )))

Python:

CloudinaryImage("yellow_tulip.jpg").image(transformation=[
  {"width": 220, "height": 140, "crop": "fill"},
  {"overlay": "brown_sheep", "width": 220, "height": 140, "x": 220, "crop": "fill"},
  {"overlay": "horses", "width": 220, "height": 140, "y": 140, "x": -110, "crop": "fill"},
  {"overlay": "white_chicken", "width": 220, "height": 140, "y": 70, "x": 110, "crop": "fill"},
  {"overlay": "butterfly.png", "height": 200, "x": -10, "angle": 10},
  {"width": 400, "height": 260, "radius": 20, "crop": "crop"},
  {"overlay": "text:Parisienne_35_bold:Memories%20from%20our%20trip", "color": "#990C47", "y": 155},
  {"effect": "shadow"}
  ])

Node.js:

cloudinary.image("yellow_tulip.jpg", {transformation: [
  {width: 220, height: 140, crop: "fill"},
  {overlay: "brown_sheep", width: 220, height: 140, x: 220, crop: "fill"},
  {overlay: "horses", width: 220, height: 140, y: 140, x: -110, crop: "fill"},
  {overlay: "white_chicken", width: 220, height: 140, y: 70, x: 110, crop: "fill"},
  {overlay: "butterfly.png", height: 200, x: -10, angle: 10},
  {width: 400, height: 260, radius: 20, crop: "crop"},
  {overlay: "text:Parisienne_35_bold:Memories%20from%20our%20trip", color: "#990C47", y: 155},
  {effect: "shadow"}
  ]})

Java:

cloudinary.url().transformation(new Transformation()
  .width(220).height(140).crop("fill").chain()
  .overlay("brown_sheep").width(220).height(140).x(220).crop("fill").chain()
  .overlay("horses").width(220).height(140).y(140).x(-110).crop("fill").chain()
  .overlay("white_chicken").width(220).height(140).y(70).x(110).crop("fill").chain()
  .overlay("butterfly.png").height(200).x(-10).angle(10).chain()
  .width(400).height(260).radius(20).crop("crop").chain()
  .overlay("text:Parisienne_35_bold:Memories%20from%20our%20trip").color("#990C47").y(155).chain()
  .effect("shadow")).imageTag("yellow_tulip.jpg")

JS:

cl.imageTag('yellow_tulip.jpg', {transformation: [
  {width: 220, height: 140, crop: "fill"},
  {overlay: "brown_sheep", width: 220, height: 140, x: 220, crop: "fill"},
  {overlay: "horses", width: 220, height: 140, y: 140, x: -110, crop: "fill"},
  {overlay: "white_chicken", width: 220, height: 140, y: 70, x: 110, crop: "fill"},
  {overlay: "butterfly.png", height: 200, x: -10, angle: 10},
  {width: 400, height: 260, radius: 20, crop: "crop"},
  {overlay: "text:Parisienne_35_bold:Memories%20from%20our%20trip", color: "#990C47", y: 155},
  {effect: "shadow"}
  ]}).toHtml();

jQuery:

$.cloudinary.image("yellow_tulip.jpg", {transformation: [
  {width: 220, height: 140, crop: "fill"},
  {overlay: "brown_sheep", width: 220, height: 140, x: 220, crop: "fill"},
  {overlay: "horses", width: 220, height: 140, y: 140, x: -110, crop: "fill"},
  {overlay: "white_chicken", width: 220, height: 140, y: 70, x: 110, crop: "fill"},
  {overlay: "butterfly.png", height: 200, x: -10, angle: 10},
  {width: 400, height: 260, radius: 20, crop: "crop"},
  {overlay: "text:Parisienne_35_bold:Memories%20from%20our%20trip", color: "#990C47", y: 155},
  {effect: "shadow"}
  ]})

React:

<Image publicId="yellow_tulip.jpg" >
  <Transformation width="220" height="140" crop="fill" />
  <Transformation overlay="brown_sheep" width="220" height="140" x="220" crop="fill" />
  <Transformation overlay="horses" width="220" height="140" y="140" x="-110" crop="fill" />
  <Transformation overlay="white_chicken" width="220" height="140" y="70" x="110" crop="fill" />
  <Transformation overlay="butterfly.png" height="200" x="-10" angle="10" />
  <Transformation width="400" height="260" radius="20" crop="crop" />
  <Transformation overlay="text:Parisienne_35_bold:Memories%20from%20our%20trip" color="#990C47" y="155" />
  <Transformation effect="shadow" />
</Image>

Angular:

<cl-image public-id="yellow_tulip.jpg" >
  <cl-transformation width="220" height="140" crop="fill">
  </cl-transformation>
  <cl-transformation overlay="brown_sheep" width="220" height="140" x="220" crop="fill">
  </cl-transformation>
  <cl-transformation overlay="horses" width="220" height="140" y="140" x="-110" crop="fill">
  </cl-transformation>
  <cl-transformation overlay="white_chicken" width="220" height="140" y="70" x="110" crop="fill">
  </cl-transformation>
  <cl-transformation overlay="butterfly.png" height="200" x="-10" angle="10">
  </cl-transformation>
  <cl-transformation width="400" height="260" radius="20" crop="crop">
  </cl-transformation>
  <cl-transformation overlay="text:Parisienne_35_bold:Memories%20from%20our%20trip" color="#990C47" y="155">
  </cl-transformation>
  <cl-transformation effect="shadow">
  </cl-transformation>
</cl-image>

.Net:

cloudinary.Api.UrlImgUp.Transform(new Transformation()
  .Width(220).Height(140).Crop("fill").Chain()
  .Overlay("brown_sheep").Width(220).Height(140).X(220).Crop("fill").Chain()
  .Overlay("horses").Width(220).Height(140).Y(140).X(-110).Crop("fill").Chain()
  .Overlay("white_chicken").Width(220).Height(140).Y(70).X(110).Crop("fill").Chain()
  .Overlay("butterfly.png").Height(200).X(-10).Angle(10).Chain()
  .Width(400).Height(260).Radius(20).Crop("crop").Chain()
  .Overlay("text:Parisienne_35_bold:Memories%20from%20our%20trip").Color("#990C47").Y(155).Chain()
  .Effect("shadow")).BuildImageTag("yellow_tulip.jpg")

Android:

MediaManager.get().url().transformation(new Transformation()
  .width(220).height(140).crop("fill").chain()
  .overlay("brown_sheep").width(220).height(140).x(220).crop("fill").chain()
  .overlay("horses").width(220).height(140).y(140).x(-110).crop("fill").chain()
  .overlay("white_chicken").width(220).height(140).y(70).x(110).crop("fill").chain()
  .overlay("butterfly.png").height(200).x(-10).angle(10).chain()
  .width(400).height(260).radius(20).crop("crop").chain()
  .overlay("text:Parisienne_35_bold:Memories%20from%20our%20trip").color("#990C47").y(155).chain()
  .effect("shadow")).generate("yellow_tulip.jpg")

by Itay Taragano Jun 11, 2014

Tags:

Applying rounded corners to an image

Transforming an image to a rounded version is simply done by using the radius parameter (r in URLs). It accepts the number of pixels of the radius of all four corners.

Original

Rounded corners

Facebook picture

URL Ruby PHP Python Node.js Java JS jQuery React Angular .Net Android All

URL:

https://res.cloudinary.com/demo/image/upload/r_50/front_face.jpg

Ruby:

cl_image_tag("front_face.jpg", :radius=>50)

PHP:

cl_image_tag("front_face.jpg", array("radius"=>50))

Python:

CloudinaryImage("front_face.jpg").image(radius=50)

Node.js:

cloudinary.image("front_face.jpg", {radius: 50})

Java:

cloudinary.url().transformation(new Transformation().radius(50)).imageTag("front_face.jpg")

JS:

cl.imageTag('front_face.jpg', {radius: 50}).toHtml();

jQuery:

$.cloudinary.image("front_face.jpg", {radius: 50})

React:

<Image publicId="front_face.jpg" >
  <Transformation radius="50" />
</Image>

Angular:

<cl-image public-id="front_face.jpg" >
  <cl-transformation radius="50">
  </cl-transformation>
</cl-image>

.Net:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Radius(50)).BuildImageTag("front_face.jpg")

Android:

MediaManager.get().url().transformation(new Transformation().radius(50)).generate("front_face.jpg")

by Itay Taragano Jun 11, 2014

Tags:

Manipulation

Text overlay positioning

Customize text overlay's position by setting the gravity (g in URLs) and the optional offset of the x and y. While the default text positioning ('gravity') is center, you can place your text in any other area of the image (tip: even outside the image's boundaries).

Default - center

South gravity

Custom position

URL Ruby PHP Python Node.js Java JS jQuery React Angular .Net Android All

URL:

https://res.cloudinary.com/demo/image/upload/l_text:Arial_45_bold:Hello World,g_north_west,x_20,y_20/face_center.jpg

Ruby:

cl_image_tag("face_center.jpg", :overlay=>"text:Arial_45_bold:Hello%20World", :gravity=>"north_west", :x=>20, :y=>20)

PHP:

cl_image_tag("face_center.jpg", array("overlay"=>"text:Arial_45_bold:Hello%20World", "gravity"=>"north_west", "x"=>20, "y"=>20))

Python:

CloudinaryImage("face_center.jpg").image(overlay="text:Arial_45_bold:Hello%20World", gravity="north_west", x=20, y=20)

Node.js:

cloudinary.image("face_center.jpg", {overlay: "text:Arial_45_bold:Hello%20World", gravity: "north_west", x: 20, y: 20})

Java:

cloudinary.url().transformation(new Transformation().overlay("text:Arial_45_bold:Hello%20World").gravity("north_west").x(20).y(20)).imageTag("face_center.jpg")

JS:

cl.imageTag('face_center.jpg', {overlay: "text:Arial_45_bold:Hello%20World", gravity: "north_west", x: 20, y: 20}).toHtml();

jQuery:

$.cloudinary.image("face_center.jpg", {overlay: "text:Arial_45_bold:Hello%20World", gravity: "north_west", x: 20, y: 20})

React:

<Image publicId="face_center.jpg" >
  <Transformation overlay="text:Arial_45_bold:Hello%20World" gravity="north_west" x="20" y="20" />
</Image>

Angular:

<cl-image public-id="face_center.jpg" >
  <cl-transformation overlay="text:Arial_45_bold:Hello%20World" gravity="north_west" x="20" y="20">
  </cl-transformation>
</cl-image>

.Net:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Overlay("text:Arial_45_bold:Hello%20World").Gravity("north_west").X(20).Y(20)).BuildImageTag("face_center.jpg")

Android:

MediaManager.get().url().transformation(new Transformation().overlay("text:Arial_45_bold:Hello%20World").gravity("north_west").x(20).y(20)).generate("face_center.jpg")

by Itay Taragano Jun 11, 2014

Tags:

Limiting an image by specified dimensions

Limit the size of the image by specifying the width and height (w and h in URLs) while setting the crop parameter to limit. This will create an image that does not exceed the given width and height. All original image parts remain visible and the aspect ratio of the original image is kept.

Original

70x70 Limited

1000x1000 Limited

URL Ruby PHP Python Node.js Java JS jQuery React Angular .Net Android All

URL:

https://res.cloudinary.com/demo/image/upload/w_70,h_70,c_limit/cashew_chicken.jpg

Ruby:

cl_image_tag("cashew_chicken.jpg", :width=>70, :height=>70, :crop=>"limit")

PHP:

cl_image_tag("cashew_chicken.jpg", array("width"=>70, "height"=>70, "crop"=>"limit"))

Python:

CloudinaryImage("cashew_chicken.jpg").image(width=70, height=70, crop="limit")

Node.js:

cloudinary.image("cashew_chicken.jpg", {width: 70, height: 70, crop: "limit"})

Java:

cloudinary.url().transformation(new Transformation().width(70).height(70).crop("limit")).imageTag("cashew_chicken.jpg")

JS:

cl.imageTag('cashew_chicken.jpg', {width: 70, height: 70, crop: "limit"}).toHtml();

jQuery:

$.cloudinary.image("cashew_chicken.jpg", {width: 70, height: 70, crop: "limit"})

React:

<Image publicId="cashew_chicken.jpg" >
  <Transformation width="70" height="70" crop="limit" />
</Image>

Angular:

<cl-image public-id="cashew_chicken.jpg" >
  <cl-transformation width="70" height="70" crop="limit">
  </cl-transformation>
</cl-image>

.Net:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Width(70).Height(70).Crop("limit")).BuildImageTag("cashew_chicken.jpg")

Android:

MediaManager.get().url().transformation(new Transformation().width(70).height(70).crop("limit")).generate("cashew_chicken.jpg")

by Itay Taragano Jun 11, 2014

Tags:

Face detection-based image cropping

Crop an image based on an automatically detected face or faces by specifying the width and height (w and h in URLs), setting the gravity parameter to face or faces (g_face or g_faces in URLs), then choose the crop mode most suitable to your requirements.

Original

Face detection

Faces detection

URL Ruby PHP Python Node.js Java JS jQuery React Angular .Net Android All

URL:

https://res.cloudinary.com/demo/image/upload/w_100,h_100,c_thumb,g_face/couple.jpg

Ruby:

cl_image_tag("couple.jpg", :width=>100, :height=>100, :gravity=>"face", :crop=>"thumb")

PHP:

cl_image_tag("couple.jpg", array("width"=>100, "height"=>100, "gravity"=>"face", "crop"=>"thumb"))

Python:

CloudinaryImage("couple.jpg").image(width=100, height=100, gravity="face", crop="thumb")

Node.js:

cloudinary.image("couple.jpg", {width: 100, height: 100, gravity: "face", crop: "thumb"})

Java:

cloudinary.url().transformation(new Transformation().width(100).height(100).gravity("face").crop("thumb")).imageTag("couple.jpg")

JS:

cl.imageTag('couple.jpg', {width: 100, height: 100, gravity: "face", crop: "thumb"}).toHtml();

jQuery:

$.cloudinary.image("couple.jpg", {width: 100, height: 100, gravity: "face", crop: "thumb"})

React:

<Image publicId="couple.jpg" >
  <Transformation width="100" height="100" gravity="face" crop="thumb" />
</Image>

Angular:

<cl-image public-id="couple.jpg" >
  <cl-transformation width="100" height="100" gravity="face" crop="thumb">
  </cl-transformation>
</cl-image>

.Net:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Width(100).Height(100).Gravity("face").Crop("thumb")).BuildImageTag("couple.jpg")

Android:

MediaManager.get().url().transformation(new Transformation().width(100).height(100).gravity("face").crop("thumb")).generate("couple.jpg")

by Itay Taragano Jun 11, 2014

Tags:

Crop pictures by custom coordinates

Crop your images by specifying the width and height parameters (w and h in URLs) while setting the crop parameter to crop (c_crop in URLs). This will extract only part of a given width & height out of the original image. The original proportions are retained and so is the size of the graphics.

Original

Center crop

By Coordinates

URL Ruby PHP Python Node.js Java JS jQuery React Angular .Net Android All

URL:

https://res.cloudinary.com/demo/image/upload/w_300,h_250,c_crop/kitten.jpg

Ruby:

cl_image_tag("kitten.jpg", :width=>300, :height=>250, :crop=>"crop")

PHP:

cl_image_tag("kitten.jpg", array("width"=>300, "height"=>250, "crop"=>"crop"))

Python:

CloudinaryImage("kitten.jpg").image(width=300, height=250, crop="crop")

Node.js:

cloudinary.image("kitten.jpg", {width: 300, height: 250, crop: "crop"})

Java:

cloudinary.url().transformation(new Transformation().width(300).height(250).crop("crop")).imageTag("kitten.jpg")

JS:

cl.imageTag('kitten.jpg', {width: 300, height: 250, crop: "crop"}).toHtml();

jQuery:

$.cloudinary.image("kitten.jpg", {width: 300, height: 250, crop: "crop"})

React:

<Image publicId="kitten.jpg" >
  <Transformation width="300" height="250" crop="crop" />
</Image>

Angular:

<cl-image public-id="kitten.jpg" >
  <cl-transformation width="300" height="250" crop="crop">
  </cl-transformation>
</cl-image>

.Net:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Width(300).Height(250).Crop("crop")).BuildImageTag("kitten.jpg")

Android:

MediaManager.get().url().transformation(new Transformation().width(300).height(250).crop("crop")).generate("kitten.jpg")

by Itay Taragano Jun 11, 2014

Tags:

Resizing an image to fill given dimensions

Resize your images to fill specified dimensions by setting the width and height (w and h in URLs), while setting the crop parameter to fill (c_fill in URLs). This will resize and crop the image so an image with the exact specified dimensions is generated. The fill crop mode keeps the original image's aspect ratio, therefore parts of the images may be cut-off.

Original

Fill 150x300

Fill 500x150

URL Ruby PHP Python Node.js Java JS jQuery React Angular .Net Android All

URL:

https://res.cloudinary.com/demo/image/upload/w_150,h_300,c_fill/boulder.jpg

Ruby:

cl_image_tag("boulder.jpg", :width=>150, :height=>300, :crop=>"fill")

PHP:

cl_image_tag("boulder.jpg", array("width"=>150, "height"=>300, "crop"=>"fill"))

Python:

CloudinaryImage("boulder.jpg").image(width=150, height=300, crop="fill")

Node.js:

cloudinary.image("boulder.jpg", {width: 150, height: 300, crop: "fill"})

Java:

cloudinary.url().transformation(new Transformation().width(150).height(300).crop("fill")).imageTag("boulder.jpg")

JS:

cl.imageTag('boulder.jpg', {width: 150, height: 300, crop: "fill"}).toHtml();

jQuery:

$.cloudinary.image("boulder.jpg", {width: 150, height: 300, crop: "fill"})

React:

<Image publicId="boulder.jpg" >
  <Transformation width="150" height="300" crop="fill" />
</Image>

Angular:

<cl-image public-id="boulder.jpg" >
  <cl-transformation width="150" height="300" crop="fill">
  </cl-transformation>
</cl-image>

.Net:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Width(150).Height(300).Crop("fill")).BuildImageTag("boulder.jpg")

Android:

MediaManager.get().url().transformation(new Transformation().width(150).height(300).crop("fill")).generate("boulder.jpg")

by Itay Taragano Jun 11, 2014

Tags:

Fitting an image within specified dimensions

To change the image size to fit in given width and height while retaining original proportions, specify the width and height parameters (w and h in URLs) while setting the crop parameter to fit (c_fit in URLs).

Original

Fit 70x90

300x100 fit

URL Ruby PHP Python Node.js Java JS jQuery React Angular .Net Android All

URL:

https://res.cloudinary.com/demo/image/upload/w_70,h_90,c_fit/flower.jpg

Ruby:

cl_image_tag("flower.jpg", :width=>70, :height=>90, :crop=>"fit")

PHP:

cl_image_tag("flower.jpg", array("width"=>70, "height"=>90, "crop"=>"fit"))

Python:

CloudinaryImage("flower.jpg").image(width=70, height=90, crop="fit")

Node.js:

cloudinary.image("flower.jpg", {width: 70, height: 90, crop: "fit"})

Java:

cloudinary.url().transformation(new Transformation().width(70).height(90).crop("fit")).imageTag("flower.jpg")

JS:

cl.imageTag('flower.jpg', {width: 70, height: 90, crop: "fit"}).toHtml();

jQuery:

$.cloudinary.image("flower.jpg", {width: 70, height: 90, crop: "fit"})

React:

<Image publicId="flower.jpg" >
  <Transformation width="70" height="90" crop="fit" />
</Image>

Angular:

<cl-image public-id="flower.jpg" >
  <cl-transformation width="70" height="90" crop="fit">
  </cl-transformation>
</cl-image>

.Net:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Width(70).Height(90).Crop("fit")).BuildImageTag("flower.jpg")

Android:

MediaManager.get().url().transformation(new Transformation().width(70).height(90).crop("fit")).generate("flower.jpg")

by Itay Taragano Jun 11, 2014

Tags:

Resize an image

Resize your images by setting the width and/or height parameters (w and h in URLs). When resizing using Cloudinary's URL-based transformations, Cloudinary will automatically apply the scale crop mode. Alternatively, you can use any one of our many supported crop modes.

Original

Scaled

Stretched

URL Ruby PHP Python Node.js Java JS jQuery React Angular .Net Android All

URL:

https://res.cloudinary.com/demo/image/upload/w_70,h_53,c_scale/turtles.jpg

Ruby:

cl_image_tag("turtles.jpg", :width=>70, :height=>53, :crop=>"scale")

PHP:

cl_image_tag("turtles.jpg", array("width"=>70, "height"=>53, "crop"=>"scale"))

Python:

CloudinaryImage("turtles.jpg").image(width=70, height=53, crop="scale")

Node.js:

cloudinary.image("turtles.jpg", {width: 70, height: 53, crop: "scale"})

Java:

cloudinary.url().transformation(new Transformation().width(70).height(53).crop("scale")).imageTag("turtles.jpg")

JS:

cl.imageTag('turtles.jpg', {width: 70, height: 53, crop: "scale"}).toHtml();

jQuery:

$.cloudinary.image("turtles.jpg", {width: 70, height: 53, crop: "scale"})

React:

<Image publicId="turtles.jpg" >
  <Transformation width="70" height="53" crop="scale" />
</Image>

Angular:

<cl-image public-id="turtles.jpg" >
  <cl-transformation width="70" height="53" crop="scale">
  </cl-transformation>
</cl-image>

.Net:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Width(70).Height(53).Crop("scale")).BuildImageTag("turtles.jpg")

Android:

MediaManager.get().url().transformation(new Transformation().width(70).height(53).crop("scale")).generate("turtles.jpg")

by Itay Taragano Jun 11, 2014

Tags:

Convert PDF to JPG

Convert your PDF files to a JPG thumbnail by simply switching the extension of the file to JPG. You can also specify the target thumbnail dimensions using the width and height parameters and any available crop mode. If your PDF file has multiple pages, you can specify the specific page to convert using the page parameter (pg in URLs). For example: Multi-page

PDF thumbnail

With overlays

Multi-page

URL Ruby PHP Python Node.js Java JS jQuery React Angular .Net Android All

URL:

https://res.cloudinary.com/demo/image/upload/w_200,h_250,c_fill,pg_2/multi_page_pdf.jpg

Ruby:

cl_image_tag("multi_page_pdf.jpg", :width=>200, :height=>250, :page=>2, :crop=>"fill")

PHP:

cl_image_tag("multi_page_pdf.jpg", array("width"=>200, "height"=>250, "page"=>2, "crop"=>"fill"))

Python:

CloudinaryImage("multi_page_pdf.jpg").image(width=200, height=250, page=2, crop="fill")

Node.js:

cloudinary.image("multi_page_pdf.jpg", {width: 200, height: 250, page: 2, crop: "fill"})

Java:

cloudinary.url().transformation(new Transformation().width(200).height(250).page(2).crop("fill")).imageTag("multi_page_pdf.jpg")

JS:

cl.imageTag('multi_page_pdf.jpg', {width: 200, height: 250, page: 2, crop: "fill"}).toHtml();

jQuery:

$.cloudinary.image("multi_page_pdf.jpg", {width: 200, height: 250, page: 2, crop: "fill"})

React:

<Image publicId="multi_page_pdf.jpg" >
  <Transformation width="200" height="250" page="2" crop="fill" />
</Image>

Angular:

<cl-image public-id="multi_page_pdf.jpg" >
  <cl-transformation width="200" height="250" page="2" crop="fill">
  </cl-transformation>
</cl-image>

.Net:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Width(200).Height(250).Page(2).Crop("fill")).BuildImageTag("multi_page_pdf.jpg")

Android:

MediaManager.get().url().transformation(new Transformation().width(200).height(250).page(2).crop("fill")).generate("multi_page_pdf.jpg")

by Itay Taragano Jun 11, 2014

Tags:

Add a shadow effect to an image

Add a shadow effect to any image just by setting the effect parameter to shadow (e_shadow in URLs). You can customize the x and y offsets of the shadow and the blurring level. The shadow's color can be also changed by setting the color parameter (co in URLs).

Original

Custom shadow

Colored shadow

URL Ruby PHP Python Node.js Java JS jQuery React Angular .Net Android All

URL:

https://res.cloudinary.com/demo/image/upload/e_shadow:90,x_15,y_15,co_brown/cloudinary_icon.png

Ruby:

cl_image_tag("cloudinary_icon.png", :effect=>"shadow:90", :x=>15, :y=>15, :color=>"brown")

PHP:

cl_image_tag("cloudinary_icon.png", array("effect"=>"shadow:90", "x"=>15, "y"=>15, "color"=>"brown"))

Python:

CloudinaryImage("cloudinary_icon.png").image(effect="shadow:90", x=15, y=15, color="brown")

Node.js:

cloudinary.image("cloudinary_icon.png", {effect: "shadow:90", x: 15, y: 15, color: "brown"})

Java:

cloudinary.url().transformation(new Transformation().effect("shadow:90").x(15).y(15).color("brown")).imageTag("cloudinary_icon.png")

JS:

cl.imageTag('cloudinary_icon.png', {effect: "shadow:90", x: 15, y: 15, color: "brown"}).toHtml();

jQuery:

$.cloudinary.image("cloudinary_icon.png", {effect: "shadow:90", x: 15, y: 15, color: "brown"})

React:

<Image publicId="cloudinary_icon.png" >
  <Transformation effect="shadow:90" x="15" y="15" color="brown" />
</Image>

Angular:

<cl-image public-id="cloudinary_icon.png" >
  <cl-transformation effect="shadow:90" x="15" y="15" color="brown">
  </cl-transformation>
</cl-image>

.Net:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Effect("shadow:90").X(15).Y(15).Color("brown")).BuildImageTag("cloudinary_icon.png")

Android:

MediaManager.get().url().transformation(new Transformation().effect("shadow:90").x(15).y(15).color("brown")).generate("cloudinary_icon.png")

by Itay Taragano Jun 24, 2014

Tags:

Automatically improve photos

Automatically improve the visual quality of your images using Cloudinary. Image improving is done by setting the effect parameter to improve (e_improve in URLs). All images and thumbnails of your website would seamlessly look much clearer and vivid.

Original

Improved

Improved, cropped

URL Ruby PHP Python Node.js Java JS jQuery React Angular .Net Android All

URL:

https://res.cloudinary.com/demo/image/upload/e_improve/gray_mountain.jpg

Ruby:

cl_image_tag("gray_mountain.jpg", :effect=>"improve")

PHP:

cl_image_tag("gray_mountain.jpg", array("effect"=>"improve"))

Python:

CloudinaryImage("gray_mountain.jpg").image(effect="improve")

Node.js:

cloudinary.image("gray_mountain.jpg", {effect: "improve"})

Java:

cloudinary.url().transformation(new Transformation().effect("improve")).imageTag("gray_mountain.jpg")

JS:

cl.imageTag('gray_mountain.jpg', {effect: "improve"}).toHtml();

jQuery:

$.cloudinary.image("gray_mountain.jpg", {effect: "improve"})

React:

<Image publicId="gray_mountain.jpg" >
  <Transformation effect="improve" />
</Image>

Angular:

<cl-image public-id="gray_mountain.jpg" >
  <cl-transformation effect="improve">
  </cl-transformation>
</cl-image>

.Net:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Effect("improve")).BuildImageTag("gray_mountain.jpg")

Android:

MediaManager.get().url().transformation(new Transformation().effect("improve")).generate("gray_mountain.jpg")

by Itay Taragano Jun 24, 2014

Tags:

Adjust image brightness

Dynamically adjust the brightness of an image. Either manually set the brightness level, or tell Cloudinary to automatically balance the brightness level. Brightness level change can be manually applied by setting the effect parameter to brightness (e_brightness in URLs), or by using the auto_brightness effect for automatic brightness adjustment.

Original

30% brighter

50% darker

URL Ruby PHP Python Node.js Java JS jQuery React Angular .Net Android All

URL:

https://res.cloudinary.com/demo/image/upload/e_brightness:30/mountain.jpg

Ruby:

cl_image_tag("mountain.jpg", :effect=>"brightness:30")

PHP:

cl_image_tag("mountain.jpg", array("effect"=>"brightness:30"))

Python:

CloudinaryImage("mountain.jpg").image(effect="brightness:30")

Node.js:

cloudinary.image("mountain.jpg", {effect: "brightness:30"})

Java:

cloudinary.url().transformation(new Transformation().effect("brightness:30")).imageTag("mountain.jpg")

JS:

cl.imageTag('mountain.jpg', {effect: "brightness:30"}).toHtml();

jQuery:

$.cloudinary.image("mountain.jpg", {effect: "brightness:30"})

React:

<Image publicId="mountain.jpg" >
  <Transformation effect="brightness:30" />
</Image>

Angular:

<cl-image public-id="mountain.jpg" >
  <cl-transformation effect="brightness:30">
  </cl-transformation>
</cl-image>

.Net:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Effect("brightness:30")).BuildImageTag("mountain.jpg")

Android:

MediaManager.get().url().transformation(new Transformation().effect("brightness:30")).generate("mountain.jpg")

by Itay Taragano Jun 24, 2014

Tags:

Customize color saturation

Saturation level of images can be easily increased or decreased on-the-fly. This can be done by setting the effect parameter to saturation (e_saturation in URLs). Saturation levels can be customized by specifying the saturation percentage, either positive or negative.

Original

+60% Saturation

-60% Saturation

URL Ruby PHP Python Node.js Java JS jQuery React Angular .Net Android All

URL:

https://res.cloudinary.com/demo/image/upload/e_saturation:60/vegetable_soup.jpg

Ruby:

cl_image_tag("vegetable_soup.jpg", :effect=>"saturation:60")

PHP:

cl_image_tag("vegetable_soup.jpg", array("effect"=>"saturation:60"))

Python:

CloudinaryImage("vegetable_soup.jpg").image(effect="saturation:60")

Node.js:

cloudinary.image("vegetable_soup.jpg", {effect: "saturation:60"})

Java:

cloudinary.url().transformation(new Transformation().effect("saturation:60")).imageTag("vegetable_soup.jpg")

JS:

cl.imageTag('vegetable_soup.jpg', {effect: "saturation:60"}).toHtml();

jQuery:

$.cloudinary.image("vegetable_soup.jpg", {effect: "saturation:60"})

React:

<Image publicId="vegetable_soup.jpg" >
  <Transformation effect="saturation:60" />
</Image>

Angular:

<cl-image public-id="vegetable_soup.jpg" >
  <cl-transformation effect="saturation:60">
  </cl-transformation>
</cl-image>

.Net:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Effect("saturation:60")).BuildImageTag("vegetable_soup.jpg")

Android:

MediaManager.get().url().transformation(new Transformation().effect("saturation:60")).generate("vegetable_soup.jpg")

by Itay Taragano Jun 24, 2014

Tags:

Sharpen an image

Use Cloudinary to sharpen your images easily and dynamically. Image sharpening can be applied by setting the effect parameter to sharpen (e_sharpen in URLs). A custom sharpen level can be set in order to get the exact effect you need.

Original

Sharpened

Sharpened more

URL Ruby PHP Python Node.js Java JS jQuery React Angular .Net Android All

URL:

https://res.cloudinary.com/demo/image/upload/e_sharpen/front_face.jpg

Ruby:

cl_image_tag("front_face.jpg", :effect=>"sharpen")

PHP:

cl_image_tag("front_face.jpg", array("effect"=>"sharpen"))

Python:

CloudinaryImage("front_face.jpg").image(effect="sharpen")

Node.js:

cloudinary.image("front_face.jpg", {effect: "sharpen"})

Java:

cloudinary.url().transformation(new Transformation().effect("sharpen")).imageTag("front_face.jpg")

JS:

cl.imageTag('front_face.jpg', {effect: "sharpen"}).toHtml();

jQuery:

$.cloudinary.image("front_face.jpg", {effect: "sharpen"})

React:

<Image publicId="front_face.jpg" >
  <Transformation effect="sharpen" />
</Image>

Angular:

<cl-image public-id="front_face.jpg" >
  <cl-transformation effect="sharpen">
  </cl-transformation>
</cl-image>

.Net:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Effect("sharpen")).BuildImageTag("front_face.jpg")

Android:

MediaManager.get().url().transformation(new Transformation().effect("sharpen")).generate("front_face.jpg")

by Itay Taragano Jun 24, 2014

Tags:

Add a text to an image

Add dynamic text on top of any image, on-the-fly. You can use any one of the hundreds of fonts available by Google Fonts, or even use your own custom font. Embed the text by setting the overlay parameter (l in URLs) to text<text_params>.

Dynamic style

Colored text

Pre-defined style

URL Ruby PHP Python Node.js Java JS jQuery React Angular .Net Android All

URL:

https://res.cloudinary.com/demo/image/upload/l_text:Arial_24_bold:Dynamic style/site_bg_bright_small.jpg

Ruby:

cl_image_tag("site_bg_bright_small.jpg", :overlay=>"text:Arial_24_bold:Dynamic%20style")

PHP:

cl_image_tag("site_bg_bright_small.jpg", array("overlay"=>"text:Arial_24_bold:Dynamic%20style"))

Python:

CloudinaryImage("site_bg_bright_small.jpg").image(overlay="text:Arial_24_bold:Dynamic%20style")

Node.js:

cloudinary.image("site_bg_bright_small.jpg", {overlay: "text:Arial_24_bold:Dynamic%20style"})

Java:

cloudinary.url().transformation(new Transformation().overlay("text:Arial_24_bold:Dynamic%20style")).imageTag("site_bg_bright_small.jpg")

JS:

cl.imageTag('site_bg_bright_small.jpg', {overlay: "text:Arial_24_bold:Dynamic%20style"}).toHtml();

jQuery:

$.cloudinary.image("site_bg_bright_small.jpg", {overlay: "text:Arial_24_bold:Dynamic%20style"})

React:

<Image publicId="site_bg_bright_small.jpg" >
  <Transformation overlay="text:Arial_24_bold:Dynamic%20style" />
</Image>

Angular:

<cl-image public-id="site_bg_bright_small.jpg" >
  <cl-transformation overlay="text:Arial_24_bold:Dynamic%20style">
  </cl-transformation>
</cl-image>

.Net:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Overlay("text:Arial_24_bold:Dynamic%20style")).BuildImageTag("site_bg_bright_small.jpg")

Android:

MediaManager.get().url().transformation(new Transformation().overlay("text:Arial_24_bold:Dynamic%20style")).generate("site_bg_bright_small.jpg")

by Itay Taragano Jun 15, 2014

Tags:

Cloudinary Cookbook