Materials in Oolite - Revision history

Cholmondely: Tweaks

2026-08-04T06:59:55Z

Tweaks

Cholmondely: /* See also */ Added relevant OXPs and structure

2026-08-04T06:19:53Z

‎See also: Added relevant OXPs and structure

Cholmondely: Edited as per a_c's comments

2026-08-03T22:24:01Z

Edited as per a_c's comments

Phkb: Updating BB links

2024-02-29T02:08:13Z

Updating BB links

Cholmondely: /* See also */ Added note

2024-01-27T22:45:31Z

‎See also: Added note

Cholmondely: /* See also */ Added another link for "_modulate_color"

2023-12-28T19:23:43Z

‎See also: Added another link for "_modulate_color"

Cholmondely: /* See also */ Added picture

2023-10-15T10:19:24Z

‎See also: Added picture

Cholmondely: /* See also */ Added a little more

2023-10-15T10:17:25Z

‎See also: Added a little more

Cholmondely: /* See also */ Added link to q's & a's

2022-09-13T07:44:10Z

‎See also: Added link to q's & a's

Cholmondely: Added link to current revelations

2022-06-19T15:36:32Z

Added link to current revelations

@@ Line 1: / Line 1: @@
 Since v.1.87 (August 2018), more advanced options have become available. See [https://bb.oolite.space/viewtopic.php?f=2&t=19881 A Description of the Improved Lighting and Materials System] (2018), the attached update of Oct 2018 and the clarifications of May 2021. Oolite now supports the basic PBR (Physically Based Rendering) materials, using the new Oolite shaders system. The requirements are light energy conservation, a microfacet surface model and a physically based Bidirectional Reflective Distribution Function (BRDF)
-{{OXPNote|This page was last properly edited in 2013, well after the introduction of shaders but before [[User:Another commander|Another commander]]'s work on Oolite introducing specular & gloss maps, the new Oren-Nayar diffuse light model, high-definition graphic resolution ''etc''}}
+[[File:Viper Griff Specgloss.png|thumb|right|640px|Griff's PBR "SpecGloss Viper"]]
 Traditionally, the surface appearance of ships in Oolite has been defined entirely by textures specified in the ship’s model file and the ''[[#smooth|smooth]]'' attribute. Test release 1.67 added support for [[Shaders in Oolite|shaders]], and test release 1.69 expanded this to a more flexible '''material model'''. Under the new model, the texture file names in model files have been repurposed as '''material keys'''. A material key specifies an entry in the ship’s '''material dictionary''', specified in the ship’s ''[[shipdata.plist]]'' entry. For backwards compatibility, if no material of a given name is found, a material is generated using the material key as a diffuse texture name – providing the same functionality as previous versions of Oolite.
-This page documents the material model as of Oolite test release 1.74 (2010), and applies to stable release 1.76 (2011) and later.
+This page documents the old material model as of Oolite test release 1.74 (2010), and applies to stable release 1.76 (2011) and later.
+__TOC__
 == Important concepts ==
 The following concepts are important in understanding how materials work and how they interact with lights.
@@ Line 209: / Line 225: @@
 |-
 |}
 === Material dictionary example ===
@@ Line 224: / Line 241: @@
 Here, the “cube-face” material is assigned the diffuse texture “oolite_shader_test_suite_7_diffuse.png” and a combined emission and illumination map (which is a greyscale+alpha texture). The emission and illumination components are then given coloured tints (slightly green and slightly blue, respectively), producing this:
-[[File:Oolite Material Test Suite 7.png|320px]]
+[[File:Oolite Material Test Suite 7.png|thumb|320px|right|[[Material Test Suite OXP]] ]]
 [[Category: Oolite]] [[Category:Oolite_scripting]]

@@ Line 228: / Line 228: @@
 [[File:Viper Griff Specgloss.png|thumb|right|640px|Griff's SpecGloss Viper]]
 == See also ==
 * [https://bb.oolite.space/viewtopic.php?p=285081#p285081 Specular Maps Alpha channel]: more by a_c_ (2022)
 * [https://bb.oolite.space/viewtopic.php?f=4&t=21170 griff SpecGloss ships]: some q's & a's about colour corrections (2022)
-:Also contains Griff's SpecGloss models of the Cobra Mk.1, Gecko, Mamba, Sidewinder & Viper
+:Also contains
 * [https://bb.oolite.space/viewtopic.php?p=293033#p293033 Is there a (shipdata) variable with which I can reduce the amount of influence an emission or illumination map has?] (2023) Answers involve using the varieties of "_modulate_color" listed above - and shows an example of what happens.
 [[Category: Oolite]] [[Category:Oolite_scripting]]

← Older revision		Revision as of 22:24, 3 August 2026
Line 1:		Line 1:
−	Since v.1.87 (August 2018), more advanced options have become available. See [https://bb.oolite.space/viewtopic.php?f=2&t=19881 A Description of the Improved Lighting and Materials System] (2018), the attached update of Oct 2018 and the clarifications of May 2021.	+	Since v.1.87 (August 2018), more advanced options have become available. See [https://bb.oolite.space/viewtopic.php?f=2&t=19881 A Description of the Improved Lighting and Materials System] (2018), the attached update of Oct 2018 and the clarifications of May 2021. Oolite now supports the basic PBR (Physically Based Rendering) materials, using the new Oolite shaders system. The requirements are light energy conservation, a microfacet surface model and a physically based Bidirectional Reflective Distribution Function (BRDF)

	{{OXPNote\|This page was last properly edited in 2013, well after the introduction of shaders but before [[User:Another commander\|Another commander]]'s work on Oolite introducing specular & gloss maps, the new Oren-Nayar diffuse light model, high-definition graphic resolution ''etc''}}		{{OXPNote\|This page was last properly edited in 2013, well after the introduction of shaders but before [[User:Another commander\|Another commander]]'s work on Oolite introducing specular & gloss maps, the new Oren-Nayar diffuse light model, high-definition graphic resolution ''etc''}}

@@ Line 1: / Line 1: @@
-Since v.1.87 (August 2018), more advanced options have become available. See [http://www.aegidian.org/bb/viewtopic.php?f=2&t=19881 A Description of the Improved Lighting and Materials System] (2018), the attached update of Oct 2018 and the clarifications of May 2021.
+Since v.1.87 (August 2018), more advanced options have become available. See [https://bb.oolite.space/viewtopic.php?f=2&t=19881 A Description of the Improved Lighting and Materials System] (2018), the attached update of Oct 2018 and the clarifications of May 2021.
 {{OXPNote|This page was last properly edited in 2013, well after the introduction of shaders but before [[User:Another commander|Another commander]]'s work on Oolite introducing specular & gloss maps, the new Oren-Nayar diffuse light model, high-definition graphic resolution ''etc''}}
@@ Line 230: / Line 230: @@
 * [[Material Test Suite OXP]] — demonstrates most material properties.
 * [[Library OXP]] also has a couple of add-on tools ([[MatFinder]] & DevTools) which enable you to play around with all this and see the effects
-* [http://www.aegidian.org/bb/viewtopic.php?p=285081#p285081 Specular Maps Alpha channel]: more by a_c_ (2022)
+* [https://bb.oolite.space/viewtopic.php?p=285081#p285081 Specular Maps Alpha channel]: more by a_c_ (2022)
-* [http://www.aegidian.org/bb/viewtopic.php?f=4&t=21170 griff SpecGloss ships]: some q's & a's about colour corrections (2022)
+* [https://bb.oolite.space/viewtopic.php?f=4&t=21170 griff SpecGloss ships]: some q's & a's about colour corrections (2022)
 :Also contains Griff's SpecGloss models of the Cobra Mk.1, Gecko, Mamba, Sidewinder & Viper
-* [http://aegidian.org/bb/viewtopic.php?p=293033#p293033 Is there a (shipdata) variable with which I can reduce the amount of influence an emission or illumination map has?] (2023) Answers involve using the varieties of "_modulate_color" listed above - and shows an example of what happens.
+* [https://bb.oolite.space/viewtopic.php?p=293033#p293033 Is there a (shipdata) variable with which I can reduce the amount of influence an emission or illumination map has?] (2023) Answers involve using the varieties of "_modulate_color" listed above - and shows an example of what happens.
 [[Category: Oolite]] [[Category:Oolite_scripting]]

@@ Line 229: / Line 229: @@
 == See also ==
 * [[Material Test Suite OXP]] — demonstrates most material properties.
 * [http://www.aegidian.org/bb/viewtopic.php?p=285081#p285081 Specular Maps Alpha channel]: more by a_c_ (2022)
 * [http://www.aegidian.org/bb/viewtopic.php?f=4&t=21170 griff SpecGloss ships]: some q's & a's about colour corrections (2022)