Shader Creation - Revision history

Merlyn: /* Per-pass shader definitions */

2018-01-30T09:17:54Z

Per-pass shader definitions

← Older revision		Revision as of 02:17, 30 January 2018
Line 117:		Line 117:

	==Per-pass shader definitions==		==Per-pass shader definitions==

			These are added to all shaders, based on which drawing pass the game is doing at the time.

			They are effectively added as <code>'''#define FIELD_NAME'''</code> lines at the beginning of the shader.

	* <code>'''#SHADOW_CASCADE'''</code> - Set during the shadow drawing pass (TODO: Is this accurate?)		* <code>'''#SHADOW_CASCADE'''</code> - Set during the shadow drawing pass (TODO: Is this accurate?)

Merlyn: /* Global shader definitions */

2018-01-30T09:17:17Z

Global shader definitions

← Older revision		Revision as of 02:17, 30 January 2018
Line 101:		Line 101:
	* Every flag in the level's <code>'''Custom Shader'''</code> script param gets added to all shaders		* Every flag in the level's <code>'''Custom Shader'''</code> script param gets added to all shaders
	* Every flag in the level's <code>'''GPU Particle Field'''</code> script param gets added when GPU particle fields are drawn		* Every flag in the level's <code>'''GPU Particle Field'''</code> script param gets added when GPU particle fields are drawn
	* <code>'''#NO_VELOCITY_BUF'''</code> - Velocity buffer is set to zero. Turns off velocity buffer calculations
	* <code>'''#SIMPLE_SHADOW'''</code> - Simple shadow option is enabled. Turns off sun-based shadow calculations		* <code>'''#SIMPLE_SHADOW'''</code> - Simple shadow option is enabled. Turns off sun-based shadow calculations
	* <code>'''#SIMPLE_WATER'''</code> - Simple water option is enabled. Turns off reflections on water		* <code>'''#SIMPLE_WATER'''</code> - Simple water option is enabled. Turns off reflections on water
	* <code>'''#SIMPLE_FOG'''</code> - Simple fog option is enabled. Turns off more complex noise-based fog calculations and uses a simplified fog model instead		* <code>'''#SIMPLE_FOG'''</code> - Simple fog option is enabled. Turns off more complex noise-based fog calculations and uses a simplified fog model instead
	* <code>'''#NO_REFLECTION_CAPTURE'''</code> - No reflection capture option is enabled. Turns off local cubmap reflections. Force-enabled on low-end GPUs		* <code>'''#NO_REFLECTION_CAPTURE'''</code> - No reflection capture option is enabled. Turns off local cubmap reflections. Force-enabled on low-end GPUs
			* <code>'''#NO_VELOCITY_BUF'''</code> - Velocity buffer is set to zero. Turns off velocity buffer calculations
			* <code>'''#ALPHA_TO_COVERAGE'''</code> - Anti-aliasing is greater than zero. Turns on alpha-to-coverage style alpha blending calculations
			* <code>'''#DISABLE_FOG'''</code> - Disable fog debug option is enabled. Turns off fog calculations
	* <code>'''#NO_DETAILMAPS'''</code> - No detail maps debug option is enabled. Turns off detail map texture lookups, and only uses the base non-detailed color map		* <code>'''#NO_DETAILMAPS'''</code> - No detail maps debug option is enabled. Turns off detail map texture lookups, and only uses the base non-detailed color map
	* <code>'''#NO_DECALS'''</code> - No decals debug option is enabled. Turns off decal object and environmental blood rendering		* <code>'''#NO_DECALS'''</code> - No decals debug option is enabled. Turns off decal object and environmental blood rendering
	* <code>'''#DISABLE_FOG'''</code> - Disable fog debug option is enabled. Turns off fog calculations
	* <code>'''#ALBEDO_ONLY'''</code> - Albedo only debug option is enabled. Draws only base colors of objects, and disables lighting		* <code>'''#ALBEDO_ONLY'''</code> - Albedo only debug option is enabled. Draws only base colors of objects, and disables lighting
	* <code>'''#SSAO_TEST'''</code> - Ssao debug option is enabled. This is a prototype of SSAO, and is not recommended for normal use		* <code>'''#SSAO_TEST'''</code> - Ssao debug option is enabled. This is a prototype of SSAO, and is not recommended for normal use
Line 114:		Line 115:
	* <code>'''#CAN_USE_LIGHT_PROBES'''</code> - Deprecated: Enabled if probe lighting is enabled (disabled by default)		* <code>'''#CAN_USE_LIGHT_PROBES'''</code> - Deprecated: Enabled if probe lighting is enabled (disabled by default)
	* <code>'''#CAN_USE_3D_TEX'''</code> - Deprecated: Enabled if probe lighting and ambient light volumes option is enabled (disabled by default)		* <code>'''#CAN_USE_3D_TEX'''</code> - Deprecated: Enabled if probe lighting and ambient light volumes option is enabled (disabled by default)

			==Per-pass shader definitions==

			* <code>'''#SHADOW_CASCADE'''</code> - Set during the shadow drawing pass (TODO: Is this accurate?)
			* <code>'''#DEPTH_ONLY'''</code> - Set when drawing the depth pre-pass (which is done to reduce fragment over-draw), or when doing shadow draw passes (TODO: Is this accurate?)
			* <code>'''#NO_INSTANCE_ID'''</code> - Set when drawing the depth pre-pass (which is done to reduce fragment over-draw), or when doing shadow draw passes (TODO: Is this accurate?)

	==envobj inputs, outputs, uniforms==		==envobj inputs, outputs, uniforms==

Merlyn: /* Global shader definitions */

2018-01-30T08:38:23Z

Global shader definitions

← Older revision		Revision as of 01:38, 30 January 2018
Line 95:		Line 95:
	==Global shader definitions==		==Global shader definitions==

	These are added to all shaders, based on the game's configuration settings		These are added to all shaders, based on the game's configuration settings.

			They are effectively added as <code>'''#define FIELD_NAME'''</code> lines at the beginning of the shader.

	* Every flag in the level's <code>'''Custom Shader'''</code> script param gets added to all shaders		* Every flag in the level's <code>'''Custom Shader'''</code> script param gets added to all shaders

Merlyn: /* Global shader definitions */

2018-01-30T08:37:47Z

Global shader definitions

← Older revision		Revision as of 01:37, 30 January 2018
Line 111:		Line 111:
	* <code>'''#VOLUME_SHADOWS'''</code> - Volume shadow debug option is enabled. This is a prototype of god-rays, and is not recommended for normal use		* <code>'''#VOLUME_SHADOWS'''</code> - Volume shadow debug option is enabled. This is a prototype of god-rays, and is not recommended for normal use
	* <code>'''#CAN_USE_LIGHT_PROBES'''</code> - Deprecated: Enabled if probe lighting is enabled (disabled by default)		* <code>'''#CAN_USE_LIGHT_PROBES'''</code> - Deprecated: Enabled if probe lighting is enabled (disabled by default)
	* <code>'''#CAN_USE_3D_TEX'''</code> - Deprecated: Enabled if probe lighting and ambient light volumes option is enabled		* <code>'''#CAN_USE_3D_TEX'''</code> - Deprecated: Enabled if probe lighting and ambient light volumes option is enabled (disabled by default)

	==envobj inputs, outputs, uniforms==		==envobj inputs, outputs, uniforms==

Merlyn at 08:37, 30 January 2018

2018-01-30T08:37:23Z

← Older revision		Revision as of 01:37, 30 January 2018
Line 92:		Line 92:

	This will be code between <code>'''#ifdef'''</code> or <code>'''"#if define(...)'''</code> sections, and their corresponding <code>'''#endif'''</code>. Be careful, these can be nested, and it may be hard to figure out what is what, unless you're carefully cutting or selecting line-by-line.		This will be code between <code>'''#ifdef'''</code> or <code>'''"#if define(...)'''</code> sections, and their corresponding <code>'''#endif'''</code>. Be careful, these can be nested, and it may be hard to figure out what is what, unless you're carefully cutting or selecting line-by-line.

			==Global shader definitions==

			These are added to all shaders, based on the game's configuration settings

			* Every flag in the level's <code>'''Custom Shader'''</code> script param gets added to all shaders
			* Every flag in the level's <code>'''GPU Particle Field'''</code> script param gets added when GPU particle fields are drawn
			* <code>'''#NO_VELOCITY_BUF'''</code> - Velocity buffer is set to zero. Turns off velocity buffer calculations
			* <code>'''#SIMPLE_SHADOW'''</code> - Simple shadow option is enabled. Turns off sun-based shadow calculations
			* <code>'''#SIMPLE_WATER'''</code> - Simple water option is enabled. Turns off reflections on water
			* <code>'''#SIMPLE_FOG'''</code> - Simple fog option is enabled. Turns off more complex noise-based fog calculations and uses a simplified fog model instead
			* <code>'''#NO_REFLECTION_CAPTURE'''</code> - No reflection capture option is enabled. Turns off local cubmap reflections. Force-enabled on low-end GPUs
			* <code>'''#NO_DETAILMAPS'''</code> - No detail maps debug option is enabled. Turns off detail map texture lookups, and only uses the base non-detailed color map
			* <code>'''#NO_DECALS'''</code> - No decals debug option is enabled. Turns off decal object and environmental blood rendering
			* <code>'''#DISABLE_FOG'''</code> - Disable fog debug option is enabled. Turns off fog calculations
			* <code>'''#ALBEDO_ONLY'''</code> - Albedo only debug option is enabled. Draws only base colors of objects, and disables lighting
			* <code>'''#SSAO_TEST'''</code> - Ssao debug option is enabled. This is a prototype of SSAO, and is not recommended for normal use
			* <code>'''#VOLUME_SHADOWS'''</code> - Volume shadow debug option is enabled. This is a prototype of god-rays, and is not recommended for normal use
			* <code>'''#CAN_USE_LIGHT_PROBES'''</code> - Deprecated: Enabled if probe lighting is enabled (disabled by default)
			* <code>'''#CAN_USE_3D_TEX'''</code> - Deprecated: Enabled if probe lighting and ambient light volumes option is enabled

	==envobj inputs, outputs, uniforms==		==envobj inputs, outputs, uniforms==

Merlyn: /* envobj inputs, outputs, uniforms */

2018-01-30T07:24:20Z

envobj inputs, outputs, uniforms

← Older revision		Revision as of 00:24, 30 January 2018
Line 99:		Line 99:
	'''TODO''': This might just be for envobject.frag - Might need to look at envobject.vert, etc		'''TODO''': This might just be for envobject.frag - Might need to look at envobject.vert, etc

	<code>		<code><pre>
	in vec3 world_vert; // Always		in vec3 world_vert; // Always
	in float alpha; // #GPU_PARTICLE_FIELD		in float alpha; // #GPU_PARTICLE_FIELD
Line 279:		Line 279:
	uniform vec2 viewport_dims; // #PARTICLE		uniform vec2 viewport_dims; // #PARTICLE
	uniform vec3 ws_light; // #GPU_PARTICLE_FIELD, #SKY		uniform vec3 ws_light; // #GPU_PARTICLE_FIELD, #SKY
	</code>		</pre></code>

Merlyn at 07:23, 30 January 2018

2018-01-30T07:23:16Z

← Older revision		Revision as of 00:23, 30 January 2018
Line 93:		Line 93:
	This will be code between <code>'''#ifdef'''</code> or <code>'''"#if define(...)'''</code> sections, and their corresponding <code>'''#endif'''</code>. Be careful, these can be nested, and it may be hard to figure out what is what, unless you're carefully cutting or selecting line-by-line.		This will be code between <code>'''#ifdef'''</code> or <code>'''"#if define(...)'''</code> sections, and their corresponding <code>'''#endif'''</code>. Be careful, these can be nested, and it may be hard to figure out what is what, unless you're carefully cutting or selecting line-by-line.

	==~~Standard object~~ inputs, outputs, uniforms==		==envobj inputs, outputs, uniforms==

	'''TODO''': Just dumping here for now. Will document/arrange them more clearly later		'''TODO''': Just dumping here for now. Will document/arrange them more clearly later

			'''TODO''': This might just be for envobject.frag - Might need to look at envobject.vert, etc

	<code>		<code>

Merlyn at 07:22, 30 January 2018

2018-01-30T07:22:33Z

Show changes

Merlyn: /* Making a custom shader */

2018-01-29T23:29:24Z

Making a custom shader

← Older revision		Revision as of 16:29, 29 January 2018
Line 89:		Line 89:
	# Start editing <code>'''Data/GLSL/EnvobjectEx.vert'''</code> and <code>'''Data/GLSL/EnvobjectEx.frag'''</code> to set your own custom behavior.		# Start editing <code>'''Data/GLSL/EnvobjectEx.vert'''</code> and <code>'''Data/GLSL/EnvobjectEx.frag'''</code> to set your own custom behavior.

	The <code>'''envobject.*'''</code> shader programs that you copied the code from have a lot of extra code in them.		The <code>'''envobject.*'''</code> shader programs that you copied the code from have a lot of extra code in them. It might be useful to start by very carefully cutting out code out that you know doesn't apply.
	It might be useful to start by very carefully cutting out code out that you know doesn't apply.
	This will be code between <code>'''#ifdef'''</code> or <code>'''"#if define(...)'''</code> sections, and their corresponding <code>'''#endif'''</code>.		This will be code between <code>'''#ifdef'''</code> or <code>'''"#if define(...)'''</code> sections, and their corresponding <code>'''#endif'''</code>. Be careful, these can be nested, and it may be hard to figure out what is what, unless you're carefully cutting or selecting line-by-line.
	Be careful, these can be nested, and it may be hard to figure out what is what, unless you're carefully cutting or selecting line-by-line.

Merlyn: /* Making a custom shader */

2018-01-29T23:29:00Z

Making a custom shader

← Older revision		Revision as of 16:29, 29 January 2018
Line 89:		Line 89:
	# Start editing <code>'''Data/GLSL/EnvobjectEx.vert'''</code> and <code>'''Data/GLSL/EnvobjectEx.frag'''</code> to set your own custom behavior.		# Start editing <code>'''Data/GLSL/EnvobjectEx.vert'''</code> and <code>'''Data/GLSL/EnvobjectEx.frag'''</code> to set your own custom behavior.

	The <code>'''envobject.*'''</code> shader programs have a lot of code in them~~, so it~~ might be useful to start by very carefully cutting out code out that you know doesn't apply.		The <code>'''envobject.*'''</code> shader programs that you copied the code from have a lot of extra code in them.
			It might be useful to start by very carefully cutting out code out that you know doesn't apply.
	This will be code between <code>'''#ifdef'''</code> or <code>'''"#if define(...)'''</code> sections, and their corresponding <code>'''#endif'''</code>.		This will be code between <code>'''#ifdef'''</code> or <code>'''"#if define(...)'''</code> sections, and their corresponding <code>'''#endif'''</code>.
	Be careful, these can be nested, and it may be hard to figure out what is what, unless you're carefully cutting or selecting line-by-line.		Be careful, these can be nested, and it may be hard to figure out what is what, unless you're carefully cutting or selecting line-by-line.