diff options
author | Thomas E. Dickey <dickey@invisible-island.net> | 2022-06-06 04:14:55 -0400 |
---|---|---|
committer | Thomas E. Dickey <dickey@invisible-island.net> | 2022-06-11 11:09:55 -0400 |
commit | 04d5b339f42d90f51b9294552558fae181bc48d8 (patch) | |
tree | c58dc78f45a52f22dad127bcdb1d436ad71d02c7 | |
parent | 18c74d39dd202e385d57415007ba6e803ac6f89a (diff) |
consistently bold "Xft"
Signed-off-by: Thomas E. Dickey <dickey@invisible-island.net>
-rw-r--r-- | man/Xft.man | 88 |
1 files changed, 63 insertions, 25 deletions
diff --git a/man/Xft.man b/man/Xft.man index 6ae98d5..6ee5584 100644 --- a/man/Xft.man +++ b/man/Xft.man @@ -77,7 +77,8 @@ is a simple library which draws text and graphics: .bP using information provided by the Fontconfig library, .bP -Xft converts font glyphs using the FreeType rasterizer, and +.B Xft +converts font glyphs using the FreeType rasterizer, and .bP displays the converted font data using the X Rendering Extension. .PP @@ -125,7 +126,6 @@ version constants might be used: #endif .QE .\" I don't understand what these are for. -- BR, 2005-04-02 -.\" XFT_CORE used in xftname.c .\" XFT_XLFD used in xftname.c, xftxlfd.c .\" XFT_NMISSING used in xftcore.c, xftextent.c, xftglyphs.c, .\" xftrender.c @@ -449,10 +449,14 @@ data type is defined by the FreeType library. .SH FUNCTIONS .\" ************************************************************************* .SS "Initialization" -A typical application using Xft does not explicitly initialize the library. +A typical application using +.B Xft +does not explicitly initialize the library. That is usually done as a side-effect of opening a font. .PP -When Xft initializes, it collects information about the display, +When +.B Xft +initializes, it collects information about the display, and stores some of that information in a FontConfig pattern (essentially a collection of properties with typed values). The calling application can modify that pattern @@ -460,7 +464,8 @@ to change the library's behavior. .PP Not all of the collected information is stored in a pattern. The remainer is stored in internal data structures. -Xft makes some of that available to the application via functions. +.B Xft +makes some of that available to the application via functions. .PS \fBBool\fP \fBXftDefaultHasRender\fP ( \fBDisplay\fP *\fIdpy\fP); @@ -468,7 +473,9 @@ Xft makes some of that available to the application via functions. Obtain information about the display .I dpy if not done already, and -return true if Xft found that the display supports the X Render extension, +return true if +.B Xft +found that the display supports the X Render extension, and if it is able to find a suitable .B XRenderPictFormat (X Render's datatype which is analogous to Xlib's Visual) @@ -482,14 +489,18 @@ Obtain information about the display .I dpy if not done already, and set the Fontconfig pattern holding default properties -which Xft will use for this display. +which +.B Xft +will use for this display. .IP -Xft uses those properties initially to obtain these limits: +.B Xft +uses those properties initially to obtain these limits: .RS 10 .TP 5 XFT_MAX_GLYPH_MEMORY (maxglyphmemory). -This is the maximum amount of glyph memory for all fonts used by Xft +This is the maximum amount of glyph memory for all fonts used by +.B Xft (default: 4*1024*1024). .TP 5 XFT_MAX_UNREF_FONTS @@ -498,7 +509,8 @@ This is the maximum number of unreferenced fonts (default: 16). .RE .IP -Xft also uses these default properties in +.B Xft +also uses these default properties in .BR XftDefaultSubstitute (). .PS \fBvoid\fP \fBXftDefaultSubstitute\fP ( @@ -506,14 +518,17 @@ Xft also uses these default properties in \fBint\fP \fIscreen\fP, \fBFcPattern\fP *\fIpattern\fP); .PE -Xft fills in missing properties in the given +.B Xft +fills in missing properties in the given .I pattern using default properties for the specified display .IR dpy , e.g., as set in .BR XftDefaultSet (). .IP -Typical Xft applications use this function to help Fontconfig +Typical +.B Xft +applications use this function to help Fontconfig choose a suitable font. These properties are substituted before calling .BR FcDefaultSubstitute (): @@ -583,7 +598,8 @@ Initializes the Fontconfig library (calling .IP The \fIconfig\fP parameter is unused. .IP -Xft does not deinitialize the Fontconfig library when it is done. +.B Xft +does not deinitialize the Fontconfig library when it is done. .PS \fBFcBool\fP \fBXftInitFtLibrary\fP (\fBvoid\fP); .PE @@ -594,13 +610,15 @@ to create a library object) if it has not already been initialized. This is needed before using the FreeType library to read font data from a file. .IP -Xft calls +.B Xft +calls .BR XftInitFtLibrary () internally via .BR XftFontInfoCreate "() and" .BR XftFontOpenPattern (). .IP -Xft does not discard the library object +.B Xft +does not discard the library object (e.g., using .BR FT_Done_FreeType ()) when it is done. @@ -608,7 +626,9 @@ when it is done. \fBint\fP \fBXftGetVersion\fP (\fBvoid\fP); .PE Returns \fBXftVersion\fP, enabling an application to determine the -actual version of Xft which is in use. +actual version of +.B Xft +which is in use. .\" ************************************************************************* .SS "Opening and Matching Fonts" .PS @@ -680,7 +700,9 @@ Also used internally by the functions, .B XftFontMatch can also be used directly to determine the Fontconfig font pattern -resulting from an Xft font open request. +resulting from an +.B Xft +font open request. The .B FcPattern and @@ -903,7 +925,9 @@ data type is defined by the X11 library. \fBDrawable\fP \fIdrawable\fP); .PE .B XftDrawChange -changes the X drawable association of the existing Xft draw object +changes the X drawable association of the existing +.B Xft +draw object .I draw from its current value to .IR drawable . @@ -913,7 +937,9 @@ from its current value to \fBXftDraw\fP *\fIdraw\fP); .PE .B XftDrawDisplay -returns a pointer to the display associated with the Xft draw object +returns a pointer to the display associated with the +.B Xft +draw object .IR draw . .PP .PS @@ -921,7 +947,9 @@ returns a pointer to the display associated with the Xft draw object \fBXftDraw\fP *\fIdraw\fP); .PE .B XftDrawDrawable -returns the X drawable associated with the Xft draw object +returns the X drawable associated with the +.B Xft +draw object .IR draw . .PP .PS @@ -929,7 +957,9 @@ returns the X drawable associated with the Xft draw object \fBXftDraw\fP *\fIdraw\fP); .PE .BR XftDrawColormap () -returns the colormap associated with the Xft draw object +returns the colormap associated with the +.B Xft +draw object .IR draw . .PP .PS @@ -937,7 +967,9 @@ returns the colormap associated with the Xft draw object \fBXftDraw\fP *\fIdraw\fP); .PE .B XftDrawVisual -returns a pointer to the visual associated with the Xft draw object +returns a pointer to the visual associated with the +.B Xft +draw object .IR draw . .PP .PS @@ -945,7 +977,9 @@ returns a pointer to the visual associated with the Xft draw object \fBXftDraw\fP *\fIdraw\fP); .PE .B XftDrawPicture -returns the picture associated with the Xft draw object +returns the picture associated with the +.B Xft +draw object .IR draw . If the the X server does not support the X Rendering Extension, 0 is returned. @@ -993,7 +1027,9 @@ draws no more than .I len glyphs of .I string -to Xft drawable +to +.B Xft +drawable .I d using .I font @@ -1019,7 +1055,9 @@ and .I height at position .IR x , " y" -to Xft drawable +to +.B Xft +drawable .IR d . .SH COMPATIBILITY As of version 2, |