16.3.  Add Border

Revision History
Revision $Revision: 2446 $ 2007-08-18 ude

16.3.1.  Overview

Figure 16.356.  Example for the “Add Border” filter

Example for the Add Border filter

Original image

Example for the Add Border filter

Added border

This filter just does what its name says: it adds a border to the image. You can specify the thickness of the border as well as the color. The four sides of the border are colored in different shades, so the image area will appear raised.

The image will be enlarged by the border size, it won't be painted over.

16.3.2.  Options

Figure 16.357.  Add Border” options

Add Border options

Border X size, Border Y size

Here you can select the thickness of the added border, in pixels. X size (left an right) and Y size (top and bottom) may be different. Maximum is 250 pixels.

Border color

Clicking on this button brings up the color selector dialog that allows you to choose an “average” border color (see below, Delta value on color).

Delta value on color

This option makes the border sides to be colored in different shades and thus makes the image to appear raised. The actual color of the respective border side is computed for every color component red, green, and blue[13] from the “averageBorder color as follows:[14]

  • Top shade = Border color + Delta

  • Right shade = Border color - ½ Delta

  • Bottom shade = Border color - Delta

  • Left shade = Border color + ½ Delta

Figure 16.358.  Delta examples

Delta examples

Add Border” filter applied with Delta value 25, then with 75, 125, 175, and 225.

Example: the default color is blue (38,31,207), default delta is 25. So the shades of the borders are: top: (38,31,207) + (25,25,25) = (63,56,232), right: (38,31,207) + (-13,-13,-13) = (25,18,194), etc.

[13] See image types or RGB .

[14] Resulting values less than 0 are set to 0, values greater than 255 are set to 255.