Return to fontrequest.3r CVS log

Up to [Research Unix] / researchv10dc / 630 / man / src / p_man / man3

Annotation of researchv10dc/630/man/src/p_man/man3/fontrequest.3r, revision 1.1.1.1

1.1       root        1: .ds ZZ DEVELOPMENT PACKAGE
                      2: .TH FONTREQUEST 3R "630 MTG"
                      3: .XE "fontrequest()"
                      4: .XE "fontrelease()"
                      5: .XE "fontavail()"
                      6: .SH NAME
                      7: fontrequest, fontrelease, fontavail \- request/release use of a font
                      8: .SH SYNOPSIS
                      9: .B #include <dmd.h>
                     10: .br
                     11: .B #include <font.h>
                     12: .sp
                     13: .B Font \(**fontrequest (fname)
                     14: .sp
                     15: .B void fontrelease (fname)
                     16: .sp
                     17: .B Font \(**fontavail (fname)
                     18: .sp
                     19: .B char \(**fname;
                     20: .SH DESCRIPTION
                     21: .I Fname
                     22: points to a font name,
                     23: a null terminated string of up to 14 characters.
                     24: .PP
                     25: The
                     26: .I fontrequest
                     27: function returns a pointer to a font of the given name in the font cache.
                     28: This routine will return 0 if one of the following conditions is true:
                     29: .IP "-" 
                     30: there is no font of the given name in the cache,
                     31: .IP "-"
                     32: there is no more memory to attach the
                     33: request information to the font,
                     34: .IP "-"
                     35: the calling process has already
                     36: requested the named font.
                     37: .PP
                     38: While the font is requested, no 
                     39: process can remove it from the cache until it is released.
                     40: .PP
                     41: The
                     42: .I fontrelease
                     43: function tells the cache that the named font is no longer being
                     44: used by the calling process. This is automatically done
                     45: for all the fonts that a process has requested when that
                     46: process exits or is deleted.
                     47: .PP
                     48: The
                     49: .I fontavail
                     50: function returns a pointer to the named font if it is in
                     51: the font cache; 0, otherwise. This function is used
                     52: only to check if a given font is in the cache, and it cannot
                     53: substitute for \fIfontrequest\fR if the application intends
                     54: to make use of the font.
                     55: 
                     56: .SH SEE ALSO
                     57: fontname(3R), fontsave(3L), infont(3R/3L), structures(3R).

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.