summaryrefslogtreecommitdiff
path: root/devdocs/elisp/xbm-images.html
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2025-08-14 22:58:58 -0500
committerCraig Jennings <c@cjennings.net>2025-08-14 22:58:58 -0500
commit82ba818ff456bcd6d56a06226e3f27e98fbb55c3 (patch)
tree158cfc17b2f644a10f063cb546752cfaae12c97f /devdocs/elisp/xbm-images.html
parent9278ddd4ea1a8b1a4c1edaa8894516e3f48d245b (diff)
downloaddotemacs-82ba818ff456bcd6d56a06226e3f27e98fbb55c3.tar.gz
dotemacs-82ba818ff456bcd6d56a06226e3f27e98fbb55c3.zip
removing all downloaded devdocs files
Diffstat (limited to 'devdocs/elisp/xbm-images.html')
-rw-r--r--devdocs/elisp/xbm-images.html13
1 files changed, 0 insertions, 13 deletions
diff --git a/devdocs/elisp/xbm-images.html b/devdocs/elisp/xbm-images.html
deleted file mode 100644
index 6941cb71..00000000
--- a/devdocs/elisp/xbm-images.html
+++ /dev/null
@@ -1,13 +0,0 @@
- <h4 class="subsection">XBM Images</h4> <p>To use XBM format, specify <code>xbm</code> as the image type. This image format doesn’t require an external library, so images of this type are always supported. </p> <p>Additional image properties supported for the <code>xbm</code> image type are: </p> <dl compact> <dt><code>:foreground <var>foreground</var></code></dt> <dd>
-<p>The value, <var>foreground</var>, should be a string specifying the image foreground color, or <code>nil</code> for the default color. This color is used for each pixel in the XBM that is 1. The default is the frame’s foreground color. </p> </dd> <dt><code>:background <var>background</var></code></dt> <dd><p>The value, <var>background</var>, should be a string specifying the image background color, or <code>nil</code> for the default color. This color is used for each pixel in the XBM that is 0. The default is the frame’s background color. </p></dd> </dl> <p>If you specify an XBM image using data within Emacs instead of an external file, use the following three properties: </p> <dl compact> <dt><code>:data <var>data</var></code></dt> <dd>
-<p>The value, <var>data</var>, specifies the contents of the image. There are three formats you can use for <var>data</var>: </p> <ul> <li> A vector of strings or bool-vectors, each specifying one line of the image. Do specify <code>:height</code> and <code>:width</code>. </li>
-<li> A string containing the same byte sequence as an XBM file would contain. You must not specify <code>:height</code> and <code>:width</code> in this case, because omitting them is what indicates the data has the format of an XBM file. The file contents specify the height and width of the image. </li>
-<li> A string or a bool-vector containing the bits of the image (plus perhaps some extra bits at the end that will not be used). It should contain at least <code><var>stride</var> * <var>height</var></code> bits, where <var>stride</var> is the smallest multiple of 8 greater than or equal to the width of the image. In this case, you should specify <code>:height</code>, <code>:width</code> and <code>:stride</code>, both to indicate that the string contains just the bits rather than a whole XBM file, and to specify the size of the image. </li>
-</ul> </dd> <dt><code>:width <var>width</var></code></dt> <dd>
-<p>The value, <var>width</var>, specifies the width of the image, in pixels. </p> </dd> <dt><code>:height <var>height</var></code></dt> <dd>
-<p>The value, <var>height</var>, specifies the height of the image, in pixels. </p> <p>Note that <code>:width</code> and <code>:height</code> can only be used if passing in data that doesn’t specify the width and height (e.g., a string or a vector containing the bits of the image). <acronym>XBM</acronym> files usually specify this themselves, and it’s an error to use these two properties on these files. Also note that <code>:width</code> and <code>:height</code> are used by most other image formats to specify what the displayed image is supposed to be, which usually means performing some sort of scaling. This isn’t supported for <acronym>XBM</acronym> images. </p> </dd> <dt><code>:stride <var>stride</var></code></dt> <dd><p>The number of bool vector entries stored for each row; the smallest multiple of 8 greater than or equal to <var>width</var>. </p></dd> </dl><div class="_attribution">
- <p class="_attribution-p">
- Copyright &copy; 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/XBM-Images.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/XBM-Images.html</a>
- </p>
-</div>