diff options
| author | Craig Jennings <c@cjennings.net> | 2024-04-07 13:41:34 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2024-04-07 13:41:34 -0500 |
| commit | 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 (patch) | |
| tree | f1190704f78f04a2b0b4c977d20fe96a828377f1 /devdocs/elisp/glyphs.html | |
new repository
Diffstat (limited to 'devdocs/elisp/glyphs.html')
| -rw-r--r-- | devdocs/elisp/glyphs.html | 18 |
1 files changed, 18 insertions, 0 deletions
diff --git a/devdocs/elisp/glyphs.html b/devdocs/elisp/glyphs.html new file mode 100644 index 00000000..7132acfd --- /dev/null +++ b/devdocs/elisp/glyphs.html @@ -0,0 +1,18 @@ + <h4 class="subsection">Glyphs</h4> <p>A <em>glyph</em> is a graphical symbol which occupies a single character position on the screen. Each glyph is represented in Lisp as a <em>glyph code</em>, which specifies a character and optionally a face to display it in (see <a href="faces">Faces</a>). The main use of glyph codes is as the entries of display tables (see <a href="display-tables">Display Tables</a>). The following functions are used to manipulate glyph codes: </p> <dl> <dt id="make-glyph-code">Function: <strong>make-glyph-code</strong> <em>char &optional face</em> +</dt> <dd><p>This function returns a glyph code representing char <var>char</var> with face <var>face</var>. If <var>face</var> is omitted or <code>nil</code>, the glyph uses the default face; in that case, the glyph code is an integer. If <var>face</var> is non-<code>nil</code>, the glyph code is not necessarily an integer object. </p></dd> +</dl> <dl> <dt id="glyph-char">Function: <strong>glyph-char</strong> <em>glyph</em> +</dt> <dd><p>This function returns the character of glyph code <var>glyph</var>. </p></dd> +</dl> <dl> <dt id="glyph-face">Function: <strong>glyph-face</strong> <em>glyph</em> +</dt> <dd><p>This function returns face of glyph code <var>glyph</var>, or <code>nil</code> if <var>glyph</var> uses the default face. </p></dd> +</dl> <p>You can set up a <em>glyph table</em> to change how glyph codes are actually displayed on text terminals. This feature is semi-obsolete; use <code>glyphless-char-display</code> instead (see <a href="glyphless-chars">Glyphless Chars</a>). </p> <dl> <dt id="glyph-table">Variable: <strong>glyph-table</strong> +</dt> <dd> +<p>The value of this variable, if non-<code>nil</code>, is the current glyph table. It takes effect only on character terminals; on graphical displays, all glyphs are displayed literally. The glyph table should be a vector whose <var>g</var>th element specifies how to display glyph code <var>g</var>, where <var>g</var> is the glyph code for a glyph whose face is unspecified. Each element should be one of the following: </p> <dl compact> <dt><code>nil</code></dt> <dd> +<p>Display this glyph literally. </p> </dd> <dt>a string</dt> <dd> +<p>Display this glyph by sending the specified string to the terminal. </p> </dd> <dt>a glyph code</dt> <dd><p>Display the specified glyph code instead. </p></dd> </dl> <p>Any integer glyph code greater than or equal to the length of the glyph table is displayed literally. </p> +</dd> +</dl><div class="_attribution"> + <p class="_attribution-p"> + Copyright © 1990-1996, 1998-2022 Free Software Foundation, Inc. <br>Licensed under the GNU GPL license.<br> + <a href="https://www.gnu.org/software/emacs/manual/html_node/elisp/Glyphs.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Glyphs.html</a> + </p> +</div> |