missing info actually. don't put stub in fields leave them empty
(4 intermediate revisions by 3 users not shown)
Line 2:
Line 2:
<translate>
<translate>
<!--T:1-->
<!--T:1-->
{{stub}}
{{Infobox Component
{{Infobox Component
|Image=GrayscaleMaterialComponent.png
|Image=GrayscaleMaterialComponent.png
|Name=GrayscaleMaterial
|Name=GrayscaleMaterial
}}
}}
The '''GrayscaleMaterial''' component is a material that allows the mapping of grayscale values from 0 to 1 to any other value. This is analogous to the [https://docs.blender.org/manual/en/latest/render/shader_nodes/converter/color_ramp.html Color Ramp] node in Blender. A common misconception is that this can only produce black and white values, however that is only the default gradient, and a user-provided '''Gradient''' texture allows for various colored effects.
<!--T:2-->
== Introduction ==
GrayscaleMaterial is a material that allows the mapping of grayscale values from 0 to 1 to any other value. This is analogous to the [https://docs.blender.org/manual/en/latest/render/shader_nodes/converter/color_ramp.html Color Ramp] node in Blender. A common misconception is that this can only produce black and white values, however that is only the default gradient, and a user-provided '''Gradient''' texture allows for various colored effects.
|RatioRed|Float|The proportion of red to use for grayscale computation
|RatioRed|Float|The proportion of red to use for grayscale computation
|RatioGreen|Float|The proportion of green to use for grayscale computation
|RatioGreen|Float|The proportion of green to use for grayscale computation
Line 32:
Line 27:
|Lerp|Float|How much to passthrough of the original (0) or use the filter (1)
|Lerp|Float|How much to passthrough of the original (0) or use the filter (1)
|Gradient|{{RootFieldType|AssetRef`1|[[Type:ITexture2D|ITexture2D]]}}|TypeAdv15=true|A texture which maps black values on its far left and white values on its far right
|Gradient|{{RootFieldType|AssetRef`1|[[Type:ITexture2D|ITexture2D]]}}|TypeAdv15=true|A texture which maps black values on its far left and white values on its far right
The GrayscaleMaterial component is a material that allows the mapping of grayscale values from 0 to 1 to any other value. This is analogous to the Color Ramp node in Blender. A common misconception is that this can only produce black and white values, however that is only the default gradient, and a user-provided Gradient texture allows for various colored effects.
If true, integrating this asset (e.g. processing procedural assets) gets higher priority than assets with this flag off. An example is user laser procedural meshes.
The Stencil ID of this material. This is sometimes written to the frame buffer's Stencil mask, or used to determine whether this material should render for a particular pixel.
does a Bitwise AND with this number for every pixel in the frame buffer this is rendering on top of when this object is drawn, after reading from the buffer.
Determines whether this object should render when it is in front of or behind other objects that respect depth from the camera
Behavior
This material acts as a filter which applies on top of other materials.
It first computes a grayscale value for all pixels that overlap with the filter which is computed through a weighted combination of Red, Green, and Blue values that can be directly controlled through the respective ratio inputs.
A user-provided Gradient texture defines how these values are then remapped. The leftmost part of this texture defines what color will correspond to Black (0) and the rightmost part of this texture defines the color that maps to White (1). It is important to set the WrapModeU of this texture to Clamp or else it will bleed values from either side of the texture.
The Lerp field allows you to transition between having the filter off (0) and fully on (1).
Examples
Without GrayscaleMaterial appliedDefault GrayscaleMaterialGrayscaleMaterial with a rainbow Gradient texture
