Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File7.10.45  vst_ex_load_fonts                                         TOS

 Name:         »Load fonts« - Extended version of additional font 
               loading routine.

 Opcode:       119

 Syntax:       int16_t vst_ex_load_fonts ( int16_t handle, int16_t 
               select, int16_t font_max, int16_t font_free );

 Description:  The call vst_ex_load_fonts is an extension of the 
               existing vst_load_fonts call, with two additional input 
               arguments to provide control over font paging memory. 
               The current defaults in units of paragraphs are:

                                 font_max     font_free
               For screens:     5120 (80K)         0
               For printers:      32767       640 (10K)

               The GDOS attempts to allocate font_max paragraphs or 
               all of available menory (whichever is smaller) less 
               font_free paragraphs, and use this amount for font 
               paging.

               Depending on your needs, you can use either version of 
               this call. Note that both version use the same opcode.

                Parameter  Meaning

                handle     Workstation identifier
                select     Reserved, should be 0
                font_max   Maximum number of paragraphs to allocate
                font_free  Minimum number of paragraphs to leave free

 Return value: The number of loaded fonts.

 Availability: GEM/3 Release 3.1

 Group:        Control functions

 See Also:     Binding   vst_unload_fonts   vst_font   vqt_name 
               ASSIGN.SYS file   GDOS