Jump to content

Template:Shader Documentation: Difference between revisions

From HedgeDocs
VisualWikitext
Justin113D (talk | contribs)
scripters
482 edits
Created page with "<includeonly>{{DISPLAYTITLE:{{{game}}} Shaders - {{{shader name}}}}} [[{{{game}}} Shaders|Return to shaders list]] == Overview == {{SXSG Shader Behavior | model = 2 }} {{{overview}}} === Related shaders === {{{related shaders|}}} == Behavior == {{{behavior|}}} === Vertex Colors === {{{vertex color|This shader does not use vertex colors.}}} == Material Inputs == === Textures === {| class="wikitable" width="100%" |+ !width=1%|{{#tip-text: Name|Name of the material t..."
 
Justin113D (talk | contribs)
scripters
482 edits
m Fixed typo
 
(11 intermediate revisions by the same user not shown)
Line 2: Line 2:
[[{{{game}}} Shaders|Return to shaders list]]
[[{{{game}}} Shaders|Return to shaders list]]
== Overview ==
== Overview ==
{{SXSG Shader Behavior
{{#invoke:ShaderDoc|create_sbo|game={{{game}}}|parameters={{{sbo|}}}}}
| model = 2
}}
{{{overview}}}
{{{overview}}}
 
{{#if:{{{overview bugs|}}}|{{notice
|type=warn
|content={{{overview bugs}}}
It is advised to not used this shader.}}}}
{{#if:{{{related shaders|}}}|
=== Related shaders ===
=== Related shaders ===
{{{related shaders|}}}
{{#invoke:ShaderDoc|shader_link_list
 
|game={{{game}}}
|shaders={{{related shaders}}}
}}|}}
== Behavior ==
== Behavior ==
{{{behavior|}}}
{{{behavior|}}}
 
{{#if:{{{multi tangent|}}}|
=== Multi-tangent ===
{{{multi tangent}}}
|}}
=== Vertex Colors ===
=== Vertex Colors ===
{{{vertex color|This shader does not use vertex colors.}}}
{{{vertex colors|Shader does not use vertex colors}}}
{{#if:{{{bugs|}}}|
=== Bugs ===
{{notice
|type=warn
|content={{{bugs}}}}}}}
<div style="clear: both"/>


== Material Inputs ==
== Material Inputs ==


=== Textures ===
=== Textures ===
 
{{#if:{{{textures|}}}|
{| class="wikitable" width="100%"
{{{!}} class="wikitable" width="100%"
|+
{{!}}+
!width=1%|{{#tip-text: Name|Name of the material texture slot}}
!width=1%{{!}}{{#tip-text: Name|Name of the material texture slot}}
!width=1%|{{#tip-text: Index|Index of the texture slot name, starting from 0; This is important when a shader has the same slot name multiple times, in which case their order determines how each slot is used}}
!width=1%{{!}}{{#tip-text: Index|Index of the texture slot name, starting from 0; This is important when a shader has the same slot name multiple times, in which case their order determines how each slot is used}}
!width=1%|{{#tip-text: UV Index|Which UV map the slot uses, which is either an index from 0 to 3 or "any", in which case the UV map can be selected in the material.  
!width=1%{{!}}{{#tip-text: UV Index|Which UV map the slot uses, which is either an index from 0 to 3 or "any", in which case the UV map can be selected in the material.  
If a model does not have a UV Map for the specified index, then the game will fall back to UV Index 0}}
If a model does not have a UV Map for the specified index, then the game will fall back to UV Index 0}}
!width=1%|{{#tip-text: Kind|General usage format of the texture slot. More precise documentation is found on the right}}
!width=1%{{!}}{{#tip-text: Kind|General usage format of the texture slot. More precise documentation is found on the right}}
!width=24%| {{#tip-text: Red|How the red component of the texture gets used}}
!width=24%{{!}} {{#tip-text: Red|How the red component of the texture gets used}}
!width=24%| {{#tip-text: Green|How the green component of the texture gets used}}
!width=24%{{!}} {{#tip-text: Green|How the green component of the texture gets used}}
!width=24%| {{#tip-text: Blue|How the blue component of the texture gets used}}
!width=24%{{!}} {{#tip-text: Blue|How the blue component of the texture gets used}}
!width=24%| {{#tip-text: Alpha|How the alpha component of the texture gets used}}
!width=24%{{!}} {{#tip-text: Alpha|How the alpha component of the texture gets used}}
|-
{{#invoke:ShaderDoc|shader_table|{{{textures}}}}}
|}
{{!}}}|This shader does not use any textures.}}


=== Parameters ===
=== Parameters ===
 
{{#if:{{{parameters|}}}|
{| class="wikitable" width="100%"
{{{!}} class="wikitable" width="100%"
|+
{{!}}+
!width=1%|{{#tip-text: Name|Name of the parameter}}
!width=1%{{!}}{{#tip-text: Name|Name of the parameter}}
!width=25%|{{#tip-text: X|The first component of the parameter}}
!width=25%{{!}}{{#tip-text: X|The first component of the parameter}}
!width=25%|{{#tip-text: Y|The second component of the parameter}}
!width=25%{{!}}{{#tip-text: Y|The second component of the parameter}}
!width=25%|{{#tip-text: Z|The third component of the parameter}}
!width=25%{{!}}{{#tip-text: Z|The third component of the parameter}}
!width=25%|{{#tip-text: W|The fourth component of the parameter}}
!width=25%{{!}}{{#tip-text: W|The fourth component of the parameter}}
|-
{{#invoke:ShaderDoc|shader_table|{{{parameters}}}}}
|}
{{!}}}|This shader does not use any parameters.}}
 
{{#if:{{{gallery|}}}|
== Gallery ==
{{#tag:gallery|{{{gallery}}}|perrow=4|widths=400px|heights=300px|mode=nolines|}}|}}
== Technical ==
== Technical ==
 
{{{technical|}}}
{| class="mw-collapsible mw-collapsed wikitable" width="300px"
{{#if:{{{features|}}}|
|-
{{{!}} class="mw-collapsible mw-collapsed wikitable" width="300px"
{{!}}-
!Shader Features
!Shader Features
|}
{{#invoke:ShaderDoc|technical_features|{{{features}}}}}
 
{{!}}}|}}<nowiki/></includeonly>
</includeonly>
<noinclude>
<noinclude>
<templatedata>
<templatedata>
{
{
"params": {
    "params": {
         "game": {
         "game": {
"label": "Game",
            "label": "Game",
"description": "Which game this shader belongs to",
            "description": "Which game this shader belongs to",
"type": "string",
            "type": "string",
"required": true
            "required": true
},
        },
"shader name": {
        "shader name": {
"label": "Shader name",
            "label": "Shader name",
"description": "The name of the shader",
            "description": "The name of the shader",
"type": "string",
            "type": "string",
"required": true
            "required": true
},
        },
"overview": {
        "sbo": {
"label": "Overview",
            "label": "Shader behavior overview",
"description": "Overview content",
            "description": "Parameters for the shader behavior overview",
"type": "content",
            "type": "string",
"required": true
            "required": false
},
        },
"related shaders": {
        "overview": {
"label": "Related shaders",
            "label": "Overview",
"description": "List of related shaders",
            "description": "Overview content",
"type": "string",
            "type": "content",
"required": false
            "required": true
},
        },
        "overview bug": {
            "label": "Overview bug",
            "description": "Overview bug content",
            "type": "content",
            "required": false
        },
        "related shaders": {
            "label": "Related shaders",
            "description": "List of related shaders",
            "type": "string",
            "required": false
        },
         "behavior": {
         "behavior": {
"label": "Behavior",
            "label": "Behavior",
"description": "Behavior content",
            "description": "Behavior content",
"type": "content",
            "type": "content",
"required": false
            "required": false
},
        },
         "vertex color": {
        "multi tangent": {
"label": "Vertex color",
            "label": "Multi tangent",
"description": "Vertex color behavior",
            "description": "Multi tangent behavior",
"type": "content",
            "type": "content",
"required": false
            "required": false
},
        },
         "vertex colors": {
            "label": "Vertex color",
            "description": "Vertex color behavior",
            "type": "content",
            "required": false
        },
        "bugs": {
            "label": "Bugs",
            "description": "Bugs in behavior",
            "type": "content",
            "required": false
        },
         "textures": {
         "textures": {
"label": "Textures",
            "label": "Textures",
"description": "Texture table contents; Fields seperated by commas, column spans specified by underscores and rows seperated by semicolons",
            "description": "Texture table contents; Fields seperated by commas, column spans specified by underscores and rows seperated by semicolons",
"type": "content",
            "type": "content",
"required": false
            "required": false
},
        },
         "parameters": {
         "parameters": {
"label": "Parameters",
            "label": "Parameters",
"description": "Parameter table contents; Fields seperated by commas, column spans specified by underscores and rows seperated by semicolons",
            "description": "Parameter table contents; Fields seperated by commas, column spans specified by underscores and rows seperated by semicolons",
"type": "content",
            "type": "content",
"required": false
            "required": false
},
        },
        "gallery": {
            "label": "Gallery contents",
            "description": "Picture gallery contents",
            "type": "string",
            "required": false
        },
         "technical": {
         "technical": {
"label": "Technical",
            "label": "Technical",
"description": "Technical information",
            "description": "Technical information",
"type": "content",
            "type": "content",
"required": false
            "required": false
},
        },
         "features": {
         "features": {
"label": "Shader features (technical)",
            "label": "Shader features (technical)",
"description": "List of technical features that the shader has been compiled with",
            "description": "List of technical features that the shader has been compiled with",
"type": "content",
            "type": "content",
"required": false
            "required": false
}
        }
}
    }
}
}
</templatedata>
</templatedata>
WIP


== Example ==
== Example ==
Line 128: Line 171:
{{Shader Documentation
{{Shader Documentation
| game = Shadow Generations
| game = Shadow Generations
| shader name = Common_dpn
| shader name = Common_dpn
| sbo = model=2,
no_opaque_layer,
no_punch_through_layer,
noise_dithering
| overview = A standard PBR shader with no special behavior.
| overview = A standard PBR shader with no special behavior.
| related shaders = Common_dn,Common_dp,Common_dpn,Common_dpna,Common_dither_dpn}}


| overview bugs =
BUGS!
| related shaders =
Common_dn,
Common_dp,
Common_dpn,
Common_dpna,
Common_dither_dpn
| behavior = Lorem ipsum.
| multi tangent =
Lorem ipsum.
| vertex colors =
* Color is multiplied into the <code>diffuse</code> texture color
* Alpha is multiplied into the <code>diffuse</code> texture alpha
| bugs =
BUGS!
| textures =
diffuse,0,0,[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],[[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,Transparency;
test,1,2,,,,,;
| parameters =
diffuse,[[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,;
PBRFactor
,[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor
,[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor
,[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor
,;
| gallery = File:ShadowGenerations Detail dpnn example.jpg{{!}}How <code>Detail_dpnn</code> is used for cliffs in Rail Canyon to blend in detail normals when the camera is closer to the surface
| technical = lorem ipsum.
| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_deferred_rendering,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi
}}
== Other ==
Outside template
</noinclude>
</noinclude>

Latest revision as of 12:11, 25 August 2025


No description.

Template parameters[Edit template data]

ParameterDescriptionTypeStatus
Gamegame

Which game this shader belongs to

Stringrequired
Shader nameshader name

The name of the shader

Stringrequired
Shader behavior overviewsbo

Parameters for the shader behavior overview

Stringoptional
Overviewoverview

Overview content

Contentrequired
Overview bugoverview bug

Overview bug content

Contentoptional
Related shadersrelated shaders

List of related shaders

Stringoptional
Behaviorbehavior

Behavior content

Contentoptional
Multi tangentmulti tangent

Multi tangent behavior

Contentoptional
Vertex colorvertex colors

Vertex color behavior

Contentoptional
Bugsbugs

Bugs in behavior

Contentoptional
Texturestextures

Texture table contents; Fields seperated by commas, column spans specified by underscores and rows seperated by semicolons

Contentoptional
Parametersparameters

Parameter table contents; Fields seperated by commas, column spans specified by underscores and rows seperated by semicolons

Contentoptional
Gallery contentsgallery

Picture gallery contents

Stringoptional
Technicaltechnical

Technical information

Contentoptional
Shader features (technical)features

List of technical features that the shader has been compiled with

Contentoptional

Example

Return to shaders list

Overview

Shader Behavior Overview
Shader model:

   [2] Standard (PBR)
Uses:


Does not support:

A standard PBR shader with no special behavior.

Warning
BUGS! It is advised to not used this shader.

Related shaders

Behavior

Lorem ipsum.

Multi-tangent

Lorem ipsum.

Vertex Colors

  • Color is multiplied into the diffuse texture color
  • Alpha is multiplied into the diffuse texture alpha

Bugs

Warning
BUGS!

Material Inputs

Textures

Name

Index

UV Index

Kind

Red

Green

Blue

Alpha

diffuse 0 0 Albedo Albedo color Transparency
test 1 2 N/A N/A N/A N/A N/A

Parameters

Name

X

Y

Z

W

diffuse Albedo color N/A
PBRFactor Specular factor Smoothness factor Metallic factor N/A

Gallery

  • How Detail_dpnn is used for cliffs in Rail Canyon to blend in detail normals when the camera is closer to the surface
    How Detail_dpnn is used for cliffs in Rail Canyon to blend in detail normals when the camera is closer to the surface

Technical

lorem ipsum.

Shader Features
is_compute_instancing
is_use_tex_srt_anim
enable_deferred_rendering
enable_alpha_threshold
is_use_gi_prt
is_use_gi_sg
is_use_gi

Other

Outside template

Retrieved from "https://hedgedocs.com/index.php?title=Template:Shader_Documentation&oldid=1121"
Cookies help us deliver our services. By using our services, you agree to our use of cookies.