Index: converter/README.converter |
=================================================================== |
--- converter/README.converter (revision 45712) |
+++ converter/README.converter (working copy) |
@@ -4,11 +4,13 @@ |
It is able to read COLLADA files as either DAE text files (and |
associated asset files in subdirectories), or as part of a ZIP archive |
-(or KMZ file). It outputs a gzip-compressed tar archive (.tgz) which |
-contains a JSON file and any associated assets (textures, shaders, |
-etc.) from the source COLLADA model. By default we don't use the .tgz |
-extension, as it can cause problems with some webservers; we put .o3dtgz on |
-instead. |
+(or KMZ file). By default it outputs a gzip-compressed tar archive |
+(.tgz) which contains a JSON file and any associated assets (textures, |
+shaders, etc.) from the source COLLADA model. By default we don't use |
+the .tgz extension, as it can cause problems with some webservers; we |
+put .o3dtgz on instead. The converter can optionally output a set of |
+flat files into a directory, which is the layout compatible with the |
+WebGL implementation of O3D. |
In order to run the converter on Windows, you need the DirectX SDK installed. |
Installing it requires administrator privileges. You can get it here: |
@@ -20,6 +22,10 @@ |
[--up-axis=x,y,z] |
[--no-condition] |
[--pretty-print] |
+ [--no-binary] |
+ [--no-archive] |
+ [--convert-dds-to-png] |
+ [--convert-cg-to-glsl] |
<infile.dae> [ <outfile> ] |
--base-path=<path>: This specifies the path elements to remove from |
@@ -40,6 +46,25 @@ |
useful only for pre-release data conditioned before |
the converter existed.] |
+The following four command line options are useful when converting |
+assets for the WebGL implementation of O3D: |
+ |
+--no-binary: Buffers, skins and curves will be written directly into the |
+ scene.json rather than into separate binary files. |
+ |
+--no-archive: Don't make a gzipped tar file, just flat files. Still |
+ takes the name of an archive file; for archive.o3dtgz, |
+ creates directory named archive/ and writes files inside. |
+ |
+--convert-dds-to-png: Convert all DDS textures to PNGs. For cube map |
+ textures, writes six separate PNGs with suffixes |
+ _posx, _negx, etc. |
+ |
+--convert-cg-to-glsl: Convert shaders using an external tool. Requires |
+ python on PATH and either NVIDIA Cg toolkit |
+ installed or cgc{.exe} in same directory as |
+ converter. |
+ |
<infile.dae|infile.zip|infile.kmz>: This is the input file in one of |
ZIP, KMZ, or DAE formats. The |
DAE format expects to find assets |