Shaders in Oolite - Revision history

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.

Ahruman: /* Uniform reference */ Updated for Oolite 1.69.

2007-07-01T12:51:54Z

‎Uniform reference: Updated for Oolite 1.69.

@@ 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.

@@ Line 108: / Line 108: @@
-== Uniform reference ==
+== Uniforms ==
-:'''This section applies to Oolite 1.67–1.68. The predefined uniforms documented here (except <code>tex0</code>…<code>texN</code>) are deprecated and will not be supported beyond Oolite 1.69. The new, more flexible uniform binding system is documented at [[Shaders in Oolite: uniforms]].'''
+Uniforms are variables whose value is set by the host application, i.e. Oolite. Oolite automatically supplies one uniform of type <code>sampler2D</code> for each texture, named <code>tex0</code>, <code>tex1</code> etc. It is also possible to bind uniforms to certain properties of the entity the shader is being applied to, for instance, its engine level. Additionally, constant values can be specified for uniforms, allowing a single shader to be used on different entities with differences in configuration.
-The uniform variables currently provided by Oolite are:
-{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
+For more information on uniforms, see [[Shaders in Oolite: uniforms]].
 == Macros ==