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.85  vst_setsize32                                            TOS

 Name:         »Set character cell width in arbitrary points« - Set 
               the character cell width in fractional points.

 Opcode:       252

 Syntax:       fix31 vst_setsize32 ( int16_t handle, fix31 point, 
               int16_t *chwd, int16_t *chht, int16_t *cellwd, int16_t 
               *cellht );

 Description:  The call vst_setsize32 sets the character width as a 
               fix31 fractional value in 1/65536 of a point.

                Parameter  Meaning

                handle     Workstation identifier
                point      Desired character width (in points)
                chwd       Selected character width
                chht       Selected character height
                cellwd     Selected character cell width
                cellht     Selected character cell height

               Note: A call of vst_point, vst_arbpt or vst_height 
               resets the width set by this function and the width 
               required by the relevant characters is set instead. 
               With negative widths the characters are mirrored about 
               the Y-axis.

 Return value: The function returns the set character cell width in 
               1/65536 of a point.

 Availability: As of SpeedoGDOS 4.00, and NVDI 3.00 onwards. In the 
               documentation for NVDI 3.00 this function is wrongly 
               called vst_setsize.

 Group:        Text attributes

 See Also:     Binding   vst_point   vst_height   vst_arbpt