Derivatives Configurations (Configs)
The derivatives configuration is the core concept of how Derivv Pro works. They determine the size and other attributes of derivative images. This page covers all aspects of configs.
Properties
Properties of the config that can be changed to customize the resulting derivative image(s).
Basic properties
- Name
name
- Description
- The name of the config.
- Name
dimensions
- Type
- width x height
- Description
The dimensions of the resulting derivative image(s). Setting both dimensions, width and height, will resize to exactly to those dimensions.
Setting one dimension, width or height, will create a derivative image with the same aspect ratio as the original image, but will restrict the maximum width or height to the dimension set.
Leaving both dimensions empty will use the original dimensions, meaning it will not resize the image, but it will apply any other settings like compression, sampling filter, and file type.
Advanced properties
- Name
file type
- Type
- inherit | jpg | png | webp
- Description
The optional output format of the config that will override the default file type of the original image.
The default file type is
inherit
, which means the file type of the original image will be used for all derivative images.
- Name
compression
- Type
- 0-100
- Description
The optional compression level of the resulting derivative image(s). Higher compression levels result in smaller file sizes, but lower image quality. Compression is only applied if the file type is
jpg
.
- Name
fit
- Type
- cover | contain
- Description
The fit of the resulting derivative image(s).
cover
will scale and crop the image to fit the dimensions, whilecontain
will scale the image to fit the dimensions, keeping the aspect ratio and filling the remaining space with the background color.
- Name
background color
- Type
- rgb(0, 0, 0, 255)
- Description
The background color of the resulting derivative image(s). This is only used if the fit is
contain
.
- Name
sampling filter
- Type
- nearest | triangle | catmull-rom | gaussian | lanczos3
- Description
The sampling filter to use when creating the derivative image(s).
The sampling filter controls how pixels are calculated when resizing images. Higher quality filters like Lanczos3 provide better detail and smoother edges, while simpler filters like Nearest are faster but may show artifacts.
The default sampling filter is
catmull-rom
.
Settings
- Name
units
- Type
- px | in
- Description
The units of the resulting derivative image(s).
- Name
dpi
- Type
- 72 | 150 | 300
- Description
The DPI (dots per inch) of the resulting derivative image(s). This is only used if the units are inches
in
. If the units are pixelspx
, the DPI is72
The default DPI is
72
.
- Name
2x
- Type
- true | false
- Description
Whether to create a 2x image variation along with the 1x image.
- Name
3x
- Type
- true | false
- Description
Whether to create a 3x image variation along with the 1x and/or 2x images.