Hardware Shaders - Revision history

Plasma at 15:49, 18 May 2024

2024-05-18T15:49:55Z

← Older revision		Revision as of 15:49, 18 May 2024
Line 12:		Line 12:
	*# Go to <code>Object -> Material -> RenderedMaterial -> HardwareShader</code> and open its properties		*# Go to <code>Object -> Material -> RenderedMaterial -> HardwareShader</code> and open its properties
	*# Insert the following for the <code>VertexShaderText</code> and <code>PixelShaderText</code> properties (Edit them via the <code>...</code> button and hit Apply):		*# Insert the following for the <code>VertexShaderText</code> and <code>PixelShaderText</code> properties (Edit them via the <code>...</code> button and hit Apply):
	# VertexShaderText:<blockquote>vs.1.1~~<br>~~<br>mov oPos, v0</blockquote>		# VertexShaderText:<blockquote>vs.1.1<br>mov oPos, v0</blockquote>
	# PixelShaderText:<blockquote>ps.1.1~~<br>~~<br>mov r0, c0</blockquote>		# PixelShaderText:<blockquote>ps.1.1<br>mov r0, c0</blockquote>

Plasma at 15:46, 18 May 2024

2024-05-18T15:46:04Z

← Older revision		Revision as of 15:46, 18 May 2024
Line 44:		Line 44:

	[[File:ShaderProperties.jpg]]		[[File:ShaderProperties.jpg]]


	* VertexShaderText:<syntaxhighlight>		* VertexShaderText:<syntaxhighlight>

Plasma at 15:45, 18 May 2024

2024-05-18T15:45:40Z

← Older revision		Revision as of 15:45, 18 May 2024
Line 7:		Line 7:
	A HardwareShader is a built-in material class and a new one can be created via the texture browser. Note that this might crash UnrealEd unless you have applied either of the following fixes:		A HardwareShader is a built-in material class and a new one can be created via the texture browser. Note that this might crash UnrealEd unless you have applied either of the following fixes:

	* Install the [[Republic Commando Fix]]		* Install the [https://github.com/SWRC-Modding/CT/releases Republic Commando Fix]
	* Edit the properties of the HardwareShader class		* Edit the properties of the HardwareShader class
	*# Go to the Actor class browser and uncheck <code>Use \"Actor\" as Parent?</code> and <code>Placeable classes Only?</code>		*# Go to the Actor class browser and uncheck <code>Use \"Actor\" as Parent?</code> and <code>Placeable classes Only?</code>

Plasma at 15:41, 18 May 2024

2024-05-18T15:41:26Z

← Older revision		Revision as of 15:41, 18 May 2024
Line 45:		Line 45:
	[[File:ShaderProperties.jpg]]		[[File:ShaderProperties.jpg]]

	* VertexShaderText:<syntaxhighlight>~~\nvs~~.1.1~~\n\nm4x4~~ oPos, v0, c0 ;Multiply the vertex position with the transformation matrix and write it to oPos~~\nmov~~ oT0, v1 ;Pass through the texture coordinate\n</syntaxhighlight>		* VertexShaderText:<syntaxhighlight>
	* PixelShaderText:<syntaxhighlight>~~\nps~~.1.4~~\n\ntexld~~ r0, t0 ;Write texture 0 to r0 (t0 is the texture coordinate, the texture index is based on the destination register r0)</syntaxhighlight>		vs.1.1
			m4x4 oPos, v0, c0 ;Multiply the vertex position with the transformation matrix and write it to oPos
			mov oT0, v1 ;Pass through the texture coordinate
			</syntaxhighlight>
			* PixelShaderText:<syntaxhighlight>
			ps.1.4
			texld r0, t0 ;Write texture 0 to r0 (t0 is the texture coordinate, the texture index is based on the destination register r0)
			</syntaxhighlight>

Plasma at 15:38, 18 May 2024

2024-05-18T15:38:27Z

← Older revision		Revision as of 15:38, 18 May 2024
Line 20:		Line 20:
	* Fill in the Package, Group and Name fields		* Fill in the Package, Group and Name fields
	* For the MaterialClass select <code>HardwareShader</code> from the list<br>[[File:CreateShader.jpg]]		* For the MaterialClass select <code>HardwareShader</code> from the list<br>[[File:CreateShader.jpg]]


	* Click on <code>New</code> and the properties window for the new material will appear. (You can ignore the error at the bottom)<br>[[File:NewShader.jpg]]		* Click on <code>New</code> and the properties window for the new material will appear. (You can ignore the error at the bottom)<br>[[File:NewShader.jpg]]


	* Depending on what kind of shader you are creating you might want to set <code>ZTest</code> and <code>ZWrite</code> to <code>true</code> as they are not set by default.		* Depending on what kind of shader you are creating you might want to set <code>ZTest</code> and <code>ZWrite</code> to <code>true</code> as they are not set by default.

Plasma at 15:37, 18 May 2024

2024-05-18T15:37:50Z

← Older revision		Revision as of 15:37, 18 May 2024
Line 20:		Line 20:
	* Fill in the Package, Group and Name fields		* Fill in the Package, Group and Name fields
	* For the MaterialClass select <code>HardwareShader</code> from the list<br>[[File:CreateShader.jpg]]		* For the MaterialClass select <code>HardwareShader</code> from the list<br>[[File:CreateShader.jpg]]

	* Click on <code>New</code> and the properties window for the new material will appear. (You can ignore the error at the bottom)<br>[[File:NewShader.jpg]]		* Click on <code>New</code> and the properties window for the new material will appear. (You can ignore the error at the bottom)<br>[[File:NewShader.jpg]]

	* Depending on what kind of shader you are creating you might want to set <code>ZTest</code> and <code>ZWrite</code> to <code>true</code> as they are not set by default.		* Depending on what kind of shader you are creating you might want to set <code>ZTest</code> and <code>ZWrite</code> to <code>true</code> as they are not set by default.


	== Writing Shader Code ==		== Writing Shader Code ==

Plasma: Created page with "Note: This is not a guide for the shading assembly language in general. You can find official documentation at Microsoft [https://learn.microsoft.com/en-us/windows/win32/direct3dhlsl/dx9-graphics-reference-asm ASM Shader Reference]. Republic Commando can use VS 1.1 and PS 1.1 to PS 1.4, so make sure you use the correct instructions for the version you want to use. == Creating a new HardwareShader == A HardwareShader is a built-in material class and a new one can be cr..."

2024-05-18T15:31:15Z

Created page with "Note: This is not a guide for the shading assembly language in general. You can find official documentation at Microsoft [https://learn.microsoft.com/en-us/windows/win32/direct3dhlsl/dx9-graphics-reference-asm ASM Shader Reference]. Republic Commando can use VS 1.1 and PS 1.1 to PS 1.4, so make sure you use the correct instructions for the version you want to use. == Creating a new HardwareShader == A HardwareShader is a built-in material class and a new one can be cr..."

New page

Note: This is not a guide for the shading assembly language in general. You can find official documentation at Microsoft [https://learn.microsoft.com/en-us/windows/win32/direct3dhlsl/dx9-graphics-reference-asm ASM Shader Reference].

Republic Commando can use VS 1.1 and PS 1.1 to PS 1.4, so make sure you use the correct instructions for the version you want to use.

== Creating a new HardwareShader ==

A HardwareShader is a built-in material class and a new one can be created via the texture browser. Note that this might crash UnrealEd unless you have applied either of the following fixes:

* Install the [[Republic Commando Fix]]
* Edit the properties of the HardwareShader class
*# Go to the Actor class browser and uncheck <code>Use \"Actor\" as Parent?</code> and <code>Placeable classes Only?</code>
*# Go to <code>Object -> Material -> RenderedMaterial -> HardwareShader</code> and open its properties
*# Insert the following for the <code>VertexShaderText</code> and <code>PixelShaderText</code> properties (Edit them via the <code>...</code> button and hit Apply):
*#* VertexShaderText:<blockquote>vs.1.1 mov oPos, v0</blockquote>
*#* PixelShaderText:<blockquote>ps.1.1 mov r0, c0</blockquote>

Now you are ready to create a new shader object:
* Go to the texture browser and select <code>File -> New...</code>
* Fill in the Package, Group and Name fields
* For the MaterialClass select <code>HardwareShader</code> from the list [[File:CreateShader.jpg]]
* Click on <code>New</code> and the properties window for the new material will appear. (You can ignore the error at the bottom) [[File:NewShader.jpg]]
* Depending on what kind of shader you are creating you might want to set <code>ZTest</code> and <code>ZWrite</code> to <code>true</code> as they are not set by default.

== Writing Shader Code ==

Before you start editing the shader code, it is a good idea to open the Editor log window as errors will appear there.

First you should add the vertex inputs you need to the <code>StreamMapping</code> array. Usually you want the vertex position at the very least so add a new entry and it will be set to <code>FVF_Position</code> by default. The dropdown here is hidden by the insert button so to change the value of the entry just double click it. You can reference those inputs with the <code>v0</code>, <code>v1</code>... registers in the vertex shader.

Other user-defined inputs are passed to the shader with the <code>VSConstants</code> and <code>PSConstants</code> properties. They are arrays where each element defines the type of the constant and four float values (X, Y, Z, W) that are used only if the type of the constant is <code>EVC_MaterialDefined</code>. These values can also be changed in UnrealScript or C++ code so the inputs can be made dynamic.

One important point to note is that all matrix constants (identifiable by their name) take up four slots. This means after a matrix constant you should leave three entries that are set to <code>EVC_Unused</code>. The reason is that each slot has four values but a 4x4 matrix needs 16.

Constants are referenced with <code>c0</code>, <code>c1</code>... in the shader code. There is also the <code>def</code> instruction to create constants in the shader source but that can't be used and will lead to compile errors since the constants are supplied via the arrays.

When editing shader code, it makes sense to place an object in the map and assign the shader as its skin so you can view the changes as you are editing. The shader updates each time you hit <code>Apply</code> in the text editor.

The following shader simply transforms the model to view space and draws it with a texture that is set to the first element of the <code>Textures</code> array in the shader properties:

[[File:ShaderProperties.jpg]]

* VertexShaderText:<syntaxhighlight>\nvs.1.1\n\nm4x4 oPos, v0, c0 ;Multiply the vertex position with the transformation matrix and write it to oPos\nmov oT0, v1 ;Pass through the texture coordinate\n</syntaxhighlight>
* PixelShaderText:<syntaxhighlight>\nps.1.4\n\ntexld r0, t0 ;Write texture 0 to r0 (t0 is the texture coordinate, the texture index is based on the destination register r0)</syntaxhighlight>