NAME:
  vidinfo
 PURPOSE:   (one line only)
  Extract and return information about a video file
 DESCRIPTION:
 CATEGORY:
  Video data processing
 CALLING SEQUENCE:
  vidinfo,fn,info,error
 INPUTS:
  fn - string that contains file name (with or without path)
 OPTIONAL INPUT PARAMETERS:
 KEYWORD INPUT PARAMETERS:
 OUTPUTS:
  info - anonymous structure containing information about the video
            The following tags are provided:
     dir      - directory where data are found (not including top root)
     filename - Name of the file (no path)
     codec    - Name of the coded used for video encoding/compression
     pixfmt   - Name of the pixel encoding format
     length   - Duration of the video in seconds
     width    - pixel width of each video frame
     height   - pixel height of each video frame
     nframes  - Number of video frames in the file (provided by ffprobe)
     cframes  - Calculated number of frames (length*29.97)
     mode     - string, permissions on video file
     fjd      - JD of time of last file modification (same as mtime)
     datetime - mysql datetime string equivalent to fjd
     ctime    - File creation time (seconds from Unix reference time)
     mtime    - File last modification time (seconds from reference)
     size     - Size of the file in bytes

  error - Flag, when set indicates an error was encountered with the file

 KEYWORD OUTPUT PARAMETERS:
 COMMON BLOCKS:
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:
  2016/02/19, Written by Marc W. Buie, Southwest Research Institute