bgfx/3rdparty/openctm

1. INTRODUCTION

===============



Welcome to OpenCTM!



OpenCTM is a file format, a software library and a tool set for compression of

3D triangle meshes. The geometry is compressed to a fraction of comparable file

formats (3DS, STL, COLLADA, VRML...), and the format is easily accessible

through a simple, portable API.



The library is written in portable C (C99), and should compile nicely on any

32/64-bit system regardless of endianity (big endian or little endian).





2. LICENSE

==========



The OpenCTM API and the OpenCTM tools are released under the zlib/libpng

license (see LICENSE.txt).



3. CREDITS

==========



Many people have helped out in the development process of OpenCTM, with

valuable feedback, programming efforts, test models and conceptual ideas.

Also, OpenCTM relies heavily on many other open source projects.



Here is an incomplete list of persons that deserve credit:



- Igor Pavlov (LZMA library)

- Jonas Innala (COLLADA importer, Maya exporter plugin)

- Ilian Dinev (help with the OpenCTM file format design and the LWO loader)

- Lee Thomason (TinyXML)

- Diego Nehab (RPly - for loading PLY files)

- Lev Povalahev, Marcelo E. Magallon, Milan Ikits (GLEW)

- Thomas G. Lane, Guido Vollbeding (libjpeg)

- Jean-loup Gailly, Mark Adler (zlib)

- Daniel Karling (pnglite)



During the development of OpenCTM, the following software has been used

extensively:



- Ubuntu (www.ubuntu.com)

- Blender (www.blender.org)

- GCC (gcc.gnu.org)

- SciTE (www.scintilla.org/SciTE.html)

- Notepad++ (notepad-plus.sourceforge.net)

- Smultron (smultron.sourceforge.net)



Legal notices:



- This software is based in part on the work of the Independent JPEG Group.





4. CHANGES

==========



v1.0.3 - 2010.01.15

-------------------

- Added support for PNG format textures (ctmviewer).



- Added support for LightWave LWO files (ctmconv and ctmviewer).



- Added support for Geomview OFF files, e.g. as used by the Princeton Shape

  Benchmark (ctmconv and ctmviewer).



- Improved the OBJ file loader (ctmviewer and ctmconv).



- Experimental support for VRML 2.0 files - export only (ctmconv and ctmviewer).



- Made it possible to run ctmviewer without command line arguments.



- Improved the normal calculation algorithm (ctmviewer and ctmconv).



- Normals are no longer exported if no normals were present in the input file

  (ctmviewer).





v1.0.2 - 2009.12.13

-------------------

- Added an OpenCTM exporter plugin for Maya [Jonas Innala].



- Added the possiblity to save and load files from ctmviewer, effectively

  turning it into a quick and simple converter tool (without all the options

  in the ctmconv program, though).



- Added a function to load texture files from ctmviewer.



- Improved the camera control in ctmviewer (panning with the right mouse

  button, zooming with the middle mouse button and the mouse wheel, feature

  focusing by double clicking, Y/Z up axis selection and "fit to screen"

  function).



- Added a GUI dialog for showing errors in ctmviewer (this is especially useful

  under Windows, where console output is disabeled).



- Added an option for calculating the normals in ctmconv (if the input file

  does not have normals).



- Added options for turning off normals, texture coordinates and/or vertex

  colors for the output file in ctmconv.



- Added manuals for ctmviewer and ctmconv (man pages).



- Added a "make install" build target for Mac OS X and Linux for simple system

  wide installation (see COMPILING.txt).



- NOTE: The Linux/X11 version of ctmviewer now reqires GTK+ 2.0.





v1.0.1 - 2009.11.15

-------------------

- Notable reduction of the memory footprint by tuning of the LZMA compression

  parameters.



- Added a Wavefront OBJ file importer/exporter.



- Some improvements to ctmviewer and ctmconv.



- Some directory structure and build system cleanups.





v1.0 - 2009.11.09

-----------------

- Added a COLLADA converter module to the ctmconv program [Jonas Innala].



- Added Python bindings and a demo Python program.



- Improved the internal mesh integrity checking, to minimize the risk of invalid

  data processing.



- Improved the file format specification document.





v0.8 (beta) - 2009.09.14

------------------------

- Introduced a new API function for controlling the compression level

  (ctmCompressionLevel), and set the default compression level to 5 (rather

  than 9, which would eat a lot of memory, usally without much difference).



- Changed the name "texture map" in the API to "UV map" (and all

  corresponding constant and function names). This is more in line with

  the nomenclature of most 3D authoring software, and avoids the confusion

  with the term texture mapping in 3D hardware (which is not limited to

  2D UV mapping coordinates).



- A few updates to the documentation.





v0.7 (beta) - 2009.08.29

------------------------

- This was the first public release of OpenCTM.