Go to the previous, next section.

Merging Faces for Display

Here are all the ways to specify which face to use for display of text:

• With defaults. Each frame has a default face, whose id number is zero, which is used for all text that doesn't somehow specify another face.

• With text properties. A character may have a face property; if so, it's displayed with that face. If the character has a mouse-face property, that is used instead of the face property when the mouse is "near enough" to the character. See section Special Properties.

• With overlays. An overlay may have face and mouse-face properties too; they apply to all the text covered by the overlay.

• With special glyphs. Each glyph can specify a particular face id number. See section Glyphs.

If these various sources together specify more than one face for a particular character, Emacs merges the attributes of the various faces specified. The attributes of the faces of special glyphs come first; then come attributes of faces from overlays, followed by those from text properties, and last the default face.

When multiple overlays cover one character, an overlay with higher priority overrides those with lower priority. See section Overlays.

If an attribute such as the font or a color is not specified in any of the above ways, the frame's own font or color is used.

Go to the previous, next section.