c_readgrid - Read a geometric mapping grid from a file

SYNTAX

#include "grid.h"

FUNCTION c_readgrid (hostname, grid)

    char *hostname;
    struct GRID *grid;

PARAMETERS

hostname (char *, input)

Host file name of a geometric mapping grid file. The specified file must be a label services file created by c_wrtgrid().

grid (struct GRID *, output)

Geometric mapping grid structure that will be filled with the information contained in hostname.

DESCRIPTION

Read a geometric mapping grid from a label services file. If the grid structure being passed to this function already contains a grid, c_freegrid() should be called prior to calling this function to avoid any memory leaks.

RETURN VALUE

c_readgrid() returns

    E_SUCC --> Successful completion.
    E_FAIL --> Operation failed.