Return to fontsave.3l CVS log

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

Annotation of researchv10dc/630/man/src/p_man/man3/fontsave.3l, revision 1.1

1.1     ! root        1: .ds ZZ DEVELOPMENT PACKAGE
        !             2: .TH FONTSAVE 3L "630 MTG"
        !             3: .XE "fontcache()"
        !             4: .XE "fontsave()"
        !             5: .XE "fontremove()"
        !             6: .SH NAME
        !             7: fontsave, fontcache, fontremove \- save/remove a font from the cache
        !             8: .SH SYNOPSIS
        !             9: .B #include <dmd.h>
        !            10: .br
        !            11: .B #include <font.h>
        !            12: .sp
        !            13: .B int fontcache (fname, f)
        !            14: .sp
        !            15: .B Font *fontsave (fname, f)
        !            16: .sp
        !            17: .B void fontremove (fname)
        !            18: .sp
        !            19: .B char \(**fname;
        !            20: .br
        !            21: .B Font \(**f;
        !            22: .SH DESCRIPTION
        !            23: .I Fname
        !            24: points to a font name,
        !            25: a null terminated string of up to 14 characters.
        !            26: .PP
        !            27: The
        !            28: .I fontsave
        !            29: and
        !            30: .I fontcache
        !            31: functions put the given font into the font cache
        !            32: and give it the name
        !            33: .IR fname .
        !            34: Once the font is in the cache, any other
        !            35: process within the terminal can use it by calling
        !            36: .IR fontrequest .
        !            37: .PP
        !            38: The 
        !            39: .I fontcache
        !            40: function expects
        !            41: the given font to be already in allocated memory through calls to
        !            42: \fIalloc\fR and \fIgcalloc\fR.
        !            43: This function also does a  \fIfontrequest\fR for the
        !            44: calling application. If the caching or subsequent
        !            45: request fails, \fIfontcache\fR will return a 0; otherwise,
        !            46: a 1 is returned on success. Note that once
        !            47: the font is put into
        !            48: the cache, the font should only be freed by calling
        !            49: .IR fontremove .
        !            50: .PP
        !            51: The
        !            52: .I fontsave
        !            53: function is used to cache fonts not in
        !            54: memory allocated through calls to \fIalloc\fR and \fIgcalloc\fR. 
        !            55: \fIFontsave\fR first attempts to allocate
        !            56: memory, then duplicates the given font into the allocated memory, and
        !            57: finally calls 
        !            58: .I fontcache
        !            59: to cache the newly created font.
        !            60: On success, \fIfontsave\fR returns the pointer to the new font.
        !            61: If it cannot allocate enough memory for the creation of the new font,
        !            62: of if \fIfontcache\fR fails, \fIfontsave\fR will return a null pointer.
        !            63: .PP
        !            64: The
        !            65: .I fontremove
        !            66: function removes the named font from the cache and frees its memory.
        !            67: A request to remove a font that is currently requested by some other
        !            68: process will be ignored.
        !            69: .SH SEE ALSO
        !            70: alloc(3R), fontname(3R), fontrequest(3R), gcalloc(3R), infont(3R/3L),
        !            71: structures(3R).

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