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.