Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Filevst_scratch()                                                           VDI

Syntax

VOID vst_scratch( handle, mode )
WORD handle, mode;

Function      vst_scratch() allows FSMGDOS or SpeedoGDOS to change its
              method of allocating a scratch buffer for better efficiency.

Opcode        244

Availability  Available only with FSMGDOS or SpeedoGDOS.

Parameters    handle specifies a valid workstation handle.
              mode specifies the scratch buffer allocation
              mode as follows:

              Name          mode  Meaning

              SCRATCH_BOTH    0   Scratch buffers should be allocated
                                  which are large enough for FSM/Speedo
                                  and bitmap fonts with any combination of
                                  special effects.

              SCRATCH_BITMAP  1   Scratch buffers should be allocated
                                  which are large enough for FSM/Speedo
                                  fonts with no effects and bitmap fonts
                                  with effects.

              SCRATCH_NONE    2   Scratch buffers should be allocated
                                  which are large enough for FSM/Speedo
                                  fonts and bitmap fonts with no special
                                  effects.

Binding       contrl[0] = 244;
              contrl[1] = 0;
              contrl[3] = 1;
              contrl[6] = handle;

              intin[0] = mode;

              vdi();

Comments      Atari recommends that at least mode 1 be set prior to
              a vst_load_fonts() call to prevent scratch buffer
              overruns. The size of the scratch buffer is based on the size
              of the largest point size specified in the 'EXTEND.SYS'
              file. Attempting to add effects to a character higher in
              point size than this will cause a buffer overrun.

Group         VDI FSMGDOS