GNU Info

(elisp)Face Functions

---

Next: Auto Faces Prev: Font Selection Up: Faces

---

Enter node , (file) or (file)node

Functions for Working with Faces
--------------------------------

   Here are additional functions for creating and working with faces.

 - Function: make-face name
     This function defines a new face named NAME, initially with all
     attributes `nil'.  It does nothing if there is already a face named
     NAME.

 - Function: face-list
     This function returns a list of all defined face names.

 - Function: copy-face old-face new-name &optional frame new-frame
     This function defines the face NEW-NAME as a copy of the existing
     face named OLD-FACE.  It creates the face NEW-NAME if that doesn't
     already exist.

     If the optional argument FRAME is given, this function applies
     only to that frame.  Otherwise it applies to each frame
     individually, copying attributes from OLD-FACE in each frame to
     NEW-FACE in the same frame.

     If the optional argument NEW-FRAME is given, then `copy-face'
     copies the attributes of OLD-FACE in FRAME to NEW-NAME in
     NEW-FRAME.

 - Function: face-id face
     This function returns the face number of face FACE.

 - Function: face-documentation face
     This function returns the documentation string of face FACE, or
     `nil' if none was specified for it.

 - Function: face-equal face1 face2 &optional frame
     This returns `t' if the faces FACE1 and FACE2 have the same
     attributes for display.

 - Function: face-differs-from-default-p face &optional frame
     This returns `t' if the face FACE displays differently from the
     default face.  A face is considered to be "the same" as the
     default face if each attribute is either the same as that of the
     default face, or unspecified (meaning to inherit from the default).