Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Black and white coversion
Duotone conversion
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
API endpoints for video-related operations
DAM provides a powerful and flexible API that supports various video-related operations. Whether you need to transcode videos into different formats, convert between video file types, compress large files, trim videos or combine multiple clips, Video API can take care of it.
The following subpages contain additional information for the available operations related to video management, including their typical use cases, detailed explanations, usage examples and links to the relevant API docs, which allow you to integrate these capabilities seamlessly into your applications and workflows.
Edit and optimize videos to prepare for fast delivery
DAM support 2 methods for optimizing and editing videos before delivery.
Depending on the use case, either or both methods can be useful.
Dynamic media transformations for images, videos and static content to accelerate assets on any device, in any location
DAM integrates image, video and static file optimizers to dynamically transform and compress DAM and externally-hosted media assets. Delivery is then accelerated over multi-CDN all around the world.
Section | Description |
---|---|
Optimized video delivery using adaptive streaming formats for fast loading on any device
Video transcoding is an integral part of our service, designed to provide seamless and efficient transcoding capabilities. It specializes in converting input videos into adaptive streaming formats, such as HTTP Live Streaming (HLS) and Dynamic Adaptive Streaming over HTTP (DASH). With support for various input file formats and target resolutions, optimal video delivery is guaranteed across multiple devices and network conditions.
Visit the following links to learn more about adaptive video streaming over HTTP:
The process can be summarized in three simple steps:
Upload of the origin video file to Filerobot.
Transcoding into chunks with support for multiple target resolutions.
Generation of the playlist file (.mpd for DASH and .m3u8 for HLS) that provides the necessary information for the video player to retrieve and play the video segments in a specific order and format.
By leveraging video transcoding for adaptive streaming, you gain access to the following:
Multi-device compatibility - With adaptive streaming formats like HLS and DASH, the videos become compatible with a wide range of devices, including smartphones, tablets, smart TVs, and desktop computers. This broad compatibility ensures that the content reaches a larger audience.
Improved user experience - Adaptive streaming adjusts the video quality dynamically, based on the viewer's available bandwidth. This results in reduced buffering times, faster start-up and uninterrupted playback, enhancing the overall user experience.
Bandwidth optimization - Our service efficiently compresses and transcodes videos, reducing the file size without compromising the visual quality. This optimization helps to minimize bandwidth consumption, allowing smoother playback even on limited network connections.
Scalability and flexibility - Support for large volumes of video transcoding requests as well as a wide range of input file formats and target resolutions, thus ensuring scalability and providing flexibility in adapting to specific requirements.
Information about the specific API endpoints is available in an always up-to-date documentation, that can be accessed via the following link:
There, you can find detailed information about the API endpoints, together with all required request parameters, so you know how to interact with them.
Transform and optimize your videos for various devices and platforms
The Video compression service provides a way to modify input videos by changing their bitrate and resolution. With support for multiple input formats and the flexibility to specify target resolution and bitrate using either concrete numeric values or predefined strings for typical uses, customers can optimize their video content for various devices and use cases.
A wide range of input video formats are supported, enabling video compression regardless of the original format and ensuring utilization across different platforms, devices, and playback environments.
The ability to specify target resolution and bitrate in several ways offers great flexibility. Videos can be easily adapted for different devices, screen sizes and network conditions, optimizing the viewing experience for their audience.
By converting videos to target resolutions and bitrates suitable for specific types of devices (e.g., mobile, tablet, desktop), the service ensures optimal playback performance and user experience. The delivered videos are tailored to the capabilities and display characteristics of different devices.
Video compression can be used in the following use cases:
Multi-device content delivery - If video content is distributed across different platforms and devices, the videos can be adapted to the specific resolutions and bitrates required, ensuring the content is optimally displayed and performs well regardless of the specific platform.
Video advertisements - Video ads can be converted and optimized for various advertising channels and ad placements, such as mobile ads, in-app ads, desktop ads, etc.
Responsive web design - Videos can be adjusted to match the breakpoints in a responsive design, which guarantees that they are appropriately displayed and offers a consistent user experience across different screen sizes.
Information about the specific API endpoints is available in an always up-to-date documentation, that can be accessed via the following link:
There, you can find detailed information about the API endpoints, together with all required request parameters, so you know how to interact with them.
Enhance your videos with customizable chapters for improved navigation and accessibility
Chapter generation offers a simple solution for generating .vtt (WebVTT) files with desired chapter times. WebVTT (Web Video Text Tracks) is a subtitle and caption file format widely used for displaying timed text in HTML5 videos. It provides a standardized format for creating text-based content such as captions, subtitles and descriptive metadata, allowing synchronized display with audiovisual media.
In addition to generating a .vtt file, you have the option to embed chapter information directly into the video metadata. This process involves modifying the metadata tags of the video file to include the chapter markers. Embedding the chapter information ensures that the chapters remain intact even when the video is distributed or played on different platforms.
With this service, you can enhance the accessibility and user experience of your videos by providing interactive chapter navigation.
This service can be valuable for a plethora of use cases, mainly:
Improving the user experience - Adding chapter markers to your videos allows viewers to navigate through the content more efficiently. Users can quickly jump to specific sections, facilitating easier content consumption and ensuring a more engaging viewing experience, especially for longer video content.
Enhancing accessibility - Incorporating chapter markers enables better accessibility for individuals with disabilities, such as visual impairments or cognitive challenges. Screen readers and assistive technologies can utilize the chapter information to help users navigate the video and access specific sections.
Content organization - Chapters provide a convenient way to organize and structure video content. By generating .vtt files with desired chapter times, lengthy videos can be broken down into logical sections, making it easier for viewers to find and consume the content that is most relevant to them.
Chapter customization - The chapter times can be defined according to specific user requirements. Customers have control over the timing and granularity of chapters, ensuring they align with the natural breakpoints or key moments within their videos.
Content discovery - Adding chapters to recorded webinars or presentations enables participants to revisit specific segments and key points. This improves the usability of recorded events and enhances content discoverability.
Information about the specific API endpoints is available in an always up-to-date documentation, that can be accessed via the following link:
There, you can find detailed information about the API endpoints, together with all required request parameters, so you know how to interact with them.
Effortless video transformation into various formats
The video conversion capabilities that we offer are designed to convert input videos into different formats, providing flexibility and compatibility for a wide range of applications and devices. Various input file formats are supported to ensure effortless conversion that meet any specific requirements.
By leveraging this feature, customers can gain access to versatile video conversion capabilities that enhance compatibility, accessibility and workflow efficiency, thus ensuring the video content reaches a wider audience while maintaining its quality and integrity.
This service caters to various use cases, including but not limited to:
Cross-platform compatibility - It ensures that the videos are suitable for distribution across different platforms.
Device-specific optimization - The videos can be better optimized for playback on specific devices, such as smartphones, tablets, smart TVs, etc. This makes the viewing experience tailored to each device's capabilities.
Archiving and preservation - The process of archiving and preserving videos can be greatly improved using formats deigned for long-term storage, thus ensuring accessibility and longevity for future use.
Content repurposing - Existing video content can be repurposed for different purposes, such as promotional clips, trailers or snippets for social media marketing campaigns. The videos are adapted to various formats and platforms, increasing reach and engagement.
Information about the specific API endpoints is available in an always up-to-date documentation, that can be accessed via the following link:
There, you can find detailed information about the API endpoints, together with all required request parameters, so you know how to interact with them.
Convert a specific page from a PDF document to an image
doc_page=X
When you provide a link to a PDF file, the first page is converted to an image and delivered via CDN. You can use all available , , capabilities and parameters. To convert a specific page of the PDF document, use the doc_page=X parameter.
Preview | Syntax |
---|
Minification of JS and CSS files
Seamlessly extract and combine specific sections of input videos
The video trimming service provides a seamless solution for trimming video files based on provided time intervals. It allows you to specify start and end times to extract specific sections from the input video, which are then joined together to create a new consolidated video file.
By leveraging video trimming, customers gain precise control over their video content, extracting specific sections and then joining them into merged video files. Whether they need to compile promotional videos, create social media content or produce video highlights, our service empowers them to streamline their video management process, deliver engaging content and create captivating video experiences for their audience.
This service can prove beneficial for multiple use cases, such as:
Content compilation - Specific sections from multiple source videos can be extracted and joined together to create compilations and highlight reels. This is valuable for creating promotional materials and recaps that showcase the best moments from various sources.
Advertisement campaigns - Sections from longer videos can be extracted to create concise advertisement videos. This ensures efficient delivery within potential time constraints.
Video previews - The most enticing sections of long videos can be extracted to create engaging previews, thus generating excitement and encouraging viewers to watch the complete video.
Social media content - Videos can be modified to meet any specific duration or content requirements for a given social media platform, leading to videos that are optimized for social media sharing and ensuring maximum engagement.
Information about the specific API endpoints is available in an always up-to-date documentation, that can be accessed via the following link:
There, you can find detailed information about the API endpoints, together with all required request parameters, so you know how to interact with them.
Merge two input videos into a single cohesive output clip
The Video combining service offers a seamless solution for merging two video files into a single cohesive video. It intelligently combines the videos while considering resolution and frame rate to maintain the best possible quality. The result file starts with the first input video and continues with the second one. As always, multiple input formats are supported.
Resolution considerations are handled gracefully when merging videos. By adopting the lower resolution of the two input videos, we prevent upscaling and maintain the original quality of the lower resolution video, ensuring optimal visual integrity in the final combined clip.
The frame rate of the result video is determined by adopting the highest frame rate from the two inputs. This ensures that the final combined clip maintains the smoothness and consistency of motion.
Merging input videos can be useful in multiple use cases:
Video compilations - Multiple video clips can be effortlessly compiled into a single montage, useful for creating highlights and compilations for various purposes such as marketing, promotions or social media content.
Advertisement creation - Different video segments can be combined into a single cohesive advertisement, ensuring a seamless viewing experience, effective storytelling or brand messaging.
Workflow streamlining - Combining videos into a single file simplifies the video management workflow. It allows for easier organization, sharing, and distribution of video content, reducing the need for handling multiple video files separately.
Viewing experience enhancement - Merging two videos into one can provide uninterrupted viewing experience by eliminating the need for viewers to manually switch between separate video files.
Information about the specific API endpoints is available in an always up-to-date documentation, that can be accessed via the following link:
There, you can find detailed information about the API endpoints, together with all required request parameters, so you know how to interact with them.
Short clip processing and delivery for websites and web applications
Please contact the support team to activate the video feature for your token.
DAM offers on-the-fly video processing with delivery via CDN using the DAM URL for seamless integration. This feature is suited for short clips for websites and web applications such as hero videos or product videos.
Input files are limited to 500 MB and compressed videos are limited to 4k resolution and duration of no more than 1 minute. If your videos exceed those limits, your use case probably does not fall into the scope of this feature and you should consider using and .
The video files processed in the URLs need to have the proper file extension (eg. .mp4, .webm).
//token.filerobot.com/folder/origin_video.mp4?w=600&format=auto
Parameter | Allowed values | Description |
---|
The automatic format delivery chooses the most efficient codec and format based on the viewer platform support - h265 (HEVC) mp4, vp9 webm or h264 (AVC) mp4.
Resize and crop to achieve the desired width and height
Crops the image to specified dimensions (width and height) while keeping proportions and delivers the resulting image via CDN.
func=crop
This is the default resizing mode when both width and height operations are used. You do not need to specify func=crop explicitly.
Preview | Syntax |
---|
Specifies which part of the image you wish to keep while cropping. If you omit the gravity option, central cropping is performed.
gravity=X
Dynamically generate compressed image transformations via URL parameters, presets or URL-based rules
To load fast on any device around the world, images need to be resized, cropped and compressed. No need to push a 20-megapixel image to deliver a 1170px wide thumbnail on a smartphone. DAM will manipulate and transform your images dynamically and optimize for web delivery, thus saving you days in image management.
DAM's image manipulation and transformation features rely on DMO (Dynamic media optimization), a standalone media optimization CDN developed by Scaleflex.
If you do not need storage for your origin (master) images and Digital Asset Management but just on-the-fly image and video transformation + CDN delivery, check-out . Cloudimage is a media proxy pulling your media assets from your origin hosting (web server, S3 bucket, etc.), caching, compressing and delivering them over CDN.
Everything starts with the basic URL format of a DAM URL:
//token.filerobot.com/folder/filename?operations&filters&watermarks
DAM automatically compresses these images into the most optimal delivery format (WebP, AVIF, ...) based on the user's device and context and accelerates them over multiple Content Delivery Networks from tier 1 CDN providers such as Akamai, Fastly, AWS Cloudfront and CDNetworks.
Non-image file optimization and delivery
func=proxy
DAM offers you the option to deliver any file, including non-processable files - static content like JS or CSS files, via our Content Delivery Network.
By default, all URLs are regarded as images. To deliver a non-image file, you have to use the func=proxy option:
DMO can automatically use the proxy function for all files which don't have an image file extension. This however will require all your images to have proper file extensions. If you prefer this behaviour, you can switch it on in your Admin Console ( Settings/ DMO -> Static content / Enable static Content acceleration):
Do not upscale an image if target size is larger than the origin image
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.
Operation | Syntax | Description |
---|
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).
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.
This resizing function may remove parts of the image
Preview | Syntax |
---|
Preview | Syntax |
---|
We have documented the most common resizing functions here. If you have any requests for undocumented features, and we will do our best to help.
The hostname token.filerobot.com can be replaced by a custom CNAME. Our team can set it up for you.
Preview | Syntax |
---|
Please note that PDF documents are always converted to images (for more info, please check the section). If you want to deliver PDF images as such, you need to use func=proxy:
Do not hesitate to if you need any additional operations not listed above
Keeps image proportions cutting the image to fit the defined width and height; see
Preview | Syntax |
---|
Resizes the image keeping proportions and adding padding to satisfy the desired dimensions; see
Preview | Syntax |
---|
Performs either or based on image dimensions and transformation parameters; see
Preview | Syntax |
---|
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
Resizes the image to the given width and height ignoring original image proportions, thus distorting the image; see
Preview | Syntax |
---|
For troubleshooting purposes, use the ci_info=1 operation to view details about resizing and compression, for example:
API endpoints for and larger video files to prepare them for CDN delivery
Dynamic video optimization for short video file using query-based parameters
Learn how DAM will resize, crop, compress, watermark and apply various filters to your images to make them look beautiful, slim through WebP & AVIF, and load fast on any device around the World
Adaptive video streaming over HTTP is key to have videos load fast any where on any device. DAM can transcode your videos in multiple target resolutions and generate the playlist for your DASH or HLS video player to consume.
Filerobot offers you on-the-fly static content optimization to minify JS and CSS files. PDFs can be converted and delivered as images.
w |
| Sets the target video width |
h |
| Sets the target video height |
func |
| Sets the resize function if both width and height parameters are provided |
bg_color | hex color code / color name | Background (padding) color (for use with func=fit) |
bg_img_fit |
| Use blurred version of the video for background / padding (for use with func=fit) |
format |
| Defines the video format |
bitrate |
| Sets the compression bitrate (in kilobits or megabits per second) |
Modify brightness, contrast and saturation
Color effects and filters
northwest | north | northeast |
west | center | centre (default) | east |
southwest | south | southeast |
token | Your Filerobot token |
folder/filename | Here, you can use the full path to the image in your Filerobot container, e.g. demo/part2/image.jpg |
operations |
filters |
watermarks |
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 |
Allow upscaling (default): |
Prevent upscaling: |
Crop operation focusing only on one face
Finds the most prominent face in the image and crops it to specified dimension provided with the width and height parameters. If you however provide only one dimension, the other dimension will be chosen automatically to keep the aspect ratio of the face.
func=face
If there is no face in the image or many faces are found, the operation defaults to a standard crop.
Preview | Syntax |
---|---|
Sets margins around the face. You can set equal margins with face_margin=X or separate horizontal and vertical margins (face_margin=W,H).
face_margin=X|W,H
Preview | Syntax |
---|---|
Crop operation which removes faces from the top of the image
Crops out the topmost part of an image if it contains a face.
To control the margin when cropping the face out, you can use the face_margin=Y operation where Y is a percentage of the face height. Its default value is 20. You can also use negative numbers if you would like to keep part of the face.
func=facehide
Preview | Syntax |
---|---|
Chooses the most important image features and objects and sets the focal point on them when cropping.
gravity=smart
gravity=auto
gravity=face
Sets the crop focal point on the people in the image or on the most prominent featues if no faces are detected. Useful for creating thumbnails from images with different aspect ratios.
Preview | Syntax |
---|---|
If you prefer to use the legacy automatic crop, just set gravity operation to auto.
Preview | Syntax |
---|---|
When using gravity=face, all images with one dominant face are focused on this face upon cropping. If there are many or no faces in the image, gravity falls back to auto.
If you would like to try and include multiple faces in the image, you can use gravity=smart
Fits the image in a box with padding when needed
Setting crop gravity with focal point coordinates
Allows to crop an image by defining the coordinates of the crop focal point. It is useful when you want to crop images where the coordinates of the point of interest are already known.
To set the coordinates of the focal point, use the gravity=X,Y operation where X and Y are the coordinates of the focal point (in pixels). Alternatively, you can set the coordinates as a percentage of the original image - gravity=Xp,Yp or gravity=xc,yc, where X,Y=0..100 and x,y=0..1.
gravity=X,Y
gravity=Xp,Yp|xc,yc
Original image: /docs/castle.jpg?w=1000
Please note that the focal point in gravity=X,Y has to be defined as coordinates X and Y of the full-sized origin image and not the scaled-down version.
Crop by boundary coordinates
Allows to crop an image by providing the cropping area. It is useful when you want to crop a specific part of the image. To set the coordinates of the crop rectangle, use the tl_px and br_px operations.
tl_px=X1,Y1
br_px=X2,Y2
Original image: /docs/kids.jpg
Positionable crop can be combined with all available resize functions - width/height, crop, fit, bound or cover. This operation is performed after the positionable crop.
Automatic crop or fit based on origin dimensions
Performs either or operation depending on the origin image and the desired transformation dimensions.
If the desired image is smaller than the original, the result is cropped to achieve the desired dimensions.
func=cropfit
Preview | Syntax |
---|---|
If you include the operation in the URL, the image will be trimmed first (if possible) and then either cropped or fitted to the desired size.
Preview | Syntax |
---|---|
Resize with minimum size constraints (to fill a box)
Resizes an image while bounding the smaller dimension to the desired width or height while keeping proportions. Delivers the resulting image via CDN.
func=boundmin
Please note that the larger dimension of the resized image will be equal or greater than the dimensions set in the URL. If you would like to fit the image to set width and height, you should use either or .
Preview | Syntax |
---|---|
Resize ignoring proportions
Delivers the optimal size based on device pixel-ratio
Allows you to deliver the right image dimensions according to a defined device pixel ratio. This operation can help with conversion between device-independent pixels and CSS (reference) pixels. Useful in responsive image solutions using the srcset html attribute. Allows positive values limited to 5.
dpr=X
Preview | Syntax |
---|---|
Image trimming
Removes any single-color padding around the image if present.
The parameter does not specify the amount of border or frame to trim but rather how aggressive the trim algorithm should be. A bigger value of the parameter (e.g. 25) will trim rather more than not enough. Typical values are between 0 and 10.
This allows you to use the same parameter values for all your images.
trim=X
If the image is resized with the width and/or height commands, the resizing is performed after the border (if present) is trimmed.
Preview | Syntax |
---|---|
Crop by aspect ratio or aspect ratio range.
Sets target aspect ratio or aspect ratio range when cropping. Aspect ratios can be set as decimal values (1.778) or ratios (16:9).
aspect_ratio=AR | ar=AR
aspect_ratio=AR1,AR2 | ar=AR1,AR2
If you provide only one dimension parameter (width or height) and aspect_ratio, the other dimension will be calcualted. If you include both width and height in the URL, aspect_ratio is ignored.
If you provide only aspect_ratio and no dimensions (width or height), the image will be cropped without resizing.
Preview | Syntax |
---|---|
You can spcify a range of aspect ratio, for example aspect_ratio=4:3,16:9. Images which fall within this range, will not be cropped. Useful to avoid very wide ot very tall images by cropping them to the closest aspect ratio.
Apply image effects and adjustments
Colorize the image with an overlay
To create a color overlay by using colorize=X[,Y], where X is the color of the overlay (hex value or color name) and Y is the opacity (Y=0..1
, default 0.5
).
colorize=X[,Y] | colourise=X[,Y]
Preview | Syntax |
---|---|
Compose image or text layers over the main image
DAM can place a watermark on top of your images if you want to protect them from copying, or tag them with a serial number or custom text. There are three types of watermarks - click on each one for more details.
This is a beta feature, please contact our support to activate it for your token
You can overlay multiple watermarks by indexing the parameters in the URL wat[1]=1&wat[2]=1. The wat=1 parameter must be indexed and contain all watermarks to activate the feature.
All parameters without indices will be applied to all watermarks in the image.
?wat[1]=1&wat[2]=1&wat_scale[1]=50&wat_scale[2]=10&wat_opacity=0.5
In the above fragment, wat_opacity=0.5 will be applied to both watermarks.
Combining multiple watermark types is also possible. Remember that the presense of wat_url=X parameter defines a dynamic watermark, wat_text=X defines a text watermark and the absence of either defines a static watermark.
?wat[1]=1&wat[2]=1&wat[3]=1&wat_url[2]=sample.li/Angular.png&wat_text[3]=text
In the above fragment, there are three watermarks. Watermark 2 is a dynamic watermark, watermark 3 is a text watermark and watermark 1 is a static one.
You can change the compression (output format and quality) of your image by using compression filters. You can use the compression filters alongside and .
By default, Filerobot delivers the images as WebP. If the format is not supported by the client browser, it falls back to JPEG or PNG. If you wish to keep the original format, you can use force_format=original.
You can of course force a specific output format(s). More details can be found in the image formats section.
Supported output image formats
The JPEG compression format is suitable for delivering photographic images with minimal quality loss and high compression rate. You can either choose the compression factor yourself or use Optipress - our Machine Learning based algorithm, which will choose the best way to reduce JPEG file size minimising perceptual quality loss.
Preview | Syntax |
---|---|
This format is a good choice for non-photographic images - flowcharts, graphs, screenshots, logos, etc. PNG also supports transparency.
While the PNG format offers lossy compression only, Filerobot can optimize the image before compression by reducing the number of colors or adding slight dithering (while preserving edges). This method usually leads to smaller file sizes for images visually indistinguishable from the original ones.
You can activate this feature in the Asset Hub (Settings/Process/Images/Image compression):
WebP is an image format maintained by Google and supported in certain browsers (mainly Chrome, Opera and on Chrome Android) which provides more aggressive compression techniques as JPG without noticeable quality degradation.
By default, automatic WebP transcoding is deactivated. If you choose to activate it, all images will be delivered as WebP. If the client's browser does not support this format, JPEG or PNG (if image has alpha channel) is used instead.
You can use the following parameters to control webp compression quality:
By default, Filerobot delivers the images as WebP, when the format is supported by the browser. If you would like to keep the format of the original image (when possible), you can use force_format=original.
Statically definbed image overlay
This function will watermark selected images with the same watermark - an image set in the Asset Hub. This is useful for placing your company logo, name or other copyright information. If you would like to watermark different images with different watermarks, please refer to the section.
Log in to your DAM and navigate to Settings / DMO -> Images / Watermark and upload your default watermark using the uploader.
To activate the watermark function, you need to include the wat=1 parameter.
The wat_gravity option sets the position of the watermark (available values are east, northeast, north, northwest, west, southwest, south, southeast, and center/centre) and the wat_pad defines the offset of the watermark from the gravity position.
The padding can be defined in pixels (wat_pad=X[,Y]) or in percent of output size (wat_pad=Xp[,Yp]). The padding is applied after scaling the final image and then it is compressed (see Compression) and delivered via CDN.
The watermark can be scaled relative to the original watermark image (wat_scale=X[,Y]) or relative to the output image (wat_scale=Xp[,Yp]).
To keep the watermark-to-image proportions for all image resizes, you should use the wat_scale=Xp[,Yp].
Machine learning based image compression
Different images compressed with the same compression parameters may result in different perceptive quality. Moreover, the same image in different sizes may require different compression strategy to achieve maximum size gain without visible quality loss.
To overcome this, you can use our Optipress JPEG compression algorithm.
Optipress finds out the best JPG compression approach by analysing specific image features and current compression parameters.
A Machine Learning model determines the best compression strategy for this image.
Quality is then evaluated based on a simulation model of the Human Visual System to achieve optimum compression without perceptive quality deterioration.
By using Optipress, you can get the most of the JPEG compression format.
Optipress achieves best results when re-compressing JPEG files and when the image quiality is crucial.
Images created by Optipress fully comply with baseline JPEG specifications and are compatible with all JPEG encoders.
Preview | Syntax |
---|
Color saturation correction
To adjust the color saturation, you can use the saturate=X filter and set the desired adjustment value (X= -100..100
). Negative values will decrease color saturation while positive ones will increase it.
saturate=X
Preview | Syntax |
---|
Using saturate=-100 will remove all color information and convert the image to grayscale.
Please keep in mind that desaturating an image just discards all color information. If you prefer to create a grayscale image while taking into account human visual system color intensity perception, you should use the gray parameter instead.
Preview | Syntax |
---|
Simple resize:
Crop function:
Fit function with blurred background:
auto -
face -
smart -
X,Y -
Image manipulation operations like width, height, crop, fit, rotate, and trim. For a full list, see .
Use filters like contrast, pixellate, blur, grayscale, and sharpen to apply different effects to your image. All filters can be found in the .
Place static or dynamic watermarks on your images, .
Resize operation:
Resize and convert to grayscale:
Grayscale thumbnail with a watermark:
650x500 origin image, cropped:
Same parameters, 400x250 origin image:
Preview | Syntax |
---|---|
Preview | Syntax |
---|---|
Preview | Syntax |
---|---|
Preview | Syntax |
---|---|
Preview | Syntax |
---|---|
Preview | Syntax |
---|---|
Parameter | Syntax | Description |
---|
Preview | Syntax |
---|
Set format
force_format=webp
forces using the JPEG image compression
Quality
q=X
X=0..100
the smaller the value of q, the more your image will be compressed. Be careful - the quality of the image will decrease as well.
Lossless
lossless=1
use lossless webp compression
use watermark | wat=1 | (required) Activates the watermark function |
watermark position | wat_gravity=X
| Defines the position to "anchor" the watermark to |
watermark scaling (relative to original watermark size) | wat_scale=X
| Watermark image scaling defined in in percent of the watermark dimensions |
watermark scaling (relative to output image size) | wat_scale=Xp
| Watermark image scaling defined in in percent of the output image dimensions |
watermark padding | wat_pad=X[p][,Y[p]]
| Adds padding from the anchoring point in pixels (X) or in percent (Xp) |
watermark opacity | wat_opacity=X
| Defines watermark opacity |
gravity
gravity=X
X=[north|south][east|west]
sets the position of the image in the fit box
solid background
bg_color=X | bg_colour=X
X={hex color}|auto
defines a background color with a hex code, color name or automatically, based on the image palette
blurred background
bg_img_fit=1
sets blurred image background
bg_blur=X
applies Gaussian blur to the background image
bg_opacity=X
X=0..1
specifies background image opacity
bg_colourise=X | bg_colorize=X
defines a color to tint the background image
northwest
north
northeast
west
center | centre (default)
east
southwest
south
southeast
Solid background: /docs/hotel.jpg?w=400&h=245&func=fit&bg_color=000
Automatic solid background: /docs/frog.png?func=fit&w=400&h=220&bg_colour=auto
Blurred background: /docs/car1.jpg?w=400&h=320&func=fit&bg_img_fit=1&bg_opacity=0.75
Blurred background, tinted: /docs/boat.jpg?func=fit&w=400&h=330&bg_img_fit=1&bg_opacity=0.5&bg_colorize=red
Original aspect ratio (3:2 or 1.5): /docs/car1.jpg?w=400
Cropped to 1.8: /docs/car1.jpg?w=400&aspect_ratio=1.8
Original aspect ratio (1.323): /docs/frog.png
Cropped to 3:2 (1.5): /docs/frog.png?aspect_ratio=3:2
Original aspect ratio 1.5: /docs/car1.jpg?w=400
Aspect ratio range 1.5..2 (no crop needed): /docs/car1.jpg?w=400&aspect_ratio=1.5,2.0
Original aspect ratio 2.25:1 (2.25): /docs/kids.jpg?w=400
Aspect ratio range 3:2..2:1 (1.5..2): /docs/kids.jpg?w=400&aspect_ratio=3:2,2:1
Apply the same image watermark to all the images you decide to watermark (e.g. your company's logo).
Specify the watermark in the DAM URL to apply different watermarks to different images.
If you need to tag images, use the text watermark to dynamically embed text to the images you need tagged.
Set format
force_format=jpg
forces using the JPEG image compression
Quality
q=X
X=0..100
the smaller the value of q, the more your image will be compressed. Be careful - the quality of the image will decrease as well.
Optipress
optipress=X
X=1..3
chooses the best compression approach maintaining visual quality via the Optipress algorithm
q=85, filesize 204 kB: /docs/woman_dress.jpg?force_format=jpeg&q=85 q=75, filesize 129 kB: /docs/woman_dress.jpg?force_format=jpeg&q=75 q=65, filesize 102 kB: /docs/woman_dress.jpg?force_format=jpeg&q=65
Set format
force_format=png
forces using the PNG image compression
Standard crop: /docs/business-portfolio.jpg?w=400&h=300
Face crop: /docs/classroom.jpg?h=240&w=380&func=face
Face crop with automatic aspect ratio: /docs/classroom.jpg?h=240&func=face
Original image (650x500 pixels): /docs/classroom.jpg
Cropfit to 500x350: /docs/classroom.jpg?func=cropfit&w=500&h=350&bg_color=auto
Original image (400x250 pixels): /docs/ny_doc.jpg
Cropfit to 500x350: /docs/ny_doc.jpg?func=cropfit&w=500&h=350&bg_color=auto
Original image: /docs/sofa.jpg
Cropfit + trim: /docs/sofa.jpg?func=cropfit&trim=0&w=500&h=350&bg_colour=auto
No dpr parameter (assumed dpr=1): /docs/birds.jpg?w=400
Device pixel ratio 1.75: /docs/birds.jpg?w=400&dpr=1.75
Original image: /docs/painting_big.jpg?w=400
Trimmed image: /docs/painting_big.jpg?w=400&trim=10
Original image: /docs/sofa.jpg?w=400
Trimmed image: /docs/sofa.jpg?w=400&trim=10
Flip horizontally: /docs/flat_hd.jpg?w=400&flip=h
Flip both horizontally and vertically: /docs/flat_hd.jpg?w=400&flip=hv
Transparent corners (default, if the formats supports transparency): /docs/flat2.jpg?w=400&radius=25&force_format=png
Solid color corners: /docs/car1.jpg?w=400&radius=25&bg_color=cccc30
bright=X | f=bright:X
adjusts the brightness of the image
contrast=X | f=contrast:X
adjusts the contrast of the image
saturate=X | f=saturate:X
adjusts the saturation of the image
gray=1 | f=gray | grey=1 | f=grey
converts the image to a black and white one
colorize=X | colourise=X
applies a color overlay
pixelate=X | f=pixelate:X | pixellate=X | f=pixellate:X
pixelates the image into X-pixel-sized blocks
blur=X | f=blur:X
applies Gaussian blur
sharp=X | f=sharp:X
applies unsharp mask to sharpen the image
Separate parameters: /docs/ny_doc.jpg?bright=15&contrast=30&gray=1
Concatenate into the f parameter: /docs/ny_doc.jpg?f=bright:15,contrast:30,gray
Original image: /docs/frog.png?w=400
Increased brightness: /docs/frog.png?w=400&bright=15
Decreased brightness: /docs/frog.png?w=400&bright=-10
Original image: /docs/frog.png?w=400
Color overlay: /docs/frog.png?w=400&colorize=red,0.85
Desaturate and color overlay: /docs/frog.png?w=400&saturate=-100&colorize=7af,0.6
Grayscale and color overlay: /docs/frog.png?w=400&gray=1&colorize=7af,0.6
Original image: /docs/earth.jpg?w=400
Pixelate effect: /docs/earth.jpg?w=400&pixelate=8
Original image: /docs/ny_doc.jpg
Blur applied: /docs/ny_doc.jpg?blur=6
Original image: /docs/frog.png?w=400
Increased contrast: /docs/frog.png?w=400&contrast=30
Decreased contrast: /docs/frog.png?w=400&contrast=-10
use watermark
wat=1
(required) Activates the watermark function
watermark URL
wat_url=X
(required) The URL of the watermark image. Can be URL-encoded
watermark position
wat_gravity=X
X=[north|south][east|west]|center
Defines the position to "anchor" the watermark to
watermark scaling (relative to original watermark size)
wat_scale=X
X=0..100
Watermark image scaling defined in in percent of the watermark dimensions
watermark scaling (relative to output image size)
wat_scale=Xp
X=0..100p
Watermark image scaling defined in in percent of the output image dimensions
watermark padding
wat_pad=X[p][,Y[p]]
X/Y=0..100[p]
Adds padding from the anchoring point in pixels (X) or in percent (Xp)
watermark opacity
wat_opacity=X
X=0..1
Defines watermark opacity
use watermark
wat=1
(required) Activates the watermark function
watermark text
wat_text=X
(required) The text to be overlayed. Can be URL-encoded
watermark position
wat_gravity=X
X=[north|south][east|west]|center
Defines the position to "anchor" the watermark to
watermark padding
wat_pad=X[p][,Y[p]]
X/Y=0..100[p]
Adds padding from the anchoring point in pixels (X) or in percent (Xp)
watermark opacity
wat_opacity=X
X=0..1
Defines watermark opacity
watermark font
wat_font=X
Choose the font family for the overlay
watermark color
wat_color=X | wat_colour=X
Sets the text color
watermark font size
wat_fontsize=X | wat_fontsize=Xmax
Sets the font size. If the Xmax syntax is used, the size is reduced if the text cannot fit in the image
Text size limit set with wat_fontsize=20max: /docs/flat1.jpg?w=400&wat=1&wat_gravity=north&wat_text=A%20VERY%20LONG%20TEXT%20WHICH%20WON%27T%20FIT&wat_pad=10&wat_font=Arial-Black&wat_fontsize=20max&wat_color=000
A modern format suitable for most images. Supports trasnparency and offers both lossy and lossless compression.
The most popular and widely-supported format. Used by digital cameras. Suitable for photographic images. Lossy compression only.
Image format with transperency support suitable for raster logos, charts, infographs, etc. Lossless compresison only.
optipress=1 | most conservative setting; image quality is prioritised |
optipress=2 | balanced setting |
optipress=3 | most aggressive setting; optimised for smaller file size |
q=85, 543 kB: optipress=3, 347 kB: |
q=85, 246 kB: optipress=3, 150 kB: |
Original image: |
Increased saturation: |
Desaturation: |
Grayscale: |
Only resize: |
Resize and sharpen: |
Watermark scaled down to 45% of its original size (660px), results in 297px watermark:
Watermark scaled relative to the output image dimensions (540px watermark):