Auto Image Optimization - Default Output

Zesty.io automatically transforms images as the content-type "webp", which is a format made to optimized image download speed and rendering speed, developed by Google.

WebP is a modern image format that provides superior lossless and lossy compression for images on the web. Using WebP, webmasters and web developers can create smaller, richer images that make the web faster. - Read the full Google launch article https://developers.google.com/speed/webp​

When optimization happens, Zesty.io does a few things to the file:

• All metadata (for example, EXIF, XMP, or ICC) will is removed.

• Any ICC profile on the image is applied directly to the image to ensure color output is correct. If the image doesn't have an ICC profile, a default profile is added.

• If the source image contains orientation metadata, this orientation will be applied directly to the image data and metadata will be removed.

• Images are served with their original name and extension, but will still output as content-type "webp"

OTF DAM Quick Examples

<!-- using the direct media url, append query parameters to the url --> 
<img src="https://9skdl6.media.zestyio.com/Arcade-Space-Ship-Example.jpg?width=200" alt="space ship example">
<!-- using parsley, append query paramters outside th call -->
<img src="{{this.image.getImage()}}?width200&crop=1:1" alt="parsley example">
​
<!-- example using src set images to be used at different display pixel densities -->
<img srcset="{{this.image.getImage()}}?width=320&dpr=1.5 1.5x,
             {{this.image.getImage()}}?width=320&dpr=2 2x"
     src="{{this.image.getImage()}}?width=320"/>
     
<!-- HTML5 art direction, use different images based on browser width -->
<picture>
  <source srcset="{{this.image.getImage()}}?width=600&crop=16:9" media="(min-width: 600px)"/>
  <img src="{{this.image.getImage()}}?width=320&crop=1:1"/>
</picture>
​
<style>
  .header {
    background-image: url(https://9skdl6.media.zestyio.com/Arcade-Space-Ship-Example.jpg?width=2000)
  }
</style>

Bypass Image Optimization

To bypass image optimization to get the raw encoding and data of the origin image, append ?raw=true to the end of the image request like so:

https://9skdl6.media.zestyio.com/Arcade-Space-Ship-Example.jpg?raw=true

This is useful for fetching EXIF data or other meta data hidden in your image file.

Image Manipulation Options

All image may be manipulated on-the-fly by passing query parameter to the end of the image URL. See the example below

We recognize the following parameters in the query string of the image request:

Image Manipulation Processing order

Manipulation query parameters can be specified in any order, but they are processed in this order:

Zesty.io OTF DAM: On-The-Fly Image Options API

All query parameters listed below may be used in conjunction with one another, and may be stacked. Some query params conflict with each other, for example pad and canvas. This behavior is documented under each example API call.

https://9skdl6.media.zestyio.com/Arcade-Space-Ship-Example.jpg?format=pjpg&auto=webp

https://9skdl6.media.zestyio.com/parsley-logo-brackets.png?bg-color=006699

https://9skdl6.media.zestyio.com/Arcade-Space-Ship-Example.jpg?raw=true

https://9skdl6.media.zestyio.com/Arcade-Space-Ship-Example.jpg?blur=20

https://9skdl6.media.zestyio.com/Arcade-Space-Ship-Example.jpg?brightness=20

Canvas

Canvas is used for advanced targeted cropping of images.

The canvas image modifier query parameter takes multiple values which can get complicated, so we included example references as they are best to understand the behavior. To get a feel for it, experiment with the image url example provided, and play with the numbers.

The canvas query param takes comma separated values SIZE,POSITION, where SIZE is a pixel width and height 500,100or a ratio like 2:1. The POSITION is represented as a percentage offset from the center of the image using offset-x and offset-ylike offset-x50,offset-y95 . POSITION and SIZE together look like this:canvas=400,130,offset-x50,offset-y95. If POSITION is omitted, the image centers by default.

• The background color of the canvas will default to transparency for image output formats that support transparency and white for formats that don't. This behavior can be changed by adding the bg-color parameter.

• When using canvas and pad at the same time, pad will be ignored.

• Fractional pixel measurements are rounded to the nearest whole pixel.

​

https://9skdl6.media.zestyio.com/Arcade-Space-Ship-Example.jpg?contrast=100

https://9skdl6.media.zestyio.com/Arcade-Space-Ship-Example.jpg?crop=1:1&width=400

​

​

https://9skdl6.media.zestyio.com/Arcade-Space-Ship-Example.jpg?height=100

​

https://9skdl6.media.zestyio.com/Arcade-Space-Ship-Example.jpg?orient=l

​

​

​

https://9skdl6.media.zestyio.com/Arcade-Space-Ship-Example.jpg?sharpen=a5,r5,t4
​

​

https://9skdl6.media.zestyio.com/Arcade-Space-Ship-Example.jpg?width=800

About Zesty.io On-The-Fly Media Technology

Zesty.io leverages Fastly's Image Optimization technology layered on top of the Zesty.io DAM Media Manager. Features documented here relate to what is supported through Zesty.io WebEngine and Media services.