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.6.65  vqt_xfntinfo                                               TOS

 Name:         »Inquire extended font information« - Obtain extended 
               information about a font.

 Opcode:       229 (Opcode 0)

 Syntax:       int16_t vqt_xfntinfo ( int16_t handle, int16_t flags, 
               int16_t id, int16_t index, XFNT_INFO *info );

 Description:  The call vqt_xfntinfo obtains information about a font 
               as specified in flags. The following apply:

                Parameter  Meaning

                handle     Workstation identifier
                flags      Desired information as bit-vector:
                            Bit-0 = Return the full font name 
                                    (font_name)
                            Bit-1 = Return the name of the family 
                                    (family_name)
                            Bit-2 = Return the style name (style_name)
                            Bit-3 = Return the file name (file_name1)
                            Bit-4 = Return the 2nd optional file name 
                                    (file_name2)
                            Bit-5 = Return the 3rd optional file name 
                                    (file_name3)
                            Bit-8 = Return the available point sizes 
                                    (without enlargement) (pt_cnt, 
                                    pt_sizes)
                            Bit-9 = Return the available point sizes 
                                    (with enlargement) (pt_cnt, 
                                    pt_sizes)
                id         Font ID, or 0 for the currently set font
                index      Index of the font, or 0 if the ID is 
                           already in use
                info       Address of the information structure

               Note: If index is a non-zero value, vqt_xfntinfo 
               searches for the correspoding font and returns the 
               requested information. If index is zero, vqt_xfntinfo 
               searches for the font specified by id. If index and id 
               are zero, this function returns information about the 
               current font.

               Bit 8 and 9 of flags differ in their function only with 
               bitmap fonts. If bit 8 is set, the returned point sizes 
               are those that are present without enlargement. If bit 
               9 is set, then the returned point sizes are those that 
               are enlarged.

               Before you call this function, you have to set the 
               length of the structure in the element size.

 Return value: The function returns the requested information in a 
               XFNT_INFO structure.

 Availability: As of NVDI 3.02

 Group:        Inquire functions

 See Also:     Binding   vqt_name