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.73  vst_map_mode                                             TOS

 Name:         »Set character mapping mode« - Set the type of font 
               indexing (extended version of vst_charmap).

 Opcode:       236

 Syntax:       int16_t vst_map_mode ( int16_t handle, int16_t mode );

 Description:  The call vst_map_mode sets the type of font indexing, 
               allowing choices between standard Atari ASCII 
               interpretation of text strings, the Bitstream character 
               indices or Unicode mapping. The following apply:

                Parameter  Meaning

                handle     Workstation identifier
                mode       Mapping mode:
                            0 =     Direct mapping (WORD), i.e. no 
                                    translation of the character index
                            1 =     ASCII mapping (byte-sized)
                            2 =     Unicode mapping (WORD)

               Note: If you switch to direct mapping, the number of 
               characters per font (minADE and maxADE/vqt_fontinfo) is 
               changed to the number of really existing characters.

               If you select Unicode and if you want to determine 
               whether a certain character exists, you should call 
               vqt_width. If the index returned by vqt_width is -1, 
               the character does not exist. Instead of vqt_width you 
               can also call vqt_char_index and map the Unicode index 
               into a direct index.

 Return value: The function returns the selected mapping.

 Availability: NVDI 4.0

 Group:        Text attributes

 See Also:     Binding   vst_charmap   vqt_fontinfo   ASCII table