Difference: GMT_VolMorph (1 vs. 4)

Revision 4
14 Dec 2023 - gmt11
Line: 1 to 1
 
META TOPICPARENT name="GMTSoftware"
Dr Graham Treece, Department of Engineering
Line: 6 to 6
 

VolMorph

For generating and visualising morphing sequences from one polygonal mesh to another. The morphing sequences are generated using maximal disc (or sphere in this case) shape-based interpolation, and triangulated using regularised marching tetrahedra. The whole process is described in detail in a technical report.

Changed:
<
<

  • Program overview
    •

  • Obtaining, installing and running VolMorph
    •

  • Output data file formats
    •

  • Command line options
    •

  • Examples
    •

  • Versions
    • >
    >
  • Program overview
    •
  • Obtaining, installing and running VolMorph
    •
  • Output data file formats
    •
  • Command line options
    •
  • Examples
    •
  • Versions
    •  

    Program overview

    Line: 135 to 124
     

    Versions

    Deleted:
    <
    <    		 Version 2.4b - March 2002
     
    Added:
    >
    >    		 Version 2.4b - March 2002
     

  • Fixed bug in binary output files for Windows version.
    • Line: 145 to 134
      Added output of spheres in OOGL or VRML format.

    Deleted:
    <
    <    		 Version 2.4 - January 2001
     
    Added:
    >
    >    		 Version 2.4 - January 2001
     

  • Compiled and tested Linux version for XFree 4.0, using Direct Rendering.
    • Line: 158 to 147
      Can now choose to output screen dumps in either PPM or BMP formats.

    Deleted:
    <
    <    		 Version 2.3 - September 2000
     
    Added:
    >
    >    		 Version 2.3 - September 2000
     

  • Can now toggle the checkered base on or off, and change the colour of the
    • Line: 170 to 159
      entered if the box is un-selected, not just on pressing .

    Deleted:
    <
    <    		 Version 2.2 - June 2000
     
    Added:
    >
    >    		 Version 2.2 - June 2000
     

  • Can now generate equation triangulation in VRML version 1.0 as well as
    • Line: 182 to 171
      .PPM files, since that seemed more useful.

    Deleted:
    <
    <    		 Version 2.1 - April 2000
     
    Added:
    >
    >    		 Version 2.1 - April 2000
     

  • Major re-write of the command / response structure to allow sensible
    • Line: 200 to 189
      Windows 95/98/NT.

    Deleted:
    <
    <    		 Version 2.0 - February 2000
     
    Added:
    >
    >    		 Version 2.0 - February 2000
     

  • First public release. Started at version 2.0 to bring it in line
    • Line: 210 to 199
     
    Revision 3
    11 Sep 2020 - gmt11
    Line: 1 to 1
     
    META TOPICPARENT name="GMTSoftware"
    Changed:
    <
    <

    Dr Graham Treece, Department of Engineering

    >
    >    		 Dr Graham Treece, Department of Engineering
     
    Changed:
    <
    <

    VolMorph v2.4b Documentation

    >
    >

    VolMorph

     

    For generating and visualising morphing sequences from one polygonal mesh to another. The morphing sequences are generated using maximal disc (or sphere in this case) shape-based interpolation, and triangulated using regularised marching tetrahedra. The whole process is described in detail in a technical report.

    Changed:
    <
    <
  • Obtaining, installing and running VolMorph
  • Program overview
  • Output data file formats
  • Command line options
  • Examples
  • Versions
    •

    Obtaining, installing and running VolMorph

    VolMorph has been compiled for several environments. If none of the binary executables below are suitable for your platform, please e-mail me - it may well be possible to compile the software for your platform.

    >
    >
  • Program overview
    •  
    Changed:
    <
    <
    >
    >
  • Obtaining, installing and running VolMorph
    •  
    Changed:
    <
    <    		 Once you have downloaded the executable, unzip it using gunzip (except for the Windows executable) - there is only a single file, which does not need a parameter file nor any environment variables. All options are passed to the program as command line parameters.
    >
    >
  • Output data file formats
    •  
    Changed:
    <
    <    		 You will also need either OpenGL or an equivalent version - the software has been implemented on Linux using Mesa, for instance. The windows are constructed using GLUT (the GL Utility Toolkit), so you will need to get a copy of that too. Both Mesa and GLUT are freely available from the internet for a wide variety of platforms. Windows users will need opengl32.dll, glu32.dll (which are installed with Windows) as well as glut32.dll which is available free from GLUT for Win32.
    >
    >
  • Command line options
    •  
    Changed:
    <
    <    		 Since OOGL models are not widely available on the internet, I have also written a utility to convert from 3DS format to OOGL, which can handle colours but not texture maps. This is a single 'C' file, which you are welcome to download and compile, though I would ask that you send me a copy if you manage to make it work better than I have! There is help available by using the '-h' command line option.
    >
    >
  • Examples
    •  
    Changed:
    <
    <
    >
    >
  • Versions
    •  
    Deleted:
    <
    <    		 Please note that VolMorph is a research tool, and is intended for research / personal use only. Whilst the author would like to think it is fairly well written, it comes with no reliability guarantees - use at your own risk!
     

    Program overview

    Line: 71 to 56
     

    The window will return to automatic vector definition mode by pressing <backspace>, and to the manual vector definition mode by pressing <backspace> again. Use <esc>, 'q' or the 'Quit' button to exit.

    Added:
    >
    >

    Obtaining, installing and running VolMorph

    VolMorph has been compiled for several environments. If none of the binary executables below are suitable for your platform, please e-mail me - it may well be possible to compile the software for your platform.

    Once you have downloaded the executable, unzip it using gunzip (except for the Windows executable) - there is only a single file, which does not need a parameter file nor any environment variables. All options are passed to the program as command line parameters.

    You will also need either OpenGL or an equivalent version - the software has been implemented on Linux using Mesa, for instance. The windows are constructed using GLUT (the GL Utility Toolkit), so you will need to get a copy of that too. Both Mesa and GLUT are freely available from the internet for a wide variety of platforms. Windows users will need opengl32.dll, glu32.dll (which are installed with Windows) as well as glut32.dll which is available free from GLUT for Win32.

    Since OOGL models are not widely available on the internet, I have also written a utility to convert from 3DS format to OOGL, which can handle colours but not texture maps. This is a single 'C' file, which you are welcome to download and compile, though I would ask that you send me a copy if you manage to make it work better than I have! There is help available by using the '-h' command line option.

    Please note that VolMorph is a research tool, and is intended for research / personal use only. Whilst the author would like to think it is fairly well written, it comes with no reliability guarantees - use at your own risk!

     

    Output data file formats

    VolMorph can output the morphing sequence in a sequence of files containing the surface triangulation, 'name###.off', or 'name###.wrl' where ### is the frame number and name is supplied by the user. The former are in OOGL format, which is suitable for use with the Geomview visualisation package, also available free for most Unix platforms. The latter are in VRML version 1.0, which can be viewed with any VRML viewer. The sphere representations can also be output as 'sphere###.sph' or 'sphere###.wrl'. The order of the vertices in each triangle is consistent, and surface normals are provided for each vertex, so the triangulation can be correctly displayed with either faceted or smooth shading.

    Line: 130 to 134
     

    Versions

    Changed:
    <
    <

    >
    >

      Version 2.4b - March 2002
    Deleted:
    <
    <
     
    Deleted:
    <
    <
  • Fixed bug in binary output files for Windows version.
    •  
    Changed:
    <
    <
  • Added output of spheres in OOGL or VRML format.
    • >
    >
  • Fixed bug in binary output files for Windows version.
    •  
    Changed:
    <
    <
    >
    >
    • Added output of spheres in OOGL or VRML format.
     
    Changed:
    <
    <

    >
    >

      Version 2.4 - January 2001
    Deleted:
    <
    <
     
    Deleted:
    <
    <
  • Compiled and tested Linux version for XFree 4.0, using Direct Rendering.
    •  
    Changed:
    <
    <
  • >
    >
  • Compiled and tested Linux version for XFree 4.0, using Direct Rendering.
    •

      Added `Cancel' button during creation of the morphed models.
    Changed:
    <
    <
  • >
    >
      Can now choose to output screen dumps in either PPM or BMP formats.
    Changed:
    <
    <

    >
    >

      Version 2.3 - September 2000
    Deleted:
    <
    <
     
    Changed:
    <
    <
  • >
    >

  •   Can now toggle the checkered base on or off, and change the colour of the
    Changed:
    <
    <    		 background. Also moved some menu options to more sensible positions.
    >
    >    		 background. Also moved some menu options to more sensible positions.
     
    Changed:
    <
    <
  • >
    >
      Changed operation of text boxes within the menus, such that new data is entered if the box is un-selected, not just on pressing .
    Changed:
    <
    <

    >
    >

      Version 2.2 - June 2000
    Deleted:
    <
    <
     
    Changed:
    <
    <
  • >
    >

  •   Can now generate equation triangulation in VRML version 1.0 as well as
    Changed:
    <
    <    		 in OOGL.
    >
    >    		 in OOGL.
     
    Changed:
    <
    <
  • >
    >
      Windows version now writes .BMP files as the screen dump rather than .PPM files, since that seemed more useful.

    Changed:
    <
    <

    >
    >

      Version 2.1 - April 2000
    Deleted:
    <
    <
     
    Changed:
    <
    <
  • >
    >

  •   Major re-write of the command / response structure to allow sensible compilation under Windows 95/98/NT. Arguments can now be set via a menu system, and diagnostic output and errors are displayed in the
    Changed:
    <
    <    		 window.
    >
    >    		 window.
     
    Changed:
    <
    <
  • >
    >
      Correspondence between surfaces can now be defined manually in 3D, in addition to being refined automatically.
    Changed:
    <
    <
  • >
    >
      Various other source only updates to allow compilation under Windows 95/98/NT.

    Changed:
    <
    <

    >
    >

      Version 2.0 - February 2000
    Deleted:
    <
    <
     
    Deleted:
    <
    <
  • First public release. Started at version 2.0 to bring it in line with the equation display software, EqnSurf.
    •  

    Changed:
    <
    <
    >
    >
  • First public release. Started at version 2.0 to bring it in line with the equation display software, EqnSurf.
    •