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.53  vqt_name                                                   TOS

 Name:         »Inquire face name and index« - Obtain the name and 
               short description of a font.

 Opcode:       130

 Syntax:       int16_t vqt_name ( int16_t handle, int16_t element_num, 
               int8_t *name );

 Description:  The call vqt_name obtains the name and index of a 
               specified font face. The folowing apply:

                Parameter    Meaning

                handle       Workstation identifier
                element_num  Number of the font
                name         Name of the font as up to 32 characters 
                             long text string

               Note: The element name[32] contains the value 0 if the 
               font in question is a pixel font, and the value 1 if it 
               is an outline (vector) font (from SpeedoGDOS 4.0)

               In GEM/5, this function returns nothing for font index 
               0 or 1; for other indices, the font scaler is used to 
               return data. A good test for a GEM/5 VDI would be to do 
               a vqt_name on font 1, and see if it returned any values 
               - if it did not, GEM/5 is running.

               From NVDI 3 onwards there is an extended version of 
               this function.

 Return value: The function returns the index of the font.

 Availability: In all TOS versions, as of SpeedoGDOS 4.0 in extended 
               version.

 Group:        Inquire functions

 See Also:     Binding   vst_load_fonts   vst_name   vst_font 
               vqt_xfntinfo