Model system - Revision history

Nozmajner: /* Importing models */

2022-05-09T08:45:55Z

‎Importing models

Nozmajner at 12:51, 24 December 2020

2020-12-24T12:51:20Z

Wingnut: Update of Tag points section to highlight that the tags are considered mandatory

2019-08-23T10:41:40Z

Update of Tag points section to highlight that the tags are considered mandatory

Nozmajner: Adding the long undocumented tex_ambi texture type.

2018-01-31T18:30:59Z

Adding the long undocumented tex_ambi texture type.

Impaktor: /* Thrusters */

2017-09-23T07:42:26Z

‎Thrusters

Nozmajner: Alternative collada exporter

2017-07-22T18:59:38Z

Alternative collada exporter

Nozmajner: Adding the current animation hooks

2017-07-22T18:50:38Z

Adding the current animation hooks

Nozmajner: typo

2017-06-28T05:55:18Z

typo

Nozmajner: Updating the Material naming part

2016-10-23T16:12:07Z

Updating the Material naming part

Nozmajner: /* Shield mesh */

2016-03-16T20:27:49Z

‎Shield mesh

@@ Line 15: / Line 15: @@
 *For static geometry, such as buildings, OBJ is recommended, this may allow for some optimizations
-The only officially tested 3D modelling program at the moment is [http://www.blender.org/ Blender 2.91]. For blender, a quick checklist is:
+The only officially tested 3D modelling program at the moment is [http://www.blender.org/ Blender 3.1]. For blender, a quick checklist is:
 *Coordinates: X right, Y forward, Z up

@@ Line 15: / Line 15: @@
 *For static geometry, such as buildings, OBJ is recommended, this may allow for some optimizations
-The only officially tested 3D modelling program at the moment is [http://www.blender.org/ Blender 2.7]8c. For blender, a quick checklist is:
+The only officially tested 3D modelling program at the moment is [http://www.blender.org/ Blender 2.91]. For blender, a quick checklist is:
 *Coordinates: X right, Y forward, Z up

@@ Line 186: / Line 186: @@
 As at 29 January 2014.
 Tags are only need to be present on the top level LOD, they will be visible on all LOD levels.
 {| class="wikitable"

@@ Line 53: / Line 53: @@
   specular 1.0 1.0 1.0
   shininess 150
@@ Line 79: / Line 80: @@
 | tex_diff
 | Diffuse texture, file name (in the same folder). If you don't specify this, a white dummy texture is generated.
 |-
 | tex_glow

← Older revision		Revision as of 07:42, 23 September 2017
Line 250:		Line 250:

	Thrusters are marked with dummy objects. In Blender, create an "Empty" object and point its Z-axis (change the object display type to "arrows" or "single arrow" to visualize this) where the thruster should point. Thruster size is taken from the object scale. Begin the object name with either <code>thruster_</code> or <code>thruster_linear</code> so the importer can recognize them (linear thrusters light up only when moving up/down/left/right/forward/backward, not when turning).		Thrusters are marked with dummy objects. In Blender, create an "Empty" object and point its Z-axis (change the object display type to "arrows" or "single arrow" to visualize this) where the thruster should point. Thruster size is taken from the object scale. Begin the object name with either <code>thruster_</code> or <code>thruster_linear</code> so the importer can recognize them (linear thrusters light up only when moving up/down/left/right/forward/backward, not when turning).
		+
		+	Thruster colour can be modified, see: https://github.com/pioneerspacesim/pioneer/pull/3948

	== Internals ==		== Internals ==

@@ Line 5: / Line 5: @@
 == Debuging models ==
 You can access some in-game debug functionality regarding models. Wire-frame display, tag display, collision and bounding box display, among other things. Details: [[Model debug flags]]
@@ Line 11: / Line 12: @@
 The import system theoretically supports [http://assimp.sourceforge.net/main_features_formats.html many different formats] but you are expected to use only some:
-* When node structure, node names and animations matter, use '''Collada (.dae).'''
+*When node structure, node names and animations matter, use '''Collada (.dae).'''
-* For static geometry, such as buildings, OBJ is recommended, this may allow for some optimizations
+*For static geometry, such as buildings, OBJ is recommended, this may allow for some optimizations
-The only officially tested 3D modelling program at the moment is [http://www.blender.org/ Blender 2.72]. For blender, a quick checklist is:
+The only officially tested 3D modelling program at the moment is [http://www.blender.org/ Blender 2.7]8c. For blender, a quick checklist is:
-* Coordinates: X right, Y forward, Z up
+*Coordinates: X right, Y forward, Z up
-* Always generate UV coordinates for the model
+*Always generate UV coordinates for the model
-* Versions downloaded from blender.org support Collada out of the box, while the version distributed with some Linux distros doesn't
+*Versions downloaded from blender.org support Collada out of the box, while the version distributed with some Linux distros doesn't.
-The [[Model viewer]] is supplied with the game.
+The [[Model_viewer|Model viewer]] is supplied with the game.
 === Model definition file ===

@@ Line 147: / Line 147: @@
 If you name an object '''''shipname''_shield''', it will be used as the shield mesh for the ship. It can be in the top LoD .dae (.obj, etc), or in a separate file, but then you have to define that .dae for the top LoD too in the .model file.
 If not present, then the game will generate a spherical shield around the ship.
 == Animations ==
@@ Line 158: / Line 159: @@
 The game will recognize animations by name, the list of supported animations is to be decided.
 There is no animation blending, so two animations shouldn't be directly controlling the same node.

@@ Line 51: / Line 51: @@
   specular 1.0 1.0 1.0
   shininess 150
 === Material properties ===
@@ Line 84: / Line 85: @@
 |-
 | tex_norm
-| Normal map. Default none. You can create surfae detail with it, which interacts with lighting.
+| Normal map. Default none. You can create surface detail with it, which interacts with lighting.
 |-
 | use_patterns

@@ Line 56: / Line 56: @@
 {| class="wikitable"
 |-
-| material || Name. Mandatory! Note, some exporters modify the names from what is visible in the modeling program, for example the Blender 2.6 Collada exporter adds "-material" to each name. You'll have to use this final name. If in doubt, note that both .obj and .dae files are human readable, and you can find the assigned names in them with a text editor.
+| material
 |-
-| diffuse|| Diffuse colour RGB. Default white.
+| diffuse
 |-
-| specular|| Colour of specular highlights, RGB. Default white. Set to black to disable highlights.
+| specular
 |-
-| emissive|| Self-illumination colour, RGB. Default black.
+| emissive
 |-
-| shininess|| Sharpness/size of specular highlights, 0 - 128. Default 100.
+| shininess
 |-
-| opacity|| 0-100, controls transparency of the material. A node with a material opacity less than 100 is treated as transparent, otherwise opaque.
+| opacity
 |-
-| tex_diff || Diffuse texture, file name (in the same folder). If you don't specify this, a white dummy texture is generated.
+| tex_diff
 |-
-| tex_glow||Self-illumination texture, overrides emissive colour parameter. Default none.
+| tex_glow
 |-
-| tex_spec||Specular highlight colour/intensity texture. Default none. Multiplied by specular colour parameter, so set it to white to leave control entirely to the texture.
+| tex_spec
 |-
-| tex_norm||Normal map. Default none. You can create surfae detail with it, which interacts with lighting.
+| tex_norm
 |-
-| use_patterns||This material will use the pattern/colour system. Read more below.
+| use_patterns
 |-
-| unlit||No lighting, diffuse value can still be used to tint the result
+| unlit
 |-
-| two_sided||Removed function. Duplicate face and flip normals if needed.
+| two_sided
 |-
-| alpha_test||Pixels with alpha value < 0.5 are discarded, this is good for fences and such. It produces sharp edges but the geometry does not need to be sorted.
+| alpha_test
 |}
-[[File:newmodel_specularmap.png]]
+[[File:Newmodel specularmap.png|RTENOTITLE]] Flat specular lighting improved by a specular map
-[[File:newmodel_glowmap.png]]
+[[File:Newmodel glowmap.png|RTENOTITLE]] A model lit only by the self-illumination texture
 === Patterns ===

@@ Line 132: / Line 132: @@
 == Shield mesh ==
-If you name an object '''''shipname''_mesh''', it will be used as the shield mesh for the ship. It can be in the top LoD .dae (.obj, etc), or in a separate file, but then you have to define that .dae for the top LoD too in the .model file.
+If you name an object '''''shipname''_shield''', it will be used as the shield mesh for the ship. It can be in the top LoD .dae (.obj, etc), or in a separate file, but then you have to define that .dae for the top LoD too in the .model file.
 If not present, then the game will generate a spherical shield around the ship.