Pipeline 3D Export Tool Requirements
Version 18 (kaetemi, 09/01/2012 05:06 pm)
| 1 | 1 | kaetemi | h1. Pipeline 3D Export Tool Requirements |
|---|---|---|---|
| 2 | 1 | kaetemi | |
| 3 | 1 | kaetemi | This page lists the requirements for creating export tools for 3D data which can be used by the pipeline. |
| 4 | 1 | kaetemi | |
| 5 | 11 | kaetemi | An export tool would be either one of the following: |
| 6 | 11 | kaetemi | * A console tool that can be executed once per input file |
| 7 | 11 | kaetemi | * An interface for inter-process communication that commands a running 3d modeling application process |
| 8 | 14 | kaetemi | * A tool that commands a 3d modeling application to process many input files in batch (Not recommended, as it does not provide sufficiently flexible feedback, and is totally annoying when it crashes) |
| 9 | 12 | kaetemi | |
| 10 | 11 | kaetemi | And needs to accept the export modes with their respective input parameters, and output all of the requested files. |
| 11 | 11 | kaetemi | |
| 12 | 1 | kaetemi | h3. Export modes |
| 13 | 1 | kaetemi | |
| 14 | 5 | kaetemi | |shape|1 -> many|shape; anim; tga (lightmap)| |
| 15 | 5 | kaetemi | |ig|1 -> many|ig| |
| 16 | 5 | kaetemi | |skel|1 -> 1|skel| |
| 17 | 4 | kaetemi | |clod||| |
| 18 | 4 | kaetemi | |cmb||| |
| 19 | 4 | kaetemi | |pacs_prim||| |
| 20 | 4 | kaetemi | |swt||| |
| 21 | 4 | kaetemi | |veget||| |
| 22 | 4 | kaetemi | |zone||| |
| 23 | 1 | kaetemi | |
| 24 | 1 | kaetemi | h2. shape |
| 25 | 1 | kaetemi | |
| 26 | 1 | kaetemi | Exports: |
| 27 | 1 | kaetemi | * All shape nodes with lod (shape_with_coarse_mesh/nodename.shape) |
| 28 | 18 | kaetemi | ** Node metadata contains list of names of LOD mesh nodes. |
| 29 | 1 | kaetemi | * All shape nodes without lod (shape_not_optimized/nodename.shape) |
| 30 | 18 | kaetemi | ** Except for the ones that should not export. |
| 31 | 1 | kaetemi | * Animations per shape if any (shape_anim/nodename.anim) |
| 32 | 18 | kaetemi | ** When @Automatic Animation@ is checked in the metadata of the node pointing to the mesh. |
| 33 | 13 | kaetemi | * Generates lightmaps (LM) if required per shape per lightgroup (shape_lightmap_not_optimized/filename_nodename_lightgroupid.tga & filename_nodename.txt (if OptLightmapLog)) |
| 34 | 7 | kaetemi | ** We might want to modify this to export the data required for a lightmap generation tool only to a data file, and run a lightmap generation tool outside of the 3d export process, that uses the exported shape and light information from the data file. See calc_lm*.* files under nel_mesh_lib. |
| 35 | 1 | kaetemi | |
| 36 | 1 | kaetemi | Does not export: |
| 37 | 17 | kaetemi | * Accelerators (meshes describing clusters and portals) |
| 38 | 17 | kaetemi | * Zone quad patch (this is exported to .zone in a different process) |
| 39 | 17 | kaetemi | * Particle system (a type of node that refers to a .ps, used in the .ig) |
| 40 | 17 | kaetemi | * PACS Primitive (basic cylinder and box shapes used for collision) |
| 41 | 17 | kaetemi | * Node properties DONOTEXPORT checked (speaks for itself) |
| 42 | 17 | kaetemi | * Node properties COLLISION checked (interior collision meshes) |
| 43 | 17 | kaetemi | * Node properties COLLISION_EXTERIOR checked (exterior collision meshes) |
| 44 | 7 | kaetemi | |
| 45 | 7 | kaetemi | Shapes may be: |
| 46 | 7 | kaetemi | * Particle system (???) |
| 47 | 7 | kaetemi | * Wave maker |
| 48 | 10 | kaetemi | * Node properties USE_REMANENCE checked (what is this?) |
| 49 | 7 | kaetemi | * Flare |
| 50 | 7 | kaetemi | * Triangle object |
| 51 | 7 | kaetemi | |
| 52 | 7 | kaetemi | Triangle object may be: |
| 53 | 7 | kaetemi | * Water shape |
| 54 | 7 | kaetemi | * Shape with lod |
| 55 | 7 | kaetemi | * Shape without lod |
| 56 | 2 | kaetemi | |
| 57 | 9 | kaetemi | Input parameters: |
| 58 | 9 | kaetemi | * LogErrorFile |
| 59 | 9 | kaetemi | * LogDependFile |
| 60 | 9 | kaetemi | * SrcFile |
| 61 | 9 | kaetemi | * DstDirectoryWithoutCoarseMesh |
| 62 | 9 | kaetemi | * DstDirectoryWithCoarseMesh |
| 63 | 9 | kaetemi | * DstDirectoryLightmap |
| 64 | 9 | kaetemi | * DstDirectoryAnim |
| 65 | 9 | kaetemi | * OptExportLighting |
| 66 | 9 | kaetemi | * OptShadow |
| 67 | 9 | kaetemi | * OptLightingLimit |
| 68 | 9 | kaetemi | * OptLumelSize |
| 69 | 9 | kaetemi | * OptOversampling |
| 70 | 9 | kaetemi | * OptLightmapLog |
| 71 | 9 | kaetemi | |
| 72 | 8 | kaetemi | h2. ig |
| 73 | 2 | kaetemi | |
| 74 | 2 | kaetemi | Exports: |
| 75 | 3 | kaetemi | * All instance groups for IGNAME used in node properties (igname.ig) |
| 76 | 2 | kaetemi | |
| 77 | 2 | kaetemi | Instance groups contain: |
| 78 | 2 | kaetemi | * All shapes (by name) |
| 79 | 2 | kaetemi | * All lights |
| 80 | 1 | kaetemi | * All helpers |
| 81 | 3 | kaetemi | |
| 82 | 8 | kaetemi | h2. skel |
| 83 | 3 | kaetemi | |
| 84 | 3 | kaetemi | Exports: |
| 85 | 3 | kaetemi | * One skeleton containing node tree in reference position starting from node Bip01 (filename.skel) |