Visual Experience Platform
Help CenterRelease NotesBlogWebsite
  • VXP - Visual Experience Platform
    • The VXP
      • Token
    • Settings
      • My Account
        • Profile
        • Support
      • Organisation
        • General Organisation Settings
        • Billing
          • Payment
          • Invoices
          • Plan
        • Users
          • Users
          • Roles
        • Teams
      • Project
        • Branding
        • Subscription
        • Analytics
          • Standard Dashboards
            • Multi tenants
            • User Dashboard
            • DAM Storage
            • Workflows Monitoring
            • Traffic Origin
            • Caching (Volumetry)
            • CDN performance
          • Custom Dashboard
        • Access
          • API keys
          • Security templates
          • OAuth2
  • Digital Asset Management (DAM)
    • Library
      • Assets
        • Asset Details window
          • Asset actions
            • Regional settings
            • Context menu ("..." button)
            • Add to My favorites (heart icon)
            • Edit media (image, video, etc)
              • Edit image
              • Edit video (coming soon)
              • Edit design template (coming soon)
            • Share
          • Asset information tabs
            • General
            • Metadata
            • Variations
            • Comments
            • Approvals
            • History
      • Folders
      • Collections
      • Labels
      • Products
      • My favorites
      • Help
      • Sharebox
      • Airbox
      • Search and Filters
        • Faceted Search
    • Plugins & Connectors
      • Plugins
        • Adobe Creative Cloud
        • Adobe Commerce (Magento)
        • Canva
        • Contentful
        • Contentstack
        • Directus
        • Drupal
        • Opencart
          • Opencart (v4)
        • Prestashop
        • Shopware
        • Storyblok
        • Strapi (v4)
        • Sylius
        • Uniform CMS
        • Wordpress
      • Connectors
        • Akeneo PIM App
        • Canva App
        • CI-Hub
        • Commercetools FaaS App
        • Hygraph app
        • Kontent.ai
        • OneTeg
        • Pabbly Connect
        • Prismic
        • Shopify / Shopify plus app
        • Zapier automation
    • Settings
      • Library
        • Featured components
        • Interface customization
      • Metadata
        • Metadata Configuration
        • Assets
      • Tags
        • Configuration
        • Dictionary
      • Notifications
      • Automations
        • Post processing
        • Webhooks
        • Workflows
      • Storage
        • Providers
        • Upload
        • Video
        • Listing
        • Download
        • Custom routing
  • Visual AI
    • Welcome
    • Visual AI
      • Images
        • Classification models
          • Auto-tagging
          • Brand detect
          • Dominant color extraction
          • Faces
            • Face analysis
            • Face clustering
          • Image quality
          • OCR
          • Number Plate recognition
          • Product type
          • Property classification
          • Scene Classification
          • Sport Classification
        • Generative AI models
          • Image-to-text
          • Plate blurring
          • Quality improvement (remove artifacts)
          • Remove background
          • Text-to-Image
        • Moderation models
          • Face count
          • NSFW - Not Safe For Work
          • Real estate authenticity
          • Watermark detection
      • Videos
        • Face detection
      • Search & find assets
        • Text Search
        • Similar Assets
  • Portals
    • Welcome
    • Creating a Portal
    • Editing a Portal
      • Pages
      • Sections
      • Design
      • Fonts
    • Managing a Portal
      • Settings
      • Access
      • Users
      • Labeling, Cloning, Archiving
    • Publishing a Portal
  • Dynamic Media Optimization (DMO)
    • Welcome
      • Responsive libraries
      • Native plugins
      • 360° view builder
      • Service status
    • Insights
      • Delivery
      • Optimization
      • Alerts
      • Logs
    • Transformations
      • Image optimization
        • Operations
          • Width and height
          • Prevent enlargement
          • Crop
            • Automatic Gravity Crop
            • Positionable Crop
            • Focal point Crop
            • Face Crop
            • Face hide
            • Aspect ratio crop
          • Fit
          • Cropfit
          • Bound
          • Boundmin
          • Cover
          • Device pixel ratio
          • Flip
          • Rotate
          • Trim
          • Rounded corners
        • Filters
          • Adjustment
            • Brightness
            • Contrast
            • Saturate
          • Color manipulation
            • Color overlay
            • Grayscale
            • Duotone
          • Blur
          • Pixelate
          • Sharpen
        • Watermarking
          • Static watermark
          • Dynamic watermark
          • Text watermark
        • Image compression
          • Image formats
          • Optipress
      • Video optimization
        • Video API
          • Editing
            • Chapters
            • Combine
            • Trim
          • Optimizing
            • Convert
            • Compress
            • Transcode
        • On-the-fly-video optimization
      • Static content optimization
        • PDF to image
        • JS/CSS optimization
    • Invalidation
    • Settings
      • Asset Origin
        • AWS S3 or any other S3-compatible storage provider
        • Google Cloud storage (GCP)
        • Azure Blob storage
        • Own HTTP-based Storage
      • Images
        • Compression
        • Optimization
        • Watermark
      • Static content
      • Delivery
        • CNAME
        • URL format
        • Rules
        • Security
        • Caching
        • Default behaviors
  • Developers / Headless
    • Headless DAM
      • DAM APIs
        • API Authentication
        • API Reference
      • Command Line Interface (CLI)
      • Media Asset Widget(MAW)
        • Overview
        • Developer reference
        • V2 End-of-life
Powered by GitBook
LogoLogo

Quick links

  • Go to website
  • Legal Center

©2024 Scaleflex SAS

On this page
  • Available operations
  • Resize functions
  • Crop
  • Fit
  • Cropfit
  • Bound
  • Cover
Export as PDF
  1. Dynamic Media Optimization (DMO)
  2. Transformations
  3. Image optimization

Operations

Basic image resizing operations

Resizing operations enable the dynamic generation of image transformations to meet various web delivery use cases. Operations focus on the image size while allow to modify the image itself.

Available operations

Operation
Syntax
Description

width=X

sets the image width to X pixels

height=X

sets the image height to X pixels

org_if_sml=1

prevents resizing if the target size is larger than the origin image

func=crop

sets crop resize function

gravity=X

defines the part of the image to be retained when cropping X = [north | south][east | west] | auto | X,Y

tl_px=X,Y

sets coordinates of the top left corner of the cropping rectangle

br_px=X,Y

sets coordinates of the bottom right corner of the cropping rectangle

func=face

crops the image automatically focusing on the most prominent face

func=fit

sets fit resize function

func=cropfit

sets crop or fit resize function depending on the origin and the desired dimensions

func=bound

sets bound resize function

func=boundmin

bounds the image to the larger dimension

func=cover

sets cover resize function (distorts image proportions)

flip=[h][v]

mirrors the image horizontally and/or vertically

r=X

rotates the image to X degrees (counterclockwise)

trim=X

trims any solid-color border (if present); X is the aggressiveness of the operation

radius=X

applies rounded corners and optionally fills the empty background with a color

Resize functions

When you specify both width and height, original image proportions can be either ignored or maintained. Also, you may choose to add padding to the image to fill the blank space.

Filerobot supports the following resize function (operation func).

Crop

Keeps image proportions cutting the image to fit the defined width and height; see

This resizing function removes parts of the image and is the default behaviour when both width and height are defined. Read further for other resizing functions.

Preview
Syntax

Fit

Resizes the image keeping proportions and adding padding to satisfy the desired dimensions; see

Preview
Syntax

Cropfit

Performs either Cropor Fit based on image dimensions and transformation parameters; see

This resizing function may remove parts of the image

Preview
Syntax

Bound

Fits image in a box of defined size without adding padding; see

Preview
Syntax

The boundmin operation is a special case of bound where the smaller dimension is respected instead of the larger one, see

Cover

Resizes the image to the given width and height ignoring original image proportions, thus distorting the image; see

Preview
Syntax
PreviousImage optimizationNextWidth and height

Last updated 7 months ago

Do not hesitate to if you need any additional operations not listed above

650x500 origin image, cropped:

Same parameters, 400x250 origin image:

For troubleshooting purposes, use the ci_info=1 operation to view details about resizing and compression, for example:

contact us
/docs/hotel.jpg?w=400&ci_info=1
Width and height
Width and height
Prevent enlargement
Crop
Positionable crop
Positionable crop
Face crop
Fit
Cropfit
Bound
Boundmin
Cover
Flip
Rotate
Trim
Rounded corners
/docs/hotel.jpg?w=400&h=200&func=crop
/docs/hotel.jpg?w=400&h=200&func=fit&bg_color=000
/docs/classroom.jpg?func=cropfit&w=500&h=350&bg_colour=auto
/docs/ny_doc.jpg?func=cropfit&w=500&h=350&bg_colour=auto
/docs/hotel.jpg?w=400&h=200&func=bound
/docs/hotel.jpg?w=400&h=250&func=cover
Gravity crop