Syntax

[C/C++:]
void gSetDeviceFilename(char filename[], int ntype);

[F90:]
subroutine gSetDeviceFilename(filename,ntype)

character*(*), intent(in) :: filename
integer, intent(in) :: ntype

Arguments

filename
File name to be used for graphical output

ntype
Additional configuration/format information in connection with file

> 0,

Not used

= 0,	Unformatted output (default)

= -1,

Formatted 80 character records

= -2,

Expanded Ascii codes

= -3,

Expanded Octal codes

= -4,

Expanded Decimal codes

= -5,

Expanded Hex codes

Description

The routine gSetDeviceFilename() specifies an output file name and optional format for the graphics output to be sent to. This only applies to metafile and plotter devices and some graphics terminals as it is not possible to re-direct output from windowing devices.

Omitting to use gSetDeviceFilename() will result in device output being directed to a default output source which for most devices is a file called xxxxxx.OUT where xxxxx is the nomination routine name. Whether the default output source is used or that specified by this routine, an internal file unit is used for the output.

This routine may only be called after a device has been nominated and before the start of the first picture.

See Also

gSetDeviceFilename Usage
Machine Implementations
Device Drivers

---