•  Back 
  •  Superior attributes 
  •  Index 
  •  Tree View 
  •  Cross references 
  •  Help page 
  •  Show info about hypertext 
  •  View a new file 
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.81  vst_scratch                                              TOS

 Name:         »Set scratch buffer allocation mode«

 Opcode:       244

 Syntax:       void vst_scratch ( int16_t handle, int16_t mode );

 Description:  The call vst_scratch selects the way that the scratch 
               buffer is created. The following apply:

                Parameter  Meaning

                handle     Workstation identifier
                mode       Type of buffer
                            0 =  Allocated size is large enough for 
                                 bitmap and vector fonts with any 
                                 special text effects (default)
                            1 =  Size is governed by the bitmap fonts; 
                                 one should forgo text effects for 
                                 vector fonts
                            2 =  Do not create a scratch buffer, and 
                                 forgo text effects

               Notes: The scratch buffer is used for generation of 
               text effects. As vector fonts are freely scalable, one 
               cannot allocate a unique size for the scratch buffer.

               Atari recommends that at least mode 1 is set prior to 
               vst_load_fonts to prevent scratch buffer overruns.

 Return value: This function does not return a result.

 Availability: FSM-GDOS, and SpeedoGDOS as of version 4.00.

 Group:        Text attributes

 See Also:     Binding   GDOS   SpeedoGDOS   vst_effects