User's Guide

MGR2GOF

Reads an IBIS graphics file and writes the data to a GOF.

Function:

Reads an image based information system (IBIS) graphics file and writes the data to a polygon graphics overlay file.

Parameters:

INFILE
Input file. The input file is an IBIS graphics file.

OUTGOF
Output file. The output file will be a polygon GOF.

APPDFLG(YES)
Append flag. The user may specify whether or not TAB2GOF should append data records to an existing GOF. An error occurs if APPDFLG is set to no and the GOF specified already exists.


  = YES:  Append.  Append data to existing GOF.
  = NO:   Do not append.  Do not append data to 
          existing GOF.

DELFLG(YES)
Delete file. This option determines if the labeled table (LT) file is deleted or not. This file is named tem__.


  = YES:  Delete the labeled table file.
  = NO:   Do not delete the labeled table file.

Example:

  1. LAS> mgr2gof infile=in.dat outgof=out.dat appdflg=yes delflg=yes

    The polygon vertices of IN.DAT are read and written to TEM__ in a labeled table format using MGR2TAB. TEM__ is then read and appended to OUT.DAT using TAB2GOF. TEM__ is deleted using DELTAB.

Description/Algorithm:

The polygon vertices of INFILE are read and written to a labeled table file using MGR2TAB.

   Description of MGR2TAB
   ______________________

After reading the input parameters, INFILE is opened and the polygon vertices are read. These vertices are then written to the file specified in OUTFILE in a labeled table polygon format. After all the polygon vertices are written, all the files are closed and the completion message is displayed.

The polygon vertices of the labeled table file are read and written to OUTGOF using TAB2GOF.

   Description of TAB2GOF
   ______________________

TAB2GOF begins by opening the input labeled table (LT) and reading the definition records. The input labeled table consists of two files. The first contains attribute names and values while the second contains polygon data. If the file type of the LT is not a polygon type, a fatal error message is generated. If the GOF currently exists and the parameter APPDFLG is set to NO, a fatal error message is generated.

The polygon data is then read from the LT and written into the GOF. Error checking is done to ensure the number of points for polygon data does not exceed 5000.

After all records of the LT have been read and copied to the GOF, the LT file and GOF are closed, and a standard completion message is written to the user's terminal.

The labeled table file TEM__ is deleted if specified by DELFLG. Error Messages: Error messages are displayed from the called routines.

User Notes:

  1. Any changes made to the routines MGR2TAB, TAB2GOF, or DELTAB may affect the outcome of this procedure.

  2. Related module is GOF2MGR.