1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/libs/openctm/README.txt	Thu Sep 26 04:47:05 2013 +0300
     1.3 @@ -0,0 +1,152 @@
     1.4 +1. INTRODUCTION
     1.5 +===============
     1.6 +
     1.7 +Welcome to OpenCTM!
     1.8 +
     1.9 +OpenCTM is a file format, a software library and a tool set for compression of
    1.10 +3D triangle meshes. The geometry is compressed to a fraction of comparable file
    1.11 +formats (3DS, STL, COLLADA, VRML...), and the format is easily accessible
    1.12 +through a simple, portable API.
    1.13 +
    1.14 +The library is written in portable C (C99), and should compile nicely on any
    1.15 +32/64-bit system regardless of endianity (big endian or little endian).
    1.16 +
    1.17 +
    1.18 +2. LICENSE
    1.19 +==========
    1.20 +
    1.21 +The OpenCTM API and the OpenCTM tools are released under the zlib/libpng
    1.22 +license (see LICENSE.txt).
    1.23 +
    1.24 +3. CREDITS
    1.25 +==========
    1.26 +
    1.27 +Many people have helped out in the development process of OpenCTM, with
    1.28 +valuable feedback, programming efforts, test models and conceptual ideas.
    1.29 +Also, OpenCTM relies heavily on many other open source projects.
    1.30 +
    1.31 +Here is an incomplete list of persons that deserve credit:
    1.32 +
    1.33 +- Igor Pavlov (LZMA library)
    1.34 +- Jonas Innala (COLLADA importer, Maya exporter plugin)
    1.35 +- Ilian Dinev (help with the OpenCTM file format design and the LWO loader)
    1.36 +- Lee Thomason (TinyXML)
    1.37 +- Diego Nehab (RPly - for loading PLY files)
    1.38 +- Lev Povalahev, Marcelo E. Magallon, Milan Ikits (GLEW)
    1.39 +- Thomas G. Lane, Guido Vollbeding (libjpeg)
    1.40 +- Jean-loup Gailly, Mark Adler (zlib)
    1.41 +- Daniel Karling (pnglite)
    1.42 +
    1.43 +During the development of OpenCTM, the following software has been used
    1.44 +extensively:
    1.45 +
    1.46 +- Ubuntu (www.ubuntu.com)
    1.47 +- Blender (www.blender.org)
    1.48 +- GCC (gcc.gnu.org)
    1.49 +- SciTE (www.scintilla.org/SciTE.html)
    1.50 +- Notepad++ (notepad-plus.sourceforge.net)
    1.51 +- Smultron (smultron.sourceforge.net)
    1.52 +
    1.53 +Legal notices:
    1.54 +
    1.55 +- This software is based in part on the work of the Independent JPEG Group.
    1.56 +
    1.57 +
    1.58 +4. CHANGES
    1.59 +==========
    1.60 +
    1.61 +v1.0.3 - 2010.01.15
    1.62 +-------------------
    1.63 +- Added support for PNG format textures (ctmviewer).
    1.64 +
    1.65 +- Added support for LightWave LWO files (ctmconv and ctmviewer).
    1.66 +
    1.67 +- Added support for Geomview OFF files, e.g. as used by the Princeton Shape
    1.68 +  Benchmark (ctmconv and ctmviewer).
    1.69 +
    1.70 +- Improved the OBJ file loader (ctmviewer and ctmconv).
    1.71 +
    1.72 +- Experimental support for VRML 2.0 files - export only (ctmconv and ctmviewer).
    1.73 +
    1.74 +- Made it possible to run ctmviewer without command line arguments.
    1.75 +
    1.76 +- Improved the normal calculation algorithm (ctmviewer and ctmconv).
    1.77 +
    1.78 +- Normals are no longer exported if no normals were present in the input file
    1.79 +  (ctmviewer).
    1.80 +
    1.81 +
    1.82 +v1.0.2 - 2009.12.13
    1.83 +-------------------
    1.84 +- Added an OpenCTM exporter plugin for Maya [Jonas Innala].
    1.85 +
    1.86 +- Added the possiblity to save and load files from ctmviewer, effectively
    1.87 +  turning it into a quick and simple converter tool (without all the options
    1.88 +  in the ctmconv program, though).
    1.89 +
    1.90 +- Added a function to load texture files from ctmviewer.
    1.91 +
    1.92 +- Improved the camera control in ctmviewer (panning with the right mouse
    1.93 +  button, zooming with the middle mouse button and the mouse wheel, feature
    1.94 +  focusing by double clicking, Y/Z up axis selection and "fit to screen"
    1.95 +  function).
    1.96 +
    1.97 +- Added a GUI dialog for showing errors in ctmviewer (this is especially useful
    1.98 +  under Windows, where console output is disabeled).
    1.99 +
   1.100 +- Added an option for calculating the normals in ctmconv (if the input file
   1.101 +  does not have normals).
   1.102 +
   1.103 +- Added options for turning off normals, texture coordinates and/or vertex
   1.104 +  colors for the output file in ctmconv.
   1.105 +
   1.106 +- Added manuals for ctmviewer and ctmconv (man pages).
   1.107 +
   1.108 +- Added a "make install" build target for Mac OS X and Linux for simple system
   1.109 +  wide installation (see COMPILING.txt).
   1.110 +
   1.111 +- NOTE: The Linux/X11 version of ctmviewer now reqires GTK+ 2.0.
   1.112 +
   1.113 +
   1.114 +v1.0.1 - 2009.11.15
   1.115 +-------------------
   1.116 +- Notable reduction of the memory footprint by tuning of the LZMA compression
   1.117 +  parameters.
   1.118 +
   1.119 +- Added a Wavefront OBJ file importer/exporter.
   1.120 +
   1.121 +- Some improvements to ctmviewer and ctmconv.
   1.122 +
   1.123 +- Some directory structure and build system cleanups.
   1.124 +
   1.125 +
   1.126 +v1.0 - 2009.11.09
   1.127 +-----------------
   1.128 +- Added a COLLADA converter module to the ctmconv program [Jonas Innala].
   1.129 +
   1.130 +- Added Python bindings and a demo Python program.
   1.131 +
   1.132 +- Improved the internal mesh integrity checking, to minimize the risk of invalid
   1.133 +  data processing.
   1.134 +
   1.135 +- Improved the file format specification document.
   1.136 +
   1.137 +
   1.138 +v0.8 (beta) - 2009.09.14
   1.139 +------------------------
   1.140 +- Introduced a new API function for controlling the compression level
   1.141 +  (ctmCompressionLevel), and set the default compression level to 5 (rather
   1.142 +  than 9, which would eat a lot of memory, usally without much difference).
   1.143 +
   1.144 +- Changed the name "texture map" in the API to "UV map" (and all
   1.145 +  corresponding constant and function names). This is more in line with
   1.146 +  the nomenclature of most 3D authoring software, and avoids the confusion
   1.147 +  with the term texture mapping in 3D hardware (which is not limited to
   1.148 +  2D UV mapping coordinates).
   1.149 +
   1.150 +- A few updates to the documentation.
   1.151 +
   1.152 +
   1.153 +v0.7 (beta) - 2009.08.29
   1.154 +------------------------
   1.155 +- This was the first public release of OpenCTM.