Return to infont.3r3l CVS log

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

Annotation of researchv10dc/630/man/src/p_man/man3/infont.3r3l, revision 1.1.1.1

1.1       root        1: .nr Hy 0
                      2: .nh
                      3: .ds ZZ DEVELOPMENT PACKAGE
                      4: .TH INFONT 3R/3L "630 MTG"
                      5: .XE "infont()"
                      6: .XE "getfont()"
                      7: .XE "outfont()"
                      8: .XE "ffree()"
                      9: .SH NAME
                     10: infont, getfont, outfont, ffree \- read a font from the UNIX Operating system
                     11: .SH SYNOPSIS
                     12: .B #include <dmd.h>
                     13: .br
                     14: .B #include <font.h>
                     15: .PP
                     16: .B Font \(**infont (inch)
                     17: .br
                     18: .B int (\(**inch)( );  
                     19: .PP
                     20: .B Font \(**getfont (file) 
                     21: .br
                     22: .B char \(**file;
                     23: .PP
                     24: .B int outfont (f, ouch) 
                     25: .br
                     26: .B Font \(**f;
                     27: .br
                     28: .B int (\(**ouch)( );
                     29: .PP
                     30: .B void ffree (f)
                     31: .br
                     32: .B Font \(**f;
                     33: .SH DESCRIPTION
                     34: The
                     35: .I infont
                     36: function
                     37: creates a Font by reading the byte-wise binary representation
                     38: returned by successive calls to
                     39: .IR inch .
                     40: .I Inch
                     41: must return successive bytes of the \s-1UNIX\s+1 system file representation
                     42: of the font, and -1
                     43: at end-of-file or on encountering an error.
                     44: .I Infont
                     45: will return 0 if memory to store the font cannot be allocated,
                     46: or if the \fIinch\fR routine returns an error.
                     47: .PP
                     48: The
                     49: .I getfont
                     50: function is a higher level form of
                     51: .I infont
                     52: which can be used by programs running under
                     53: .IR jx .
                     54: .I Getfont
                     55: returns a pointer to a Font read from the named UNIX
                     56: .IR file .
                     57: It accomplishes this by opening
                     58: .IR file ,
                     59: and then calling
                     60: .I infont
                     61: with the routine
                     62: .I getc
                     63: as an argument.
                     64: The \fIgetfont\fR function also returns 0 on error.
                     65: .PP
                     66: The
                     67: .I outfont
                     68: function calls the routine
                     69: .I ouch
                     70: to write successive bytes of the binary representation of Font
                     71: .IR \(**f .
                     72: The
                     73: .I outfont
                     74: function
                     75: returns
                     76: a \-1
                     77: on error, as must
                     78: the routine
                     79: .IR ouch .
                     80: .PP
                     81: Programs which use
                     82: .I infont
                     83: or
                     84: .I getfont
                     85: will normally want to cache the font with
                     86: \f2fontcache\f1.
                     87: .PP
                     88: The
                     89: .I ffree
                     90: function
                     91: frees the memory used by a Font allocated by
                     92: .I infont
                     93: or
                     94: .I getfont
                     95: if that font has not been added to the cache with
                     96: .IR fontcache .
                     97: Programs which add fonts to the font cache with
                     98: .I fontcache
                     99: should release the font with
                    100: .IR fontrelease .
                    101: .SH EXAMPLE
                    102: See the example for
                    103: .IR string (3R).
                    104: .SH SEE ALSO
                    105: jx(1), fontrequest(3R), fontsave(3L), structures(3R).

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