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

 Name:         »Set character cell height in arbitrary points« - Set 
               the character cell height in points for an outline 
               font.

 Opcode:       246

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

 Description:  The call vst_arbpt32 sets the current character height 
               for an outline font in printer points, and can include 
               fractional sizes. 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 
               permitsthe scaling to any point size, irrespective of 
               the values listed in EXTEND.SYS.

               If negative values are set, the characters will be 
               mirrorred (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 actually set 
               in 1/65536 of a point.

               This is not clear from the SpeedoGDOS documentation. 
               It's possible that only the character height in points 
               is returned.

 Availability: With FSM-GDOS, SpeedoGDOS as of Version 4.00, and NVDI 
               3.00 onwards. In the documentation for NVDI 3.00 this 
               function is wrongly called vst_arbpt.

 Group:        Text attributes

 See Also:     Binding   vst_point   vst_setsize   SpeedoGDOS   NVDI