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.51  vst_arbpt                                                TOS

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

 Opcode:       246

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

 Description:  The call vst_arbpt sets the current character height 
               for an outline font in printer points. The following 
               apply:

                Parameter  Meaning

                handle     Workstation identifier
                point      Desired character height
                chwd       Resulting character width
                chht       Resulting character height
                cellwd     Resulting character cell width
                cellht     Resulting character cell height

               Notes: In contrast to vst_point, the function permits 
               the scaling to any integer point size, irrespective of 
               the sizes listed in EXTEND.SYS. If you want to set a 
               fractional point size, use vst_arbpt32.

               If negative values are set, the characters will be 
               mirrored (reflected) about the X-axis.

               The returned character widths are rounded-off values, 
               which cannot be used without more ado for calculating 
               overall text widths.

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

 Availability: With FSM-GDOS, and SpeedoGDOS Version 4.00 onwards.

 Group:        Text attributes

 See Also:     Binding   vst_arbpt32   vst_point   vst_setsize 
               SpeedoGDOS   NVDI