new repository

1 files changed, 19 insertions, 0 deletions

diff --git a/devdocs/elisp/font-and-color-parameters.html b/devdocs/elisp/font-and-color-parameters.html
new file mode 100644
index 00000000..4f6f9329
--- /dev/null
+++ b/devdocs/elisp/font-and-color-parameters.html
@@ -0,0 +1,19 @@
+ <h4 class="subsubsection">Font and Color Parameters</h4>  <p>These frame parameters control the use of fonts and colors. </p> <dl compact>  <dt><code>font-backend</code></dt> <dd>
+<p>A list of symbols, specifying the <em>font backends</em> to use for drawing characters on the frame, in order of priority. In Emacs built without Cairo drawing on X, there are currently three potentially available font backends: <code>x</code> (the X core font driver), <code>xft</code> (the Xft font driver), and <code>xfthb</code> (the Xft font driver with HarfBuzz text shaping). If built with Cairo drawing, there are also three potentially available font backends on X: <code>x</code>, <code>ftcr</code> (the FreeType font driver on Cairo), and <code>ftcrhb</code> (the FreeType font driver on Cairo with HarfBuzz text shaping). When Emacs is built with HarfBuzz, the default font driver is <code>ftcrhb</code>, although use of the <code>ftcr</code> driver is still possible, but not recommended. On MS-Windows, there are currently three available font backends: <code>gdi</code> (the core MS-Windows font driver), <code>uniscribe</code> (font driver for OTF and TTF fonts with text shaping by the Uniscribe engine), and <code>harfbuzz</code> (font driver for OTF and TTF fonts with HarfBuzz text shaping) (see <a href="https://www.gnu.org/software/emacs/manual/html_node/emacs/Windows-Fonts.html#Windows-Fonts">Windows Fonts</a> in <cite>The GNU Emacs Manual</cite>). The <code>harfbuzz</code> driver is similarly recommended. On other systems, there is only one available font backend, so it does not make sense to modify this frame parameter. </p>  </dd> <dt><code>background-mode</code></dt> <dd>
+<p>This parameter is either <code>dark</code> or <code>light</code>, according to whether the background color is a light one or a dark one. </p>  </dd> <dt><code>tty-color-mode</code></dt> <dd>
+ <p>This parameter overrides the terminal’s color support as given by the system’s terminal capabilities database in that this parameter’s value specifies the color mode to use on a text terminal. The value can be either a symbol or a number. A number specifies the number of colors to use (and, indirectly, what commands to issue to produce each color). For example, <code>(tty-color-mode . 8)</code> specifies use of the ANSI escape sequences for 8 standard text colors. A value of -1 turns off color support. </p> <p>If the parameter’s value is a symbol, it specifies a number through the value of <code>tty-color-mode-alist</code>, and the associated number is used instead. </p>  </dd> <dt><code>screen-gamma</code></dt> <dd>
+ <p>If this is a number, Emacs performs gamma correction which adjusts the brightness of all colors. The value should be the screen gamma of your display. </p> <p>Usual PC monitors have a screen gamma of 2.2, so color values in Emacs, and in X windows generally, are calibrated to display properly on a monitor with that gamma value. If you specify 2.2 for <code>screen-gamma</code>, that means no correction is needed. Other values request correction, designed to make the corrected colors appear on your screen the way they would have appeared without correction on an ordinary monitor with a gamma value of 2.2. </p> <p>If your monitor displays colors too light, you should specify a <code>screen-gamma</code> value smaller than 2.2. This requests correction that makes colors darker. A screen gamma value of 1.5 may give good results for LCD color displays. </p>  </dd> <dt><code>alpha</code></dt> <dd>
+   <p>This parameter specifies the opacity of the frame, on graphical displays that support variable opacity. It should be an integer between 0 and 100, where 0 means completely transparent and 100 means completely opaque. It can also have a <code>nil</code> value, which tells Emacs not to set the frame opacity (leaving it to the window manager). </p> <p>To prevent the frame from disappearing completely from view, the variable <code>frame-alpha-lower-limit</code> defines a lower opacity limit. If the value of the frame parameter is less than the value of this variable, Emacs uses the latter. By default, <code>frame-alpha-lower-limit</code> is 20. </p> <p>The <code>alpha</code> frame parameter can also be a cons cell <code>(<var>active</var> . <var>inactive</var>)</code>, where <var>active</var> is the opacity of the frame when it is selected, and <var>inactive</var> is the opacity when it is not selected. </p> <p>Some window systems do not support the <code>alpha</code> parameter for child frames (see <a href="child-frames">Child Frames</a>). </p>
+</dd> </dl> <p>The following frame parameters are semi-obsolete in that they are automatically equivalent to particular face attributes of particular faces (see <a href="https://www.gnu.org/software/emacs/manual/html_node/emacs/Standard-Faces.html#Standard-Faces">Standard Faces</a> in <cite>The Emacs Manual</cite>): </p> <dl compact>  <dt><code>font</code></dt> <dd>
+<p>The name of the font for displaying text in the frame. This is a string, either a valid font name for your system or the name of an Emacs fontset (see <a href="fontsets">Fontsets</a>). It is equivalent to the <code>font</code> attribute of the <code>default</code> face. </p>  </dd> <dt><code>foreground-color</code></dt> <dd>
+<p>The color to use for characters. It is equivalent to the <code>:foreground</code> attribute of the <code>default</code> face. </p>  </dd> <dt><code>background-color</code></dt> <dd>
+<p>The color to use for the background of characters. It is equivalent to the <code>:background</code> attribute of the <code>default</code> face. </p>   </dd> <dt><code>mouse-color</code></dt> <dd>
+<p>The color for the mouse pointer. It is equivalent to the <code>:background</code> attribute of the <code>mouse</code> face. </p>  </dd> <dt><code>cursor-color</code></dt> <dd>
+<p>The color for the cursor that shows point. It is equivalent to the <code>:background</code> attribute of the <code>cursor</code> face. </p>  </dd> <dt><code>border-color</code></dt> <dd>
+<p>The color for the border of the frame. It is equivalent to the <code>:background</code> attribute of the <code>border</code> face. </p>  </dd> <dt><code>scroll-bar-foreground</code></dt> <dd>
+<p>If non-<code>nil</code>, the color for the foreground of scroll bars. It is equivalent to the <code>:foreground</code> attribute of the <code>scroll-bar</code> face. </p>  </dd> <dt><code>scroll-bar-background</code></dt> <dd><p>If non-<code>nil</code>, the color for the background of scroll bars. It is equivalent to the <code>:background</code> attribute of the <code>scroll-bar</code> face. </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/Font-and-Color-Parameters.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Font-and-Color-Parameters.html</a>
+  </p>
+</div>