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.77  vst_point                                                TOS

 Name:         »Set character height, points mode« - Set the character 
               cell size for text output.

 Opcode:       107

 Syntax:       int16_t vst_point ( int16_t handle, int16_t point, 
               int16_t *char_width, int16_t *char_height, int16_t 
               *cell_width, int16_t *cell_height );

 Description:  The call vst_point sets the character cell size, i.e. 
               the distance between two baselines, in points (1/72"). 
               The following apply:

                Parameter    Meaning

                handle       Workstation identifier
                point        Requested character cell height (points)
                char_width   Selected character width
                char_height  Selected character height
                cell_width   Selected character cell width
                cell_height  Selected character cell height

               The sizes are measured in points, each of which is 1/72 
               inch or roughly 0.353mm.

               Note: Should the desired character height not be 
               available, the next smaller one will be chosen. With 
               proportional fonts, the maximum possible values are 
               returned for width and height.

               If the font is a vector font, only predefined heights 
               can be selected (usually 8, 9, 10, 11, 12, 14, 18, 24, 
               36, and 48 pt).

               Warning: The screen driver in ROM can scale each of the 
               available fonts to double size, so that it is not 
               possible without further ado to differentiate between 
               fonts that have been scaled and those actually present. 
               One can help oneself here by using a routine that can 
               locate all present point sizes, as, when a wrong size 
               is specified, vst_point selects the next smallest 
               available size; if one finds with this method that all 
               point sizes are present, then we are evidently dealing 
               with a vector font.

 Return value: The function returns the character cell height in 
               points.

 Availability: Supported by all drivers.

 Group:        Text attributes

 See Also:     Binding   v_gtext   v_justified   vst_height