Qrow: 1 revision imported

2025-11-14T05:21:31Z

1 revision imported

← Older revision	Revision as of 22:21, 13 November 2025
(No difference)

Interwiki>Maddox: Added specific assimp metadata wiki entry

2019-03-27T19:07:57Z

Added specific assimp metadata wiki entry

New page

= Assimp mesh Meta Reference =
You may add additional, Spring-specific information to .dae, .lwo and other assimp-supported files in this extra lua file. It's usually named after the models extension and placed at the /objects folder, next to it. For instance, for testobject.dae you'd use testobject.dae.lua.

Variables are organised as such:
{{tag|name=VariableName|type=type|range=[valid range]|special=Required|default=value
|description=Description}}

==Source==
The engine source code which reads this file is viewable here:

* {{sourcelink|file=rts/Rendering/Models/AssParser.cpp}}

= General Formatting =
check [http://www.lua.org/docs.html Lua Documentation].

=Data Types=
{{DataTypes}}

= Notes =
* the script MUST return exactly one model-table (which may be named arbitrarily)
* the tree must reference ONLY object names defined in the assimp file
* a piece-table key may NOT be "name" or "offset" (these are reserved keywords)
= Sections =
== modelfilename.lua ==
<code><pre>model = {
pieces = {
...
},
radius = 0,
midpos = { 0, 0, 0 },
tex1 = "",
--tex2 = "",
numpieces = 1,

globalvertexoffset = true,
localpieceoffset = true,
}
return model</pre></code>

===== meshname =====
name of your mesh...

{{tag|name=midpos|type=float3|special=Required
|description=the local of the median point of the mesh from the origin}}

{{tag|name=radius|type=float|special=Required
|description=from the midpos the radius of the mesh, used for occlusion culling}}

{{tag|name=tex1|type=string
|description=filename of the texture image to use for diffuse and teamcolor}}

{{tag|name=tex2|type=string
|description=filename of the texture image to use for ambient, specular and transparency}}

{{tag|name=globalvertexoffsets|type=bool
|description=whether the vertex coordinates are relative to the global origin, or the local origin}}

{{tag|name=localpieceoffsets|type=bool
|description=whether the piece offsets are relative to the global origin, or the parent offset}}

{{tag|name=nodenamesfromids|type=bool|default=false
|description=uses names as unique object identifiers, instead of node ids. Useful for non-Blender .dae files. New in 104 maintenance 1153-gfb53422}}

== pieces ==
Specifies the hierarchy of objects
<code><pre>model = {
pieces = {
piecename = {
offset = {0.0, 0.0, 0.0},
anotherpiecename = {
offset = {0.0, 0.0, 0.0},
...
},
...
},
},
...
}
return model</pre></code>

{{tag|name=name|type=string|special=Required
|description=each piece name needs to correspond to an object in the mesh file. For an .obj file it would be the "o" tag}}

{{tag|name=offset|type=float3
|description=the offset of the piece vertices either in parent or world space}}

[[Category:3D Models]]

3DModels:AssimpMetadata - Revision history

Qrow: 1 revision imported

Interwiki>Maddox: Added specific assimp metadata wiki entry