Next: Overlay Arrow, Previous: Fringe Bitmaps, Up: Fringes
This function defines the symbol bitmap as a new fringe bitmap, or replaces an existing bitmap with that name.
The argument bits specifies the image to use. It should be either a string or a vector of integers, where each element (an integer) corresponds to one row of the bitmap. Each bit of an integer corresponds to one pixel of the bitmap, where the low bit corresponds to the rightmost pixel of the bitmap.
The height is normally the length of bits. However, you can specify a different height with non-
nil
height. The width is normally 8, but you can specify a different width with non-nil
width. The width must be an integer between 1 and 16.The argument align specifies the positioning of the bitmap relative to the range of rows where it is used; the default is to center the bitmap. The allowed values are
top
,center
, orbottom
.The align argument may also be a list
(
align periodic)
where align is interpreted as described above. If periodic is non-nil
, it specifies that the rows inbits
should be repeated enough times to reach the specified height.
This function destroy the fringe bitmap identified by bitmap. If bitmap identifies a standard fringe bitmap, it actually restores the standard definition of that bitmap, instead of eliminating it entirely.
This sets the face for the fringe bitmap bitmap to face. If face is
nil
, it selects thefringe
face. The bitmap's face controls the color to draw it in.face is merged with the
fringe
face, so normally face should specify only the foreground color.