| OLD | NEW |
| 1 The converter is a command line utility that will convert from COLLADA | 1 The converter is a command line utility that will convert from COLLADA |
| 2 to the form that the sample JavaScript scene loader (in | 2 to the form that the sample JavaScript scene loader (in |
| 3 samples/o3djs/serialization.js) can read. | 3 samples/o3djs/serialization.js) can read. |
| 4 | 4 |
| 5 It is able to read COLLADA files as either DAE text files (and | 5 It is able to read COLLADA files as either DAE text files (and |
| 6 associated asset files in subdirectories), or as part of a ZIP archive | 6 associated asset files in subdirectories), or as part of a ZIP archive |
| 7 (or KMZ file). It outputs a gzip-compressed tar archive (.tgz) which | 7 (or KMZ file). By default it outputs a gzip-compressed tar archive |
| 8 contains a JSON file and any associated assets (textures, shaders, | 8 (.tgz) which contains a JSON file and any associated assets (textures, |
| 9 etc.) from the source COLLADA model. By default we don't use the .tgz | 9 shaders, etc.) from the source COLLADA model. By default we don't use |
| 10 extension, as it can cause problems with some webservers; we put .o3dtgz on | 10 the .tgz extension, as it can cause problems with some webservers; we |
| 11 instead. | 11 put .o3dtgz on instead. The converter can optionally output a set of |
| 12 flat files into a directory, which is the layout compatible with the |
| 13 WebGL implementation of O3D. |
| 12 | 14 |
| 13 In order to run the converter on Windows, you need the DirectX SDK installed. | 15 In order to run the converter on Windows, you need the DirectX SDK installed. |
| 14 Installing it requires administrator privileges. You can get it here: | 16 Installing it requires administrator privileges. You can get it here: |
| 15 http://msdn.microsoft.com/en-us/library/bb219737(VS.85).aspx. | 17 http://msdn.microsoft.com/en-us/library/bb219737(VS.85).aspx. |
| 16 | 18 |
| 17 The command line arguments are as follows: | 19 The command line arguments are as follows: |
| 18 | 20 |
| 19 Usage: o3dConverter.exe [--base-path=<path>] | 21 Usage: o3dConverter.exe [--base-path=<path>] |
| 20 [--up-axis=x,y,z] | 22 [--up-axis=x,y,z] |
| 21 [--no-condition] | 23 [--no-condition] |
| 22 [--pretty-print] | 24 [--pretty-print] |
| 25 [--no-binary] |
| 26 [--no-archive] |
| 27 [--convert-dds-to-png] |
| 28 [--convert-cg-to-glsl] |
| 23 <infile.dae> [ <outfile> ] | 29 <infile.dae> [ <outfile> ] |
| 24 | 30 |
| 25 --base-path=<path>: This specifies the path elements to remove from | 31 --base-path=<path>: This specifies the path elements to remove from |
| 26 the beginning of the filenames placed into the | 32 the beginning of the filenames placed into the |
| 27 .o3dtgz file (to avoid including sensitive paths in | 33 .o3dtgz file (to avoid including sensitive paths in |
| 28 the .o3dtgz file). | 34 the .o3dtgz file). |
| 29 | 35 |
| 30 --up-axis=x,y,z: This specifies the up-axis for the resulting model, | 36 --up-axis=x,y,z: This specifies the up-axis for the resulting model, |
| 31 if you wish it to be different from the axis in the | 37 if you wish it to be different from the axis in the |
| 32 COLLADA file. | 38 COLLADA file. |
| 33 | 39 |
| 34 --pretty-print: This simply formats the JSON file in the resulting | 40 --pretty-print: This simply formats the JSON file in the resulting |
| 35 .o3dtgz file to be human readable, instead of compacted | 41 .o3dtgz file to be human readable, instead of compacted |
| 36 into one line. | 42 into one line. |
| 37 | 43 |
| 38 --no-condition: This will prevent conditioning of the shaders from | 44 --no-condition: This will prevent conditioning of the shaders from |
| 39 COLLADA form to the form expected by O3D. [This is | 45 COLLADA form to the form expected by O3D. [This is |
| 40 useful only for pre-release data conditioned before | 46 useful only for pre-release data conditioned before |
| 41 the converter existed.] | 47 the converter existed.] |
| 42 | 48 |
| 49 The following four command line options are useful when converting |
| 50 assets for the WebGL implementation of O3D: |
| 51 |
| 52 --no-binary: Buffers, skins and curves will be written directly into the |
| 53 scene.json rather than into separate binary files. |
| 54 |
| 55 --no-archive: Don't make a gzipped tar file, just flat files. Still |
| 56 takes the name of an archive file; for archive.o3dtgz, |
| 57 creates directory named archive/ and writes files inside. |
| 58 |
| 59 --convert-dds-to-png: Convert all DDS textures to PNGs. For cube map |
| 60 textures, writes six separate PNGs with suffixes |
| 61 _posx, _negx, etc. |
| 62 |
| 63 --convert-cg-to-glsl: Convert shaders using an external tool. Requires |
| 64 python on PATH and either NVIDIA Cg toolkit |
| 65 installed or cgc{.exe} in same directory as |
| 66 converter. |
| 67 |
| 43 <infile.dae|infile.zip|infile.kmz>: This is the input file in one of | 68 <infile.dae|infile.zip|infile.kmz>: This is the input file in one of |
| 44 ZIP, KMZ, or DAE formats. The | 69 ZIP, KMZ, or DAE formats. The |
| 45 DAE format expects to find assets | 70 DAE format expects to find assets |
| 46 relative to the .dae file. | 71 relative to the .dae file. |
| 47 | 72 |
| 48 <outfile>: An optional argument giving the name of the | 73 <outfile>: An optional argument giving the name of the |
| 49 gzip-compressed tar archive output file. By default | 74 gzip-compressed tar archive output file. By default |
| 50 this has the same basename as the input file, and has the extension | 75 this has the same basename as the input file, and has the extension |
| 51 .o3dtgz. | 76 .o3dtgz. |
| OLD | NEW |