166 lines
5.5 KiB
HTML
166 lines
5.5 KiB
HTML
<HTML><HEAD><TITLE>Tk Built-In Commands - font manual page</TITLE></HEAD>
|
||
<BR>
|
||
<BODY bgcolor = #c3c3ff>
|
||
<H2><IMG ALIGN=BOTTOM SRC="./Img/ManPageBlue.gif"> font</H2>
|
||
<I>Create and inspect fonts.</I><P><IMG ALIGN=TOP SRC="./Img/line-red.gif">
|
||
<H3><A NAME="M2">SYNOPSIS</A></H3>
|
||
(<B>font</B><I> option </I>?<I>arg arg ...</I>?)<BR>
|
||
<H3><A NAME="M3">DESCRIPTION</A></H3>
|
||
The <B>font</B> procedure provides several facilities for dealing with
|
||
fonts, such as defining named fonts and inspecting the actual attributes of
|
||
a font. The procedure has several different forms, determined by the
|
||
first argument. The following forms are currently supported:
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M4">(<B>font 'actual </B><I>font</I> {? B:displayof} { Iwindow R?} {? Ioption R?)}</A><DD>
|
||
</DL>
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M5">(<B>font 'configure </B><I>fontname</I> ?<I>option</I>? ?<I>value option value ...</I>?)</A><DD>
|
||
</DL>
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M6">(<B>font 'create</B> ?<I>fontname</I>? ?<I>option value ...</I>?)</A><DD>
|
||
</DL>
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M7">(<B>font 'delete</B> <I>fontname</I> ?<I>fontname ...</I>?)</A><DD>
|
||
</DL>
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M8">(<B>font 'families</B>)</A><DD>
|
||
<DT><A NAME="M9">(<B>font 'families</B> { B:displayof} { Iwindow R?)}</A><DD>
|
||
</DL>
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M10">(<B>font 'measure </B><I>font</I> {? B:displayof} { Iwindow R?} { Itext R)}</A><DD>
|
||
</DL>
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M11">(<B>font 'metrics </B><I>font</I> {? B:displayof} { Iwindow R?} {? Ioption R?)}</A><DD>
|
||
</DL>
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M12">(<B>font 'names</B>)</A><DD>
|
||
The return value is a list of all the named fonts that are currently defined.
|
||
<P>
|
||
</DL>
|
||
<H3><A NAME="M13">FONT DESCRIPTION</A></H3>
|
||
The following formats are accepted as a font description anywhere
|
||
<I>font</I> is specified as an argument above; these same forms are also
|
||
permitted when specifying the <B>:font</B> option for widgets.
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M14">{[1]} <I>fontname</I></A><DD>
|
||
</DL>
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M15">{[2]} <I>systemfont</I></A><DD>
|
||
</DL>
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M16">{[3]} <I>family </I>?<I>size</I>? ?<I>style</I>? ?<I>style ...</I>?</A><DD>
|
||
</DL>
|
||
<UL>
|
||
<PRE><B>normal bold roman italic
|
||
underline overstrike</B></PRE>
|
||
</UL>
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M17">{[4]} X-font names (XLFD)</A><DD>
|
||
</DL>
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M18">{[5]} <I>option value </I>?<I>option value ...</I>?</A><DD>
|
||
</DL>
|
||
<P>
|
||
When font description <I>font</I> is used, the system attempts to parse the
|
||
description according to each of the above five rules, in the order specified.
|
||
Cases [1] and [2] must match the name of an existing named font or of a
|
||
system font. Cases [3], [4], and [5] are accepted on all
|
||
platforms and the closest available font will be used. In some situations
|
||
it may not be possible to find any close font (e.g., the font family was
|
||
a garbage value); in that case, some system-dependant default font is
|
||
chosen. If the font description does not match any of the above patterns,
|
||
an error is generated.
|
||
<H3><A NAME="M19">FONT METRICS</A></H3>
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M20"><B>:ascent </B></A><DD>
|
||
</DL>
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M21"><B>:descent </B></A><DD>
|
||
</DL>
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M22"><B>:linespace</B></A><DD>
|
||
</DL>
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M23"><B>:fixed </B></A><DD>
|
||
</DL>
|
||
<H3><A NAME="M24">FONT OPTIONS</A></H3>
|
||
The following options are supported on all platforms, and are used when
|
||
constructing a named font or when specifying a font using style [5] as
|
||
above:
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M25"><B>:family </B><I>name</I></A><DD>
|
||
</DL>
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M26"><B>:size </B><I>size</I></A><DD>
|
||
</DL>
|
||
<UL>
|
||
<P>
|
||
Sizes should normally be specified in points so the application will remain
|
||
the same ruler size on the screen, even when changing screen resolutions or
|
||
moving scripts across platforms. However, specifying pixels is useful in
|
||
certain circumstances such as when a piece of text must line up with respect
|
||
to a fixed-size bitmap. The mapping between points and pixels is set when
|
||
the application starts, based on properties of the installed monitor, but it
|
||
can be overridden by calling <B>(tk-state 'scaling)</B>.
|
||
</UL>
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M27"><B>:weight </B><I>weight</I></A><DD>
|
||
</DL>
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M28"><B>:slant </B><I>slant</I></A><DD>
|
||
The amount the characters in the font are slanted away from the
|
||
vertical. Valid values for slant are <B>roman</B> and <B>italic</B>.
|
||
A roman font is the normal, upright appearance of a font, while
|
||
an italic font is one that is tilted some number of degrees from upright.
|
||
The closest available slant to the one specified will be chosen.
|
||
The default slant is <B>roman</B>.
|
||
<P>
|
||
<DT><A NAME="M29"><B>:underline </B><I>boolean</I></A><DD>
|
||
The value is a boolean flag that specifies whether characters in this
|
||
font should be underlined. The default value for underline is <B>#f</B>.
|
||
<P>
|
||
<DT><A NAME="M30"><B>:overstrike </B><I>boolean</I></A><DD>
|
||
The value is a boolean flag that specifies whether a horizontal line should
|
||
be drawn through the middle of characters in this font. The default value
|
||
for overstrike is <B>#f</B>.
|
||
|
||
<P>
|
||
</DL>
|
||
<H3><A NAME="M31">PLATFORM-SPECIFIC ISSUES</A></H3>
|
||
The following named system fonts are supported:
|
||
<P>
|
||
<DL>
|
||
<DT><A NAME="M32">X Windows:</A><DD>
|
||
All valid X font names, including those listed by xlsfonts(1), are available.
|
||
<P>
|
||
<DT><A NAME="M33">MS Windows:</A><DD>
|
||
<PRE><B>system ansi device
|
||
systemfixed ansifixed oemfixed</B></PRE>
|
||
<DT><A NAME="M34">Macintosh:</A><DD>
|
||
<PRE><B>system application</B></PRE>
|
||
</DL>
|
||
<P><IMG ALIGN=TOP SRC="./Img/line-red.gif"><P>
|
||
<A HREF=./STk-hlp.html><IMG ALIGN=BOTTOM SRC="./Img/RefBookBlue.gif"> Back to the <B>STk</B> main page</A>
|
||
</BODY></HTML>
|