285 lines
9.2 KiB
HTML
285 lines
9.2 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of XFONTSEL</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>XFONTSEL</H1>
|
|
Section: User Commands (1)<BR>Updated: xfontsel 1.0.6<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
xfontsel - point and click selection of X11 font names
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNTAX</H2>
|
|
|
|
<P>
|
|
|
|
<B>xfontsel</B> [-<I>toolkitoption</I> ...]
|
|
[<B>-pattern </B><I>fontname</I>]
|
|
[<B>-print</B>]
|
|
[<B>-sample </B><I>text</I>]
|
|
[<B>-sample16 </B><I>text16</I>]
|
|
[<B>-sampleUCS </B><I>textUCS</I>]
|
|
[<B>-scaled</B>]
|
|
<P>
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<P>
|
|
|
|
The <I>xfontsel</I> application provides a simple way to display
|
|
the fonts known to your X server, examine samples of each, and
|
|
retrieve the X Logical Font Description ("XLFD") full name for a font.
|
|
<P>
|
|
|
|
If <B>-pattern</B> is not specified, all fonts with XLFD 14-part
|
|
names will be selectable. To work with only a subset of the
|
|
fonts, specify <B>-pattern</B> followed by a partially or fully
|
|
qualified font name; e.g., ``-pattern *medium*'' will
|
|
select that subset of fonts which contain the string ``medium''
|
|
somewhere in their font name. Be careful about escaping
|
|
wildcard characters in your shell.
|
|
<P>
|
|
|
|
If <B>-print</B> is specified on the command line the selected
|
|
font specifier will be written to standard output when the <I>quit</I>
|
|
button is activated. Regardless of whether or not <B>-print</B> was
|
|
specified, the font specifier may be made the PRIMARY (text)
|
|
selection by activating the <I>select</I> button.
|
|
<P>
|
|
|
|
The <B>-sample</B> option specifies the sample text to be used to
|
|
display the selected font if the font is linearly indexed,
|
|
overriding the default.
|
|
<P>
|
|
|
|
The <B>-sample16</B> option specifies the sample text to be used to
|
|
display the selected font if the font is matrix encoded,
|
|
overriding the default.
|
|
<P>
|
|
|
|
The <B>-sampleUCS</B> option specifies the sample text encoded in the UTF-8
|
|
form to be used to display the selected font if the font has a
|
|
CHARSET_REGISTRY of ISO10646, overriding the default.
|
|
<P>
|
|
|
|
The <B>-scaled</B> option enables the ability to select scaled fonts
|
|
at arbitrary pixel or point sizes.
|
|
<P>
|
|
|
|
<A NAME="lbAE"> </A>
|
|
<H2>INTERACTIONS</H2>
|
|
|
|
<P>
|
|
|
|
Clicking any pointer button in one of the XLFD field names will pop up
|
|
a menu of the currently-known possibilities for that field. If
|
|
previous choices of other fields were made, only values
|
|
for fonts which matched the previously selected fields will be
|
|
selectable; to make other values selectable, you must deselect
|
|
some other field(s) by choosing the ``*'' entry in that field.
|
|
Unselectable values may be omitted from the menu entirely as
|
|
a configuration option; see the <B>ShowUnselectable</B> resource, below.
|
|
Whenever any change is made to a field value, <I>xfontsel</I> will
|
|
assert ownership of the PRIMARY_FONT selection. Other applications
|
|
(see, e.g., <I>xterm</I>) may then retrieve the selected font specification.
|
|
<P>
|
|
|
|
Scalable fonts come back from the server with zero for the pixel size,
|
|
point size, and average width fields. Selecting a font name with a
|
|
zero in these positions results in an implementation-dependent size.
|
|
Any pixel or point size can be selected to scale the font to a particular
|
|
size. Any average width can be selected to anamorphically scale the font
|
|
(although you may find this challenging given the size of the average
|
|
width menu).
|
|
<P>
|
|
|
|
Clicking the left pointer button in the <I>select</I> widget will
|
|
cause the currently selected font name to become the PRIMARY text
|
|
selection as well as the PRIMARY_FONT selection.
|
|
This then allows you to paste the string into other
|
|
applications. The <B>select</B> button remains
|
|
highlighted to remind you of this fact, and de-highlights when
|
|
some other application takes the PRIMARY selection away. The
|
|
<I>select</I> widget is a toggle; pressing it when it is highlighted
|
|
will cause <I>xfontsel</I> to release the selection ownership and
|
|
de-highlight the widget. Activating the <I>select</I> widget twice
|
|
is the only way to cause <I>xfontsel</I> to release the
|
|
PRIMARY_FONT selection.
|
|
<P>
|
|
|
|
<A NAME="lbAF"> </A>
|
|
<H2>RESOURCES</H2>
|
|
|
|
<P>
|
|
|
|
The application class is <B>XFontSel</B>. Most of the user-interface
|
|
is configured in the app-defaults file; if this file is missing
|
|
a warning message will be printed to standard output and the
|
|
resulting window will be nearly incomprehensible.
|
|
<P>
|
|
|
|
Most of the significant parts of the widget hierarchy are documented
|
|
in
|
|
<I>/etc/X11/app-defaults/XFontSel</I>,
|
|
|
|
<P>
|
|
|
|
Application specific resources:
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>cursor (</B>class<B> Cursor)</B>
|
|
|
|
<DD>
|
|
Specifies the cursor for the application window.
|
|
<DT id="2"><B>pattern (</B>class<B> Pattern)</B>
|
|
|
|
<DD>
|
|
Specifies the font name pattern for selecting a subset of
|
|
available fonts. Equivalent to the <B>-pattern</B> option.
|
|
Most useful patterns will contain at least one field
|
|
delimiter; e.g. ``*-m-*'' for monospaced fonts.
|
|
<DT id="3"><B>pixelSizeList (</B>class<B> PixelSizeList)</B>
|
|
|
|
<DD>
|
|
Specifies a list of pixel sizes to add to the pixel size menu,
|
|
so that scalable fonts can be selected at those pixel sizes.
|
|
The default pixelSizeList contains 7, 30, 40, 50, and 60.
|
|
<DT id="4"><B>pointSizeList (</B>class<B> PointSizeList)</B>
|
|
|
|
<DD>
|
|
Specifies a list of point sizes (in units of tenths of points) to add to
|
|
the point size menu, so that scalable fonts can be selected at those
|
|
point sizes. The default pointSizeList contains 250, 300, 350, and 400.
|
|
<DT id="5"><B>printOnQuit (</B>class<B> PrintOnQuit)</B>
|
|
|
|
<DD>
|
|
If <I>True</I> the currently selected font name is printed
|
|
to standard output when the quit button is activated.
|
|
Equivalent to the <B>-print</B> option.
|
|
<DT id="6"><B>sampleText (</B>class<B> Text)</B>
|
|
|
|
<DD>
|
|
The sample 1-byte text to use for linearly indexed fonts.
|
|
Each glyph index is a single byte, with newline separating lines.
|
|
<DT id="7"><B>sampleText16 (</B>class<B> Text16)</B>
|
|
|
|
<DD>
|
|
The sample 2-byte text to use for matrix-encoded fonts.
|
|
Each glyph index is two bytes, with a 1-byte newline separating lines.
|
|
<DT id="8"><B>scaledFonts (</B>class<B> ScaledFonts)</B>
|
|
|
|
<DD>
|
|
If <I>True</I> then selection of arbitrary pixel and point sizes for
|
|
scalable fonts is enabled.
|
|
</DL>
|
|
<P>
|
|
|
|
Widget specific resources:
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="9"><B>showUnselectable (</B>class<B> ShowUnselectable)</B>
|
|
|
|
<DD>
|
|
Specifies, for each field menu, whether or not to show values that
|
|
are not currently selectable, based upon previous field selections.
|
|
If shown, the unselectable values are clearly identified as such
|
|
and do not highlight when the pointer is moved down the menu.
|
|
The full name of this resource is <B>fieldN.menu.options.showUnselectable</B>,
|
|
class <B>MenuButton.SimpleMenu.Options.ShowUnselectable</B>;
|
|
where N is replaced with the field
|
|
number (starting with the left-most field numbered 0).
|
|
The default is True for all but field 11 (average width of characters
|
|
in font) and False for field 11. If you never want to see
|
|
unselectable entries, '*menu.options.showUnselectable:False' is
|
|
a reasonable thing to specify in a resource file.
|
|
</DL>
|
|
<P>
|
|
|
|
<A NAME="lbAG"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<P>
|
|
|
|
<BR> $XFILESEARCHPATH/XFontSel
|
|
<P>
|
|
|
|
<A NAME="lbAH"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?1+xrdb">xrdb</A>(1), <A HREF="/cgi-bin/man/man2html?1+xfd">xfd</A>(1)
|
|
<P>
|
|
|
|
<A NAME="lbAI"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
<P>
|
|
|
|
Sufficiently ambiguous patterns can be misinterpreted and lead to an
|
|
initial selection string which may not correspond to what the user intended
|
|
and which may cause the initial sample text output to fail to match
|
|
the proffered string. Selecting any new field value will correct the
|
|
sample output, though possibly resulting in no matching font.
|
|
<P>
|
|
|
|
Should be able to return a FONT for the PRIMARY selection, not
|
|
just a STRING.
|
|
<P>
|
|
|
|
Any change in a field value will cause <I>xfontsel</I> to assert
|
|
ownership of the PRIMARY_FONT selection. Perhaps this should
|
|
be parameterized.
|
|
<P>
|
|
|
|
When running on a slow machine, it is possible for the user to
|
|
request a field menu before the font names have been completely
|
|
parsed. An error message indicating a missing menu is printed
|
|
to stderr but otherwise nothing bad (or good) happens.
|
|
<P>
|
|
|
|
The average-width menu is too large to be useful.
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>COPYRIGHT</H2>
|
|
|
|
Copyright 1989, 1991, X Consortium
|
|
<P>
|
|
|
|
See <I><A HREF="/cgi-bin/man/man2html?7+X">X</A>(7)</I> for a full statement of rights and permissions.
|
|
<A NAME="lbAK"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
<P>
|
|
|
|
Ralph R. Swick, Digital Equipment Corporation/MIT Project Athena
|
|
<P>
|
|
|
|
Mark Leisher <<A HREF="mailto:mleisher@crl.nmsu.edu">mleisher@crl.nmsu.edu</A>> added the support for the UTF-8 sample
|
|
text.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="10"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="11"><A HREF="#lbAC">SYNTAX</A><DD>
|
|
<DT id="12"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="13"><A HREF="#lbAE">INTERACTIONS</A><DD>
|
|
<DT id="14"><A HREF="#lbAF">RESOURCES</A><DD>
|
|
<DT id="15"><A HREF="#lbAG">FILES</A><DD>
|
|
<DT id="16"><A HREF="#lbAH">SEE ALSO</A><DD>
|
|
<DT id="17"><A HREF="#lbAI">BUGS</A><DD>
|
|
<DT id="18"><A HREF="#lbAJ">COPYRIGHT</A><DD>
|
|
<DT id="19"><A HREF="#lbAK">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:30 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|