Dimensions of this image's border, a region that does not scale with the center area.

When EFL renders an image, its source may be scaled to fit the size of the object. This function sets an area from the borders of the image inwards which is not to be scaled. This function is useful for making frames and for widget theming, where, for example, buttons may be of varying sizes, but their border size must remain constant.

The units used for l, r, t and b are canvas units (pixels).

The border region itself may be scaled by the Efl.Gfx.Image.border_insets_scale.set function.
By default, image objects have no borders set, i.e. l, r, t and b start as 0.
Similar to the concepts of 9-patch images or cap insets.

Since 1.23


  • l - The border's left width.
  • r - The border's right width.
  • t - The border's top height.
  • b - The border's bottom height.


@property border_insets @pure_virtual {
    get {}
    set {}
    values {
        l: int (0);
        r: int (0);
        t: int (0);
        b: int (0);

C signature

void efl_gfx_image_border_insets_get(const Eo *obj, int *l, int *r, int *t, int *b);
void efl_gfx_image_border_insets_set(Eo *obj, int l, int r, int t, int b);

Implemented by