U3D is a format for 3D models that can be embedded into PDF and viewed in Adobe Acrobat/Reader
(but not other PDF viewers).
There is a C++ library to produce U3D files and a converter from IDTF, a verbose text format.
You need libpng (http://www.libpng.org/), jpeg library (http://www.ijg.org/) and zlib (http://www.zlib.net/)
installed to compile U3D lib using autotools.
The cmake build uses bundled versions of the above tools.
This is just a port of Intel U3D library to the GNU Build System and cmake,
with rendering part thrown out.
There is not much to read in this readme since I guess there is not too many potential readers.
You may contact me, Michail Vidiassov, by Internet e-mail master@iaas.msu.ru.
That will make me describe my changes in more detail or apply some minor fixes you desire.
But the proper place to discuss things is the U3D software forum at sourceforge.
You can also find the Intel source there, only the main part is preserved in this distribution.
I have made the following changes - all quality factors are set to maximum quality by default,
thus supressing compression.
To IDTF I have added one more parameter - TEXTURE_LAYER_REPEAT: "UV", "U", "V" or "NONE",
with "UV" being default. The name says what it does.
I have also dissected IDTFConverter and made a library from the converter part
(discarding IDTF file parser), it can be used to eliminate intermediate IDTF files that
may be really lengthy and slow to create and than parse with IDTFConverter.
"History of the U3D File Format" at http://www.okino.com/conv/imp_u3d.htm is a good read on what U3D is and where it comes from.
ChangeLog:
1.4.4 05.2013
* disabled use of assembler, since performance gain is likely small, while
portability risks high
* fixed warnings of unused variable values (when it was unclear if there was
an error or a desired behavior, the current behavior was preserved).
* changed cmake build not to use bundled libraries by default
* updated jpeg, png and zlib libraries
1.4.3 02.2012
* fixed MSVC Win64 bit compilation - reported by Ingo Wulf
* updated jpeg, png and zlib libraries
1.4.2 05.2011
* fixed Win32 compilation with __stdcall set in IFXAPI.h - reported by Rob
Ebbers
* put vtkU3DExporter to the code samples section
* added headers to program and library sources in cmake, so they are correctly
shown in MSVC GUI.
* made libIDTF shared library (but for MSVC)
(there were problems on Linux with PIC if static libIDTF was used to build
shared libraries)
1.4.1 04.2011
* changes in IDTFConverter, to allow it to parse Adobe metadata for nodes
MinGW compilation
1.4.0 02.2011
* Many tiny fixes, but I do not remember what are they
1.3.0 2009-2010
* Repackaged Intel sources from custom build system to autotools and cmake
* Fixed lots of compilation warnings, may be bugs.
* Dropped everything but parts required to create U3D files (i.e. Renderind
component and sample Player).
* Set default compression parameters to minimal compression.
* Made libIDTF from converter part of IDTFConverter, so that instead of making
huge IDTF files on disk and launching IDFConverter one can create equivalent binary scene in
memory and call "convert" routine
