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.4.6.93  v_topbot                                                 TOS

 Name:         »Set character height, absolute mode« - Set character 
               height for text output.

 Opcode:       5 (Escape 18501)

 Syntax:       void v_topbot ( int16_t handle, int16_t height, int16_t 
               *char_width, int16_t *char_height, int16_t *cell_width, 
               int16_t *cell_height );

 Description:  The call v_topbot is an alternative to vst_height. It 
               uses top to bottom distance for text scaling, instead 
               of top to baseline distance.

                Parameter  Meaning

                handle     Workstation identifier
                height     Character height
                char_width Selected character width
                char_height Selected character height
                cell_width Character cell width
                cell_height Character cell height

               Note: If the desired character height is not available, 
               the next smaller one is chosen automatically. With 
               proportional fonts, the output parameters contain the 
               width of the widest character in the font.

               Most screen drivers using this function can reduce 
               available fonts by any amount, or scale them to double 
               size. This applies in particular to the screen driver 
               implemented in ROM.

               With vector fonts, the widths output by char_width and 
               cell_width represent rounded-off values.

 Return value: The function does not return a result.

 Availability: GEM/3 Release 3.1.

 Group:        Text attributes

 See Also:     Binding   v_gtext   v_justified   vst_point 
               vst_height