goat3d
view libs/openctm/README.txt @ 37:d259a5094390
trying to figure out how to properly call C functions from the python plugin
| author | John Tsiombikas <nuclear@member.fsf.org> |
|---|---|
| date | Sun, 06 Oct 2013 17:42:43 +0300 |
| parents | |
| children |
line source
1 1. INTRODUCTION
2 ===============
4 Welcome to OpenCTM!
6 OpenCTM is a file format, a software library and a tool set for compression of
7 3D triangle meshes. The geometry is compressed to a fraction of comparable file
8 formats (3DS, STL, COLLADA, VRML...), and the format is easily accessible
9 through a simple, portable API.
11 The library is written in portable C (C99), and should compile nicely on any
12 32/64-bit system regardless of endianity (big endian or little endian).
15 2. LICENSE
16 ==========
18 The OpenCTM API and the OpenCTM tools are released under the zlib/libpng
19 license (see LICENSE.txt).
21 3. CREDITS
22 ==========
24 Many people have helped out in the development process of OpenCTM, with
25 valuable feedback, programming efforts, test models and conceptual ideas.
26 Also, OpenCTM relies heavily on many other open source projects.
28 Here is an incomplete list of persons that deserve credit:
30 - Igor Pavlov (LZMA library)
31 - Jonas Innala (COLLADA importer, Maya exporter plugin)
32 - Ilian Dinev (help with the OpenCTM file format design and the LWO loader)
33 - Lee Thomason (TinyXML)
34 - Diego Nehab (RPly - for loading PLY files)
35 - Lev Povalahev, Marcelo E. Magallon, Milan Ikits (GLEW)
36 - Thomas G. Lane, Guido Vollbeding (libjpeg)
37 - Jean-loup Gailly, Mark Adler (zlib)
38 - Daniel Karling (pnglite)
40 During the development of OpenCTM, the following software has been used
41 extensively:
43 - Ubuntu (www.ubuntu.com)
44 - Blender (www.blender.org)
45 - GCC (gcc.gnu.org)
46 - SciTE (www.scintilla.org/SciTE.html)
47 - Notepad++ (notepad-plus.sourceforge.net)
48 - Smultron (smultron.sourceforge.net)
50 Legal notices:
52 - This software is based in part on the work of the Independent JPEG Group.
55 4. CHANGES
56 ==========
58 v1.0.3 - 2010.01.15
59 -------------------
60 - Added support for PNG format textures (ctmviewer).
62 - Added support for LightWave LWO files (ctmconv and ctmviewer).
64 - Added support for Geomview OFF files, e.g. as used by the Princeton Shape
65 Benchmark (ctmconv and ctmviewer).
67 - Improved the OBJ file loader (ctmviewer and ctmconv).
69 - Experimental support for VRML 2.0 files - export only (ctmconv and ctmviewer).
71 - Made it possible to run ctmviewer without command line arguments.
73 - Improved the normal calculation algorithm (ctmviewer and ctmconv).
75 - Normals are no longer exported if no normals were present in the input file
76 (ctmviewer).
79 v1.0.2 - 2009.12.13
80 -------------------
81 - Added an OpenCTM exporter plugin for Maya [Jonas Innala].
83 - Added the possiblity to save and load files from ctmviewer, effectively
84 turning it into a quick and simple converter tool (without all the options
85 in the ctmconv program, though).
87 - Added a function to load texture files from ctmviewer.
89 - Improved the camera control in ctmviewer (panning with the right mouse
90 button, zooming with the middle mouse button and the mouse wheel, feature
91 focusing by double clicking, Y/Z up axis selection and "fit to screen"
92 function).
94 - Added a GUI dialog for showing errors in ctmviewer (this is especially useful
95 under Windows, where console output is disabeled).
97 - Added an option for calculating the normals in ctmconv (if the input file
98 does not have normals).
100 - Added options for turning off normals, texture coordinates and/or vertex
101 colors for the output file in ctmconv.
103 - Added manuals for ctmviewer and ctmconv (man pages).
105 - Added a "make install" build target for Mac OS X and Linux for simple system
106 wide installation (see COMPILING.txt).
108 - NOTE: The Linux/X11 version of ctmviewer now reqires GTK+ 2.0.
111 v1.0.1 - 2009.11.15
112 -------------------
113 - Notable reduction of the memory footprint by tuning of the LZMA compression
114 parameters.
116 - Added a Wavefront OBJ file importer/exporter.
118 - Some improvements to ctmviewer and ctmconv.
120 - Some directory structure and build system cleanups.
123 v1.0 - 2009.11.09
124 -----------------
125 - Added a COLLADA converter module to the ctmconv program [Jonas Innala].
127 - Added Python bindings and a demo Python program.
129 - Improved the internal mesh integrity checking, to minimize the risk of invalid
130 data processing.
132 - Improved the file format specification document.
135 v0.8 (beta) - 2009.09.14
136 ------------------------
137 - Introduced a new API function for controlling the compression level
138 (ctmCompressionLevel), and set the default compression level to 5 (rather
139 than 9, which would eat a lot of memory, usally without much difference).
141 - Changed the name "texture map" in the API to "UV map" (and all
142 corresponding constant and function names). This is more in line with
143 the nomenclature of most 3D authoring software, and avoids the confusion
144 with the term texture mapping in 3D hardware (which is not limited to
145 2D UV mapping coordinates).
147 - A few updates to the documentation.
150 v0.7 (beta) - 2009.08.29
151 ------------------------
152 - This was the first public release of OpenCTM.