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-Filevm_filename()                                                           VDI

Syntax

VOID vm_filename( handle, fname )
WORD handle;
char *fname;

Function      vm_filename() allows specfying a user-defined filename for
              metafile output.

Opcode        5

Sub-Opcode    100

Availability  Supported by all metafile drivers.

Parameters    handle specifys a valid workstation handle. fname points to
              a NULL-terminated GEMDOS filename which all metafile output
              should be redirected to.

Binding       WORD i = 0;

              while(intin[i++] = (WORD)*fname++);

              contrl[0] = 5;
              contrl[1] = 0;
              contrl[3] = --i;
              contrl[5] = 100;
              contrl[6] = handle;

              vdi();

Caveats       When a metafile is opened, the default file 'GEMFILE.GEM' is
              created in the current GEMDOS path on the current drive and
              is not deleted as a result of this call. You will need to
              manually delete it yourself.

Comments      This call should be made immediately after a v_opnwk() to
              a metafile handle if you wish to use an alternate filename
              to prevent data from being lost.

Group         VDI Metafile Escapes