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.8.3.3  vm_filename                                               TOS

 Name:         »Change GEM VDI file name« - Change the name of a 
               metafile.

 Opcode:       5 (Escape 100)

 Syntax:       void vm_filename ( int16_t handle, CONST int8_t 
               *filename );

 Description:  The call vm_filename renames a metafile from the 
               default GEMFILE.GEM to another name while retaining the 
               extension GEM. The following apply:

                Parameter  Meaning

                handle     Workstation identifier
                filename   New name of the metafile (NULL-terminated)

               Note: The parameter filename can also contain a path 
               name with drive identifier. If the function is not 
               called immediately after an v_opnwk call, then it will 
               have no effect. A possibly opened metafile will be 
               closed.

               As older metafile drivers (in contrast to NVDI drivers) 
               may not delete the source file "GEMFILE.GEM" which is 
               created in the current directory, the application 
               should take over this task itself.

 Return value: The function does not return a result.

 Availability: Supported by all metafile drivers.

 Group:        Metafile functions

 See Also:     Binding   GDOS   v_opnwk   Metafile format 
               sub-opcodes