Adds a rectangular border around the outside edge of an image.

Requires Extension: Image extension

ImageAddBorder( image=any, thickness=number, color=string, borderType=string );

Returns: void

Argument Description Default
any, required

The image on which this operation is performed.

Alias: name

number, optional

Thickness of the border in pixels. The default value is 1. The border is added to the outside edge of the image; the image area is increased accordingly.


string, optional

Optional. Border color. The default border color is black. See Usage. Only valid if the borderType is not specified or if borderType = "constant".

Alias: colour


string, optional

The type of border:

  • zero: Sets the border color to black.
  • constant: Sets the border to the specified color (default).
  • copy: Sets sample values to copies of the nearest valid pixel. For example, pixels to the left of the valid rectangle assume the value of the valid edge pixel in the same row. Pixels both above and to the left of the valid rectangle assume the value of the upper-left pixel.
  • reflect: Mirrors the edges of the source image. For example, if the left edge of the valid rectangle is located at x = 10, pixel (9, y) is a copy of pixel (10, y) and pixel (6, y) is a copy of pixel (13, y).
  • wrap: Tiles the source image in the plane.

Alias: type, border



cfimage(action="writeToBrowser", source=img);

See also