summaryrefslogtreecommitdiffstats
path: root/o3d/converter/README.converter
diff options
context:
space:
mode:
Diffstat (limited to 'o3d/converter/README.converter')
-rw-r--r--o3d/converter/README.converter35
1 files changed, 30 insertions, 5 deletions
diff --git a/o3d/converter/README.converter b/o3d/converter/README.converter
index 77fdd0a..71fd462 100644
--- a/o3d/converter/README.converter
+++ b/o3d/converter/README.converter
@@ -4,11 +4,13 @@ samples/o3djs/serialization.js) can read.
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 @@ Usage: o3dConverter.exe [--base-path=<path>]
[--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 @@ Usage: o3dConverter.exe [--base-path=<path>]
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