## NAME

         file_to_mesh - retrieve a mesh structure from a file

## SYNOPSIS

          #include "mesh.h"

          struct mesh *file_to_mesh(char* mesh_file);

## PATH

         $CVIPHOME/GEOMETRY/warp.c

## DESCRIPTION

         This function is one of several used  to  perform  geometric
         distortion  or restoration on an image. It rettrieves a mesh
         structure from a file.

## TYPES AND CONSTANTS

         struct mesh_node {
              int x;
              int y;
         };

         struct mesh {
              int width;
              int height;
              struct mesh_node** nodes;
         };

         struct float_pair {
              float x;
              float y;
         };

## RETURN VALUES

         The file_to_mesh() returns a pointer to the  mesh  structure
         it retrieves from the file.

## EXAMPLE

          #include "mesh.h"
          #include <CVIPio.h>

          void main()
          {
              char *inputfile;
              struct mesh *inmesh;

              print_CVIP("0Input the mesh file name: ");
              inputfile = getString_CVIP();
              inmesh = file_to_mesh(inputfile);
          }

## BUGS

         None at this time

## SEE ALSO

         keyboard_to_mesh(), mesh_to_file()

## AUTHOR

         Copyright (C) 1995 SIUE - by Scott Umbaugh and Jianxin Tan.