Version: 2.8.0

Resize

Resize can be a very complex task in Caravaggio. There are plenty of ways of resizing, cropping and extract portion of your images.
In general a resize command take this shape

rs_<size>_<mode>_<mode_params>

Where:
rs means you want change the final dimension of your image.
size is the new size (it can be expressed in several ways as explaned here).
mode define how to resize. Maybe you want to stretch the image, or take just a portion;
mode_params are the parameters accepted by the specific mode and can also be empty.

Resize methods

Scale

In scale mode the image will have the dimension of the size you specified. The aspect ratio is kept unless you pass iar (ignore aspect ratio) as additional parameter.
Since scale is the default resize mode, you can avoid specifiying it.

Scale the image to 200x300 px keeping the aspect ratio

Try
Copy
https://caravaggio.now.sh/rs_200x300/https://cvg-res.now.sh/girls.jpeg

Scale the image to 200 px width keeping the aspect ratio. The height is calculated automatically

Try
Copy
https://caravaggio.now.sh/rs_200/https://cvg-res.now.sh/girls.jpeg

Scale the image to 200x300 px width ignoring the aspect ratio.

Try
Copy
https://caravaggio.now.sh/rs_200x300_scale_iar/https://cvg-res.now.sh/girls.jpeg

Original
Two girls

Resized
Smaller image of two girls

Fit

The image will take the maximum available space up to the specified size, keeping the aspect ratio.
For example this will resize the image up to 300x300 pixels and all the image will be visible.

Try
Copy
https://caravaggio.now.sh/rs_300x300_fit/https://cvg-res.now.sh/girls.jpeg

Two girls, the image is fitted

NOTE: both width and height must be passed. Nonetheless they can be expressed in percentage

Down fit

Like fit but only if the image is larger than the desired size (width or height), otherwise it will be left untouched.

Try
Copy
https://caravaggio.now.sh/rs_300x300_downfit/https://cvg-res.now.sh/girls.jpeg

NOTE: both width and height must be passed. Nonetheless they can be expressed in percentage

Up fit

Like fit but only if the image is smaller than the desired size (both the width and height must be smaller), otherwise it will be left untouched.

Try
Copy
https://caravaggio.now.sh/rs_300x300_upfit/https://cvg-res.now.sh/girls.jpeg

NOTE: both width and height must be passed. Nonetheless they can be expressed in percentage

Fill

Produce a new image of specified width and height. The original image is then filled inside those dimensions. The excess part will be excluded.
You can specify a gravity to decide which part of the original image should be excluded. If nothing is specified the default gravity is center.

In this example we fill the image in a 300x300 px space, with gravity on the center

Try
Copy
https://caravaggio.now.sh/rs_300x300_fill/https://cvg-res.now.sh/girls.jpeg

Two girls, image is filled. Gravity is on the center

Here instead we change the gravity to north-east

Try
Copy
https://caravaggio.now.sh/rs_300x300_fill_ne/https://cvg-res.now.sh/girls.jpeg

Two girls, image is filled with north east gravity

Fill also accept a special gravity parameter: auto. This let you automatically select a meaningfull region of the image.
Here an example

Original

One girl. She is on the left side of the picture. The rest of the image has no particulars

Gravity on center (rs_200x300_fill_center)

One girl, filled with gravity on the center

Gravity auto (rs_200x300_fill_auto)

One girl, filled auto, the girl is now centered in the image
Try
Copy
https://caravaggio.now.sh/rs_200x300_fill_auto/https://cvg-res.now.sh/fill_original.png

Down fill

Same as fill but only if the image is larger than the target size (width and height).

Try
Copy
https://caravaggio.now.sh/rs_300x300_downfill/https://cvg-res.now.sh/girls.jpeg
Try
Copy
https://caravaggio.now.sh/rs_300x300_downfill_west/https://cvg-res.now.sh/girls.jpeg

Embed

This embeds the image in the specified dimensions. The entire image is taken and aspect ratio is kept. If the image doesn't fit well in the dimension the output will be padded with a color of your choice (or black by default). A gravity can be specified to decide how to embed the image. Both gravity and background color are optional

Try
Copy
https://caravaggio.now.sh/rs_320x240_embed/https://cvg-res.now.sh/girls.jpeg

Two girls. The picture is embedded and the remaining space is black

You can specify the color in RGB (red: 105, green: 72, blue: 200). Each number must have 3 digits, you have to pad them (so 72 must be written as 072).

Try
Copy
https://caravaggio.now.sh/rs_320x240_embed_b105072200/https://cvg-res.now.sh/girls.jpeg

Two girls. The picture is embedded and the remaining space is purple

The color can be specified in RGBA. To add the alpha channel value append .n at the end. To have full transparency put .0, to have full opacity put nothing, just the color.

Try
Copy
https://caravaggio.now.sh/rs_320x240_embed_b105072200.5/https://cvg-res.now.sh/girls.jpeg

The color can be specified in hexadecimal code (6 digit). Alpha can be specified as well

Try
Copy
https://caravaggio.now.sh/rs_320x240_embed_bFF5400.5/https://cvg-res.now.sh/girls.jpeg

You can spcify the gravity

Try
Copy
https://caravaggio.now.sh/rs_320x240_embed_bFF5400_gnorth/https://cvg-res.now.sh/girls.jpeg

Two girls. The picture is embedded with gravity on north

Sizes

The size parameter can be specified in several format in each resize mode.

Pixel

rs_200x300 is 200 x 300 px
rs_200 is 200 px width, height auto
rs_x300 is 200 px height, width auto

Percentage

You can specify the width and height as percentage value of the input image

rs_0.2x0.3 is 20% of the width and 30% of the height
rs_0.2 is 20% of the width
rs_x0.3 is 30% of the height

Mixed

Pixel and percentage can be mixed.

rs_200x0.3 is 200px of width and 30% of height

Gravity

For those operations which support gravity, those value can be specified

center, north, northeast, northwest, east, west, south, southeast, southwest

and can be abbreviated in

c, n, ne, nw, e, w, s, se, sw.

Some operation, such as fill and downfill accept the auto gravity. This automatically focus on the most important region of the image. Look here for an example

Colors

The colors accepetd by some operations can be expressed as:

RGB 120230007 in this case the rgb(120, 230, 7)

The three values of red, green and blue must be put together and each must be of three digits, so 7 becomes 007 and 45 becomes 045.

Hexadecimal FF00AB is in the hex format. The short notation (3 digits only) is not accepted yet and # at the beginning must be removed.

To specify the opacity you can add .3 at the end. So to set an opacity of 0.4 the previouses become 120230007.4 and FF00AB.4
Omitting the opacity means it is 1, full opaque, while .0 means full transparent.