Function: set-face-stipple

set-face-stipple is an interactive and byte-compiled function defined in faces.el.gz.

Signature

(set-face-stipple FACE STIPPLE &optional FRAME)

Documentation

Change the stipple pixmap of face FACE to STIPPLE.

FRAME nil or not specified means change face on all frames. STIPPLE should be a string, the name of a file of pixmap data. The directories listed in the x-bitmap-file-path variable are searched.

Alternatively, STIPPLE may be a list of the form (WIDTH HEIGHT DATA) where WIDTH and HEIGHT are the size in pixels, and DATA is a string, containing the raw bits of the bitmap.

View in manual

Probably introduced at or before Emacs version 19.29.

Key Bindings

Aliases

set-face-background-pixmap (obsolete since 29.1)

Source Code

;; Defined in /usr/src/emacs/lisp/faces.el.gz
(defun set-face-stipple (face stipple &optional frame)
  "Change the stipple pixmap of face FACE to STIPPLE.
FRAME nil or not specified means change face on all frames.
STIPPLE should be a string, the name of a file of pixmap data.
The directories listed in the `x-bitmap-file-path' variable are searched.

Alternatively, STIPPLE may be a list of the form (WIDTH HEIGHT DATA)
where WIDTH and HEIGHT are the size in pixels,
and DATA is a string, containing the raw bits of the bitmap."
  (interactive (read-face-and-attribute :stipple))
  (set-face-attribute face frame :stipple (or stipple 'unspecified)))