c_getgrd - Reads a geometric mapping grid from disk

SYNTAX

#include "geompak.h"

FUNCTION c_getgrd (hname, grid)

     char               *hname;
     struct GEOGRID     *grid;

PARAMETERS

hname (input, character, length(CMLEN))

Host file from which the geometric mapping grid is read.

grid (output, GEOGRID)

A GEOGRID structure that contains the entire geometric mapping grid.

DESCRIPTION

This routine takes as input the name of the geometric mapping grid file, opens the file, reads the entire mapping grid from disk, and closes the file. This one-step operation is provided since most routines which use geometric mapping grids need the entire grid in memory while doing operations on it.

RETURN VALUE

c_getgrd() returns

     E_SUCC (0) --> successful completion
     E_FAIL (-1) --> operation failed

SPECIAL CONSIDERATIONS:

The c_getgrd() call is for C only.