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 |