Pipeline 3D Export Tool Requirements

Version 17 (kaetemi, 09/01/2012 05:05 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 16 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 17 kaetemi
** Except for the ones that should not export
31 1 kaetemi
* Animations per shape if any (shape_anim/nodename.anim)
32 15 kaetemi
** When @Automatic Animation@ is checked.
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)