253 lines
9.1 KiB
HTML
253 lines
9.1 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of XFD</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>XFD</H1>
|
|
Section: User Commands (1)<BR>Updated: xfd 1.1.3<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>
|
|
|
|
xfd - display all the characters in an X font
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>xfd</B>
|
|
|
|
[-options ...] <B>-fn</B> <I>fontname</I>
|
|
<P>
|
|
|
|
<B>xfd</B>
|
|
|
|
[-options ...] <B>-fa</B> <I>fontname</I>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
The <I>xfd</I> utility creates a window containing the name of the font being
|
|
displayed, a row of command buttons, several lines of text for displaying
|
|
character metrics, and a grid containing one glyph per cell. The
|
|
characters are shown in increasing order from left to right, top to
|
|
bottom. The first character displayed at the top left will be character
|
|
number 0 unless the <B>-start</B> option has been supplied in which case the
|
|
character with the number given in the <B>-start</B> option will be used.
|
|
<P>
|
|
|
|
The characters are displayed in a grid of boxes, each large enough to hold
|
|
any single character in the font. Each character glyph is drawn using
|
|
the PolyText16 request (used by the <I>Xlib</I> routine <B>XDrawString16</B>)
|
|
or the XftDrawString32 routine, depending on whether the <B>-fn</B> or
|
|
<B>-fa</B> option was given.
|
|
If the <B>-box</B> option is given, a rectangle will be drawn around each
|
|
character, showing where an ImageText16 request (used by the <I>Xlib</I>
|
|
routine <B>XDrawImageString16</B>) would cause background color to be displayed.
|
|
<P>
|
|
|
|
The origin of each glyph is normally set so that the character is drawn in
|
|
the upper left hand corner of the grid cell. However, if a glyph has a
|
|
negative left bearing or an unusually large ascent, descent, or right bearing
|
|
(as is the case with <I>cursor</I> font), some character may not appear in their
|
|
own grid cells. The <B>-center</B> option may be used to force all glyphs to
|
|
be centered in their respective cells.
|
|
<P>
|
|
|
|
All the characters in the font may not fit in the window at once.
|
|
To see the next page of glyphs, press the <I>Next</I> button at the top
|
|
of the window. To see the previous page, press <I>Prev</I>. To exit <I>xfd</I>,
|
|
press <I>Quit</I>.
|
|
<P>
|
|
|
|
Individual character metrics (index, width, bearings, ascent and descent) can
|
|
be displayed at the top of the window by clicking on the desired character.
|
|
<P>
|
|
|
|
The font name displayed at the top of the window is the full name of the
|
|
font, as determined by the server. See <I>xlsfonts</I> and <I>fc-list</I>
|
|
for ways to generate lists of fonts, as well as more detailed summaries of
|
|
their metrics and properties.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<P>
|
|
|
|
<I>xfd</I>
|
|
|
|
accepts all of the standard toolkit command line options along with
|
|
the additional options listed below:
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-fn </B><I>font</I>
|
|
|
|
<DD>
|
|
This option specifies the core X server side font to be displayed.
|
|
This can also be set with
|
|
the FontGrid <B>font</B> resource. A font must be specified.
|
|
<DT id="2"><B>-fa </B><I>font</I>
|
|
|
|
<DD>
|
|
This option specifies a Xft font to be displayed. This can also be set with
|
|
the FontGrid <B>face</B> resource. A font pattern must be specified.
|
|
<DT id="3"><B>-box</B>
|
|
|
|
<DD>
|
|
This option indicates that a box should be displayed outlining the area
|
|
that would be filled with background color by an ImageText request.
|
|
This can also be set with
|
|
the FontGrid <B>boxChars</B> resource. The default is False.
|
|
<DT id="4"><B>-center</B>
|
|
|
|
<DD>
|
|
This option indicates that each glyph should be centered in its grid.
|
|
This can also be set with
|
|
the FontGrid <B>centerChars</B> resource. The default is False.
|
|
<DT id="5"><B>-start </B><I>number</I>
|
|
|
|
<DD>
|
|
This option specifies the glyph index of the upper left hand corner of the
|
|
grid. This is used to view characters at arbitrary locations in the font.
|
|
This can also be set with
|
|
the FontGrid <B>startChar</B> resource. The default is 0.
|
|
<DT id="6"><B>-bc </B><I>color</I>
|
|
|
|
<DD>
|
|
This option specifies the color to be used if ImageText boxes are drawn.
|
|
This can also be set with
|
|
the FontGrid <B>boxColor</B> resource.
|
|
<DT id="7"><B>-rows </B><I>numrows</I>
|
|
|
|
<DD>
|
|
This option specifies the number of rows in the grid.
|
|
This can also be set with
|
|
the FontGrid <B>cellRows</B> resource.
|
|
<DT id="8"><B>-columns </B><I>numcols</I>
|
|
|
|
<DD>
|
|
This option specifies the number of columns in the grid.
|
|
This can also be set with
|
|
the FontGrid <B>cellColumns</B> resource.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>WIDGETS</H2>
|
|
|
|
In order to specify resources, it is useful to know the
|
|
widgets which compose <I>xfd</I>. In the notation below, indentation
|
|
indicates hierarchical structure. The widget class name is given first,
|
|
followed by the widget instance name.
|
|
The application class name is Xfd.
|
|
<P>
|
|
<PRE>
|
|
Xfd xfd
|
|
Paned pane
|
|
Label fontname
|
|
Box box
|
|
Command quit
|
|
Command prev
|
|
Command next
|
|
Label select
|
|
Label metrics
|
|
Label range
|
|
Label start
|
|
Form form
|
|
FontGrid grid
|
|
</PRE>
|
|
|
|
<A NAME="lbAG"> </A>
|
|
<H2>FONTGRID RESOURCES</H2>
|
|
|
|
The FontGrid widget is an application-specific widget, and a subclass
|
|
of the Simple widget in the Athena widget set. The effects and
|
|
instance names of this widget's resources are given in the
|
|
<B>OPTIONS</B> section. Capitalize the first letter of the resource
|
|
instance name to get the corresponding class name.
|
|
<A NAME="lbAH"> </A>
|
|
<H2>APPLICATION SPECIFIC RESOURCES</H2>
|
|
|
|
The instance names of the application specific resources
|
|
are given below. Capitalize the first letter of the resource
|
|
instance name to get the corresponding class name.
|
|
These resources are unlikely to be interesting unless you are localizing
|
|
xfd for a different language.
|
|
<DL COMPACT>
|
|
<DT id="9"><B>selectFormat</B>
|
|
|
|
<DD>
|
|
Specifies a printf-style format string used to display information
|
|
about the selected character. The default is "character 0x%02x%02x
|
|
(%u,%u) (%#o,%#o)". The arguments that will come after the format string are
|
|
char.byte1, char.byte2, char.byte1, char.byte2, char.byte1, char.byte2.
|
|
char.byte1 is byte 1 of the selected character.
|
|
char.byte2 is byte 2 of the selected character.
|
|
<DT id="10"><B>metricsFormat</B>
|
|
|
|
<DD>
|
|
Specifies a printf-style format string used to display character
|
|
metrics. The default is "width %d; left %d, right %d; ascent %d,
|
|
descent %d (font %d, %d)". The arguments that will come after the
|
|
format string are the character metrics width, lbearing, rbearing,
|
|
character ascent, character descent, font ascent, and font descent.
|
|
<DT id="11"><B>rangeFormat</B>
|
|
|
|
<DD>
|
|
Specifies a printf-style format string used to display the range of
|
|
characters currently being displayed. The default is "range:
|
|
0x%02x%02x (%u,%u) thru 0x%02x%02x (%u,%u)". The arguments that will
|
|
come after the format string are the following fields from the
|
|
XFontStruct that is returned from opening the font:
|
|
min_byte1, min_char_or_byte2, min_byte1, min_char_or_byte2,
|
|
max_byte1, max_char_or_byte2, max_byte1, max_char_or_byte2.
|
|
<DT id="12"><B>startFormat</B>
|
|
|
|
<DD>
|
|
Specifies a printf-style format string used to display information
|
|
about the character at the upper left corner of the font grid. The
|
|
default is "upper left: 0x%04x (%d,%d)". The arguments that will come
|
|
after the format string are the new character, the high byte of the new
|
|
character, and the low byte of the new character.
|
|
<DT id="13"><B>nocharFormat</B>
|
|
|
|
<DD>
|
|
Specifies a printf-style format string to display when the selected
|
|
character does not exist. The default is "no such character
|
|
0x%02x%02x (%u,%u) (%#o,%#o)". The arguments that will come after the
|
|
format string are the same as for the <B>selectFormat</B> resource.
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?7+X">X</A>(7), <A HREF="/cgi-bin/man/man2html?1+xlsfonts">xlsfonts</A>(1), <A HREF="/cgi-bin/man/man2html?1+xrdb">xrdb</A>(1), <A HREF="/cgi-bin/man/man2html?1+xfontsel">xfontsel</A>(1), <A HREF="/cgi-bin/man/man2html?1+fc-list">fc-list</A>(1),
|
|
<A HREF="/cgi-bin/man/man2html?5+fonts.conf">fonts.conf</A>(5),
|
|
<I>X Logical Font Description Conventions</I>
|
|
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
The program should skip over pages full of non-existent characters.
|
|
<A NAME="lbAK"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Jim Fulton, MIT X Consortium; previous program of the same name by
|
|
Mark Lillibridge, MIT Project Athena.
|
|
<P>
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="14"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="15"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="16"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="17"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="18"><A HREF="#lbAF">WIDGETS</A><DD>
|
|
<DT id="19"><A HREF="#lbAG">FONTGRID RESOURCES</A><DD>
|
|
<DT id="20"><A HREF="#lbAH">APPLICATION SPECIFIC RESOURCES</A><DD>
|
|
<DT id="21"><A HREF="#lbAI">SEE ALSO</A><DD>
|
|
<DT id="22"><A HREF="#lbAJ">BUGS</A><DD>
|
|
<DT id="23"><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>
|