<CldImage /> Examples
Basic Transformations
Cloudinary supports a wide variety of powerful transformations that allow you to not only deliver, but easily edit and build new images on the fly.
Background Removal
Remove Background
removeBackground
: Removes the background of the image using AI
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage width="960" height="600" src="images/turtle" sizes="100vw" alt="" removeBackground/>
Color Background
background
: Specifies a color to use as a background.
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage width="960" height="600" src="<Your Public ID>" sizes="100vw" alt="" removeBackground background="blueviolet"/>
Image Background
underlay
: Specifies a public ID to use as an underlaying image.
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage width="960" height="600" src="<Your Public ID>" sizes="100vw" alt="" removeBackground underlay="<Your Public ID>"/>
Cropping & Resizing
Cropping
crop
: Specifies the mode to use when cropping an image based on the given dimensions.
Note: By default, CldImage uses a gravity of auto, meaning the crop will automatically position the subject in the center of the resulting image.
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage width="300" height="300" src="<Your Public ID>" sizes="100vw" alt="" crop="fill"/>
Cloudinary additionally supports dynamic crop modes like thumb
that may provide a different result based on the given width and height. To help provide more options for controlling cropping images, you can specify and object or array of objects.
For instance, to crop the original source image, which will then later resize it to the initial width and height, you can use:
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage width="300" height="300" src="<Your Public ID>" sizes="100vw" alt="" crop={{ width: 600, height: 600, type: 'thumb', source: true, }}/>
Which will provide a consistent crop for all rendered sizes.
You can also use coordinates to crop to the exact location you need:
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage src="images/woman-headphones" width="300" height="300" alt="" sizes="100vw" crop={{ type: 'crop', width: 400, height: 400, x: 80, y: 350, gravity: 'north_east', source: true, }}/>
Extract
extract
: Extracts an area or multiple areas of an image, described in natural language.
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage src="samples/animals/three-dogs" width="960" height="600" crop="fill" alt="" sizes="100vw" extract={{ prompt: 'dogs', multiple: true, }}/>
Generative Fill
fillBackground
: Fills the background of an image using Generative AI
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage src="<Your Public ID>" width="960" height="600" alt="" sizes="100vw" crop="pad" fillBackground/>
Generative Recolor
recolor
: Recolors an object in an image using Generative AI
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage src="<Your Public ID>" width="960" height="600" crop="fill" alt="" sizes="100vw" recolor={['shoelaces', 'purple']}/>
Generative Remove
remove
: Removes an object in an image using Generative AI
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage src="<Your Public ID>" width="960" height="600" crop="fill" alt="" sizes="100vw" remove="<Your Prompt>"/>
Generative Replace
replace
: Replaces an object in an image using Generative AI
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage width="960" height="600" crop="fill" src="<Your Public ID>" alt="" sizes="100vw" replace={['turtle', 'shark']}/>
Generative Restore
restore
: Restores an image using Generative AI.
Before:
After:
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage src="<Your Public ID>" width="960" height="600" crop="fill" sizes="100vw" alt="" restore/>
Generative Replace Background
Uses generative AI to replace the background of your image. It can either generate a background for you based on context, or take in a prompt.
Contextual Replace
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage src="images/turtle" width="960" height="600" crop="fill" sizes="100vw" alt="" replaceBackground/>
Prompt
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage src="images/turtle" width="960" height="600" crop="fill" sizes="100vw" alt="" replaceBackground="fish tank"/>
You can also pass in a seed to the prompt:
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage src="images/turtle" width="960" height="600" crop="fill" sizes="100vw" alt="" replaceBackground={{ prompt: "fish tank", seed: 3 }}/>
Filters & Effects
Included in the Cloudinary transformations library are different filters and effects that allow you to recolor, improve, fix, and artistically transform your images.
Blur
blur
: Applies a blurring filter to an asset.
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage width="960" height="600" src="<Your Public ID>" sizes="100vw" alt="" blur="1200"/>
Grayscale
grayscale
: Converts an image to grayscale (multiple shades of gray).
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage width="960" height="600" src="<Your Public ID>" sizes="100vw" alt="" grayscale/>
Opacity
opacity
: Controls the opacity level of an image.
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage width="960" height="600" src="<Your Public ID>" sizes="100vw" alt="" opacity="50"/>
Pixelate
pixelate
: Applies a pixelation effect.
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage width="960" height="600" src="<Your Public ID>" sizes="100vw" alt="" pixelate/>
Tint
tint
: Blends an image with one or more tint colors.
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage width="960" height="600" src="<Your Public ID>" sizes="100vw" alt="" tint="equalize:80:blue:blueviolet"/>
Chaining Multiple Effects
effects
: An array of objects the configure the effects to apply to an image.
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage width="960" height="600" src="<Your Public ID>" alt="" effects={[ { background: 'green' }, { gradientFade: true }, { gradientFade: 'symetric,x_0.5' } ]}/>
More Filters & Effects
Learn about what other filters and effects are supported on CldImage Configuration.
Image Overlays
Image overlays allow you to place one or multiple images on top of another image.
Overlay Image by Public ID
overlays
: Any array of overlay objects
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage width="960" height="600" src="<Your Public ID>" sizes="100vw" alt="" overlays={[ { publicId: '<Your Public ID>', position: { x: 50, y: 50, gravity: 'north_west' }, effects: [ { crop: 'fill', gravity: 'auto', width: 500, height: 500 } ] } ]}/>
Overlay Image with Blend Mode
appliedEffects
: When configured on an overlay object, allows you to set an effect
that applies a blend mode, such as “multiply”
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage width="960" height="600" crop="fill" src="<Your Public ID>" alt="" overlays={[ { publicId: '<Your Public ID>', effects: [ { crop: 'fill', gravity: 'auto', width: '1.0', height: '1.0', } ], flags: ['relative'], appliedEffects: [ { multiply: true } ] } ]}/>
Image Underlays
Image underlays allow you to place one or multiple images behind a base image.
Replace Background with Image
underlay
: Public ID of image to use under base image
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage width="960" height="600" src="<Your Public ID>" sizes="100vw" alt="" removeBackground underlay="<Your Public ID>"/>
Replace Background with Multiple Images
underlays
: Array of underlay objects
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage width="960" height="600" src="<Your Public ID>" sizes="100vw" removeBackground alt="" underlays={[ { publicId: 'images/galaxy', width: '0.5', height: '1.0', crop: 'fill', position: { gravity: 'north_west' }, flags: ['relative'] }, { publicId: 'images/mountain', width: '0.5', height: '1.0', crop: 'fill', position: { gravity: 'south_east' }, flags: ['relative'] }, ]}/>
Text Overlays
Text overlays allow you to place text on top of an image.
Adding Text
text
: Adds text to an image with default settings
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage width="1335" height="891" src="<Your Public ID>" sizes="100vw" alt="" text="Cool Beans" blur="2000" brightness="300"/>
Adding Custom Text
overlays
: Uses overlay objects to add text on top of an image.
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage width="1335" height="891" src="<Your Public ID>" sizes="100vw" alt="" overlays={[ { width: 2670 - 20, crop: 'fit', position: { x: 140, y: 140, angle: -20, gravity: 'south_east' }, text: { color: 'blueviolet', fontFamily: 'Source Sans Pro', fontSize: 160, fontWeight: 'bold', textDecoration: 'underline', letterSpacing: 14, text: 'Cool Beans' } } ]}/>
Adding Text with Effects
effects
: Applies effects to the overlaid text.
<script> import { CldImage } from 'svelte-cloudinary';</script>
<CldImage width="1335" height="891" src="<Your Public ID>" sizes="100vw" alt="" overlays={[ { text: { color: 'white', fontFamily: 'Source Sans Pro', fontSize: 160, fontWeight: 'bold', text: 'Cool Beans' }, effects: [ { shear: '40:0', opacity: 50 } ] } ]}/>