Shaders in Oolite - Revision history

Cholmondely: Added a_c's "update" synopsis

2026-08-03T22:06:59Z

Added a_c's "update" synopsis

Phkb: Updating BB links

2024-02-29T03:24:01Z

Updating BB links

Cholmondely: /* Links */ Added more

2022-12-31T20:05:08Z

‎Links: Added more

Cholmondely: /* Links */ Added link to Getafix's Video

2022-09-16T08:24:22Z

‎Links: Added link to Getafix's Video

Cholmondely: Added Links and note on 2010 provenance

2022-04-02T21:30:21Z

Added Links and note on 2010 provenance

Ahruman: /* Macros */ Updated with correct version info.

2010-02-28T18:07:11Z

‎Macros: Updated with correct version info.

Eric Walch: Added scripting category

2010-02-10T20:22:09Z

Added scripting category

Ahruman: Removed “will be removed in 1.6x” stuff.

2008-11-30T14:16:03Z

Removed “will be removed in 1.6x” stuff.

Ahruman: /* Macros */

2008-11-21T23:09:59Z

‎Macros

Ahruman: Updated old information.

2007-07-11T17:29:49Z

Updated old information.

← Older revision		Revision as of 22:06, 3 August 2026
Line 1:		Line 1:
−	<small>'''''See also:''' [[Materials in Oolite]]''</small>	+	Update!
		+	* The first major shader revision occurred with Oolite v1.88 (2018) with the introduction of materials supporting Physically Based Rendering (PBR).
		+	The basic PBR requirements are light energy conservation, microfacet surface model and physically based Bidirectional Reflective Distribution Function (BRDF)
		+	* Shaders changed further in Oolite v1.90 (2020) with the addition of filmic tone mapping, Oren-Nayar diffuse light model and increased light source radiance
		+	* Shaders changed again in Oolite v1.92 (2026) with a reworked renderer combining all the above plus adoption of PBR for all core ships and planets, full post-processing effects support including FXAA, specular anti-aliasing, HDR output support (Windows only), multiple tonemapper options both for SDR and HDR, optional alternative Burley diffuse light model and more.
		+
		+	<small>'''''This page was written by Ahruman between 2007-10<br>
		+	'''''See also:''' [[Materials in Oolite]]''</small>

	'''Shaders''' are programs which run on a graphics processing unit. They provide a more flexible alternative or supplement to textures for specifying objects’ appearance. There are two widely-used types of shader, '''vertex shaders''' and '''fragment shaders''' (also known, less accurately, as '''pixel shaders'''), which are generally used in combination. Shaders can be implemented in a number of special-purpose programming languages; [[Oolite]] uses the '''[http://en.wikipedia.org/wiki/GLSL OpenGL Shading Language]''', also known as '''GLslang''' or '''GLSL'''.		'''Shaders''' are programs which run on a graphics processing unit. They provide a more flexible alternative or supplement to textures for specifying objects’ appearance. There are two widely-used types of shader, '''vertex shaders''' and '''fragment shaders''' (also known, less accurately, as '''pixel shaders'''), which are generally used in combination. Shaders can be implemented in a number of special-purpose programming languages; [[Oolite]] uses the '''[http://en.wikipedia.org/wiki/GLSL OpenGL Shading Language]''', also known as '''GLslang''' or '''GLSL'''.

@@ Line 133: / Line 133: @@
 == Links ==
 *[[OXP howto texture]] (mostly 2006, but with up-to-date links)
-*[http://aegidian.org/bb/viewtopic.php?f=4&t=3460 Shader's Outpost thread] (2007-date) with links and downloadable .oxp examples
+*[https://bb.oolite.space/viewtopic.php?f=4&t=3460 Shader's Outpost thread] (2007-date) with links and downloadable .oxp examples
-*[http://aegidian.org/bb/viewtopic.php?f=4&t=13815 A request for a simple example of using shaders] (2013)
+*[https://bb.oolite.space/viewtopic.php?f=4&t=13815 A request for a simple example of using shaders] (2013)
 *[https://www.youtube.com/watch?v=hWeN_66guzg Oolite Crosire's Reshade Tutorial] (2015 YouTube video - by Getafix - using Crosire's Reshade v1.0.0 post-processing injector)

@@ Line 133: / Line 133: @@
 == Links ==
 *[[OXP howto texture]] (mostly 2006, but with up-to-date links)
 *[http://aegidian.org/bb/viewtopic.php?f=4&t=13815 A request for a simple example of using shaders] (2013)
 *[https://www.youtube.com/watch?v=hWeN_66guzg Oolite Crosire's Reshade Tutorial] (2015 YouTube video - by Getafix - using Crosire's Reshade v1.0.0 post-processing injector)
 [[Category:Oolite]]
 [[Category:Oolite scripting]]

@@ Line 134: / Line 134: @@
 *[[OXP howto texture]] (mostly 2006, but with up-to-date links)
 *[http://aegidian.org/bb/viewtopic.php?f=4&t=13815 A request for a simple example of using shaders] (2013)
 [[Category:Oolite]]
 [[Category:Oolite scripting]]

@@ Line 5: / Line 5: @@
 Shaders are supported in Oolite 1.67 for Mac OS X and later, and from 1.68 on other platforms. However, the shader support is still evolving. This page currently documents the state in Oolite 1.72.
 == Specifying shaders ==
@@ Line 129: / Line 130: @@
 == Limitations ==
 The current implementation does not provide the information necessary to implement the most common form of [http://en.wikipedia.org/wiki/Normal_mapping normal mapping].
 [[Category:Oolite]]
 [[Category:Oolite scripting]]

@@ Line 118: / Line 118: @@
 | <code>OO_LIGHT_0_FIX</code>||In current versions of Oolite, light number 0 is effectively always attached to the camera, giving the effect of the player shining a light on anything they’re looking at. When this is fixed, <code>OO_LIGHT_0_FIX</code> will be defined. (Not yet defined in any version of Oolite.)
 |-
-| <code>OO_REDUCED_COMPLEXITY</code>||Defined if user has selected lower-complexity shaders. (Not yet defined in any version of Oolite.)
+| <code>OO_REDUCED_COMPLEXITY</code>||Defined if user has selected lower-complexity shaders.
 |-
 | <code>OO_TEXTURE_UNIT_COUNT</code>||An integer specifying the number of texture units supported by hardware, which is the maximum number of ''tex'''N''''' uniforms that will be meaningful. This should be the same as ''gl_MaxTextureUnits'', but a macro has the advantage that it can be used to completely exclude parts of the shader. (Defined in Oolite 1.69 and later.)
@@ Line 124: / Line 124: @@
 | <code>OO_USER_DEFINED_BINDINGS</code>||Defined to indicate that [[Shaders in Oolite: uniforms|arbitrary uniform bindings]] are available. (Defined in Oolite 1.69 and later.)
 |-
-| <code>OO_TANGENT_ATTR</code>||Defined to indicate that the <code>tangent</code> vertex attribute is available. Expected to be defined in Oolite 1.73.
+| <code>OO_TANGENT_ATTR</code>||Defined to indicate that the <code>tangent</code> vertex attribute is available. (Defined in Oolite 1.73 and later.)
 |}

← Older revision		Revision as of 20:22, 10 February 2010
Line 131:		Line 131:

	[[Category:Oolite]]		[[Category:Oolite]]
		+	[[Category:Oolite scripting]]

@@ Line 1: / Line 1: @@
 '''Shaders'''  are programs which run on a graphics processing unit. They provide a more flexible alternative or supplement to textures for specifying objects’ appearance. There are two widely-used types of shader, '''vertex shaders''' and '''fragment shaders''' (also known, less accurately, as '''pixel shaders'''), which are generally used in combination. Shaders can be implemented in a number of special-purpose programming languages; [[Oolite]] uses the '''[http://en.wikipedia.org/wiki/GLSL OpenGL Shading Language]''', also known as '''GLslang''' or '''GLSL'''.
-Shaders are supported in Oolite 1.67 for Mac OS X and later, and from 1.68 on other platforms. However, the shader support is still evolving. This page currently documents the state in Oolite 1.69 and 1.69.1.
+Shaders are supported in Oolite 1.67 for Mac OS X and later, and from 1.68 on other platforms. However, the shader support is still evolving. This page currently documents the state in Oolite 1.72.
@@ Line 13: / Line 15: @@
 |-
 | ''vertex_shader'' || string || The name of a vertex shader file to use. Oolite will search the Shaders folder of all installed OXPs for a shader of the appropriate name. (Requires Oolite 1.68 or later.)
 |-
 | ''fragment_shader'' || string || The name of a fragment shader file to use. Oolite will search the Shaders folder of all installed OXPs for a shader of the appropriate name. (Requires Oolite 1.68 or later.)
 |-
 | ''uniforms'' || dictionary || Uniforms to pass to the shaders.

@@ Line 1: / Line 1: @@
 '''Shaders'''  are programs which run on a graphics processing unit. They provide a more flexible alternative or supplement to textures for specifying objects’ appearance. There are two widely-used types of shader, '''vertex shaders''' and '''fragment shaders''' (also known, less accurately, as '''pixel shaders'''), which are generally used in combination. Shaders can be implemented in a number of special-purpose programming languages; [[Oolite]] uses the '''[http://en.wikipedia.org/wiki/GLSL OpenGL Shading Language]''', also known as '''GLslang''' or '''GLSL'''.
-Shaders are supported in Oolite 1.67 for Mac OS X and later. At the time of writing, no released version of Oolite for other platforms supports shaders, but version 1.68 for Windows will.
+Shaders are supported in Oolite 1.67 for Mac OS X and later, and from 1.68 on other platforms. However, the shader support is still evolving. This page currently documents the state in Oolite 1.69 and 1.69.1.
@@ Line 14: / Line 14: @@
 | ''vertex_shader'' || string || The name of a vertex shader file to use. Oolite will search the Shaders folder of all installed OXPs for a shader of the appropriate name. (Requires Oolite 1.68 or later.)
 |-
-| ''glsl-vertex'' || string || GLslang code to use as a vertex shader. This is ignored if ''vertex_shader'' is specified. ('''Deprecated''' – may be removed in Oolite 1.69.)
+| ''glsl-vertex'' || string || GLslang code to use as a vertex shader. This is ignored if ''vertex_shader'' is specified. ('''Deprecated''' – will be removed after Oolite 1.69.1.)
 |-
 | ''fragment_shader'' || string || The name of a fragment shader file to use. Oolite will search the Shaders folder of all installed OXPs for a shader of the appropriate name. (Requires Oolite 1.68 or later.)
 |-
-| ''glsl-fragment'' || string || GLslang code to use as a fragment shader. This is ignored if ''fragment_shader'' is specified. ('''Deprecated''' – may be removed in Oolite 1.69.)
+| ''glsl-fragment'' || string || GLslang code to use as a fragment shader. This is ignored if ''fragment_shader'' is specified. '''Deprecated''' – will be removed after Oolite 1.69.1.)
 |-
-| ''glsl'' || string || Synonym for ''glsl-fragment''. ('''Deprecated''' – may be removed in Oolite 1.69.)
+| ''glsl'' || string || Synonym for ''glsl-fragment''. '''Deprecated''' – will be removed after Oolite 1.69.1.)
 |-
 | ''uniforms'' || dictionary || Uniforms to pass to the shaders.