989onan bot (talk | contribs) Automated: update 'StencilComparison' description,'StencilOperation' description,'StencilID' description,'StencilWriteMask' description,'StencilReadMask' description,'RenderQueue' description,'BlendMode' description,'Sidedness' description,'ZWrite' description,'ZTest' description,'OffsetFactor' description,'OffsetUnits' description, |
add see also |
||
(2 intermediate revisions by the same user not shown) | |||
Line 3: | Line 3: | ||
|Name=UI Text Unlit Material | |Name=UI Text Unlit Material | ||
}} | }} | ||
The '''UI_TextUnlitMaterial''' component is a material used to render text glyphs on a [[UIX]]. It does so via meshes that automatically generates UV maps that map to each character on a font map. Such as [[Component:Text]] and [[Component:TextRenderer]]. | |||
== Usage == | == Usage == | ||
{{Table ComponentFields | {{Table ComponentFields | ||
|HighPriorityIntegration|Bool|{{Asset HighPriorityIntegration Field}} | |HighPriorityIntegration|Bool|{{Asset HighPriorityIntegration Field}} | ||
|_shader|{{RootFieldType|AssetRef`1|[[Type:Shader|Shader]]}}|TypeAdv1=true| | |_shader|{{RootFieldType|AssetRef`1|[[Type:Shader|Shader]]}}|TypeAdv1=true| Internal. | ||
|FontAtlas|{{RootFieldType|AssetRef`1|[[Type:ITexture2D|ITexture2D]]}}|TypeAdv2=true| | |FontAtlas|{{RootFieldType|AssetRef`1|[[Type:ITexture2D|ITexture2D]]}}|TypeAdv2=true| The font to render. | ||
|TintColor|ColorX| | |TintColor|ColorX| The color of the text | ||
|OutlineColor|ColorX| | |OutlineColor|ColorX| The color of the text outline | ||
|BackgroundColor|ColorX| | |BackgroundColor|ColorX| The color of behind each text glyph | ||
|AutoBackgroundColor|Bool| | |AutoBackgroundColor|Bool| Whether to automatically generate the background text color. | ||
|GlyphRenderMethod|GlyphRenderMethod| | |GlyphRenderMethod|GlyphRenderMethod| How to render each glyph or text character. | ||
|PixelRange|Float| | |PixelRange|Float| Sets the distance field range in output pixels. | ||
|FaceDilate|Float| | |FaceDilate|Float| How fat to make the letters like bolding them. | ||
|OutlineThickness|Float| | |OutlineThickness|Float| The thickness of the outline on text for colored outlines. | ||
|FaceSoftness|Float| | |FaceSoftness|Float| How much blurring to do on the edges of the text. | ||
|BlendMode|BlendMode|{{Template:Material_BlendMode_Desc}} | |BlendMode|BlendMode|{{Template:Material_BlendMode_Desc}} | ||
|Sidedness|Sidedness|{{Template:Material_Sidedness_Desc}} | |Sidedness|Sidedness|{{Template:Material_Sidedness_Desc}} | ||
Line 28: | Line 29: | ||
|Overlay|Bool| | |Overlay|Bool| | ||
|OverlayTint|ColorX| | |OverlayTint|ColorX| | ||
|Rect|Rect| | |Rect|Rect| {{Template:Material_Rect}} | ||
|RectClip|Bool| | |RectClip|Bool| {{Template:Material_RectClip}} | ||
|ColorMask|ColorMask| | |ColorMask|ColorMask| {{Template:Material_ColorMask}} | ||
|StencilComparison|StencilComparison|{{Template:Material_StencilComparison_Desc}} | |StencilComparison|StencilComparison|{{Template:Material_StencilComparison_Desc}} | ||
|StencilOperation|StencilOperation|{{Template:Material_StencilOperation_Desc}} | |StencilOperation|StencilOperation|{{Template:Material_StencilOperation_Desc}} | ||
Line 38: | Line 39: | ||
}} | }} | ||
== | == Usage == | ||
{{stub}} | |||
== Examples == | == Examples == | ||
{{stub}} | |||
== See Also == | == See Also == | ||
* [[Component:TextUnlitMaterial]] | |||
* [[Component:Text]] | |||
[[Category:Materials:UI:Text{{#translation:}}|UI Text Unlit Material]] | [[Category:Materials:UI:Text{{#translation:}}|UI Text Unlit Material]] | ||
Line 48: | Line 53: | ||
[[Category:Materials{{#translation:}}|UI Text Unlit Material]] | [[Category:Materials{{#translation:}}|UI Text Unlit Material]] | ||
[[Category:Components{{#translation:}}|UI Text Unlit Material]] | [[Category:Components{{#translation:}}|UI Text Unlit Material]] | ||
Latest revision as of 05:01, 6 February 2025
Component image 
UI Text Unlit Material component as seen in the Scene Inspector

The UI_TextUnlitMaterial component is a material used to render text glyphs on a UIX. It does so via meshes that automatically generates UV maps that map to each character on a font map. Such as Component:Text and Component:TextRenderer.
Usage
Name | Type | Description |
---|---|---|
persistent
|
Bool | Determines whether or not this item will be saved to the server. |
UpdateOrder
|
Int | Controls the order in which this component is updated. |
Enabled
|
Bool | Controls whether or not this component is enabled. Some components stop their functionality when this field is disabled, but some don't. |
HighPriorityIntegration
|
Bool | 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. |
_shader
|
Shader | Internal. |
FontAtlas
|
ITexture2D | The font to render. |
TintColor
|
ColorX | The color of the text |
OutlineColor
|
ColorX | The color of the text outline |
BackgroundColor
|
ColorX | The color of behind each text glyph |
AutoBackgroundColor
|
Bool | Whether to automatically generate the background text color. |
GlyphRenderMethod
|
GlyphRenderMethod | How to render each glyph or text character. |
PixelRange
|
Float | Sets the distance field range in output pixels. |
FaceDilate
|
Float | How fat to make the letters like bolding them. |
OutlineThickness
|
Float | The thickness of the outline on text for colored outlines. |
FaceSoftness
|
Float | How much blurring to do on the edges of the text. |
BlendMode
|
BlendMode | How to blend this material's colors vs what it rendered on top of. |
Sidedness
|
Sidedness | Render on both sides of the mesh, front, or back. |
ZWrite
|
ZWrite | whether this material should respect the distance it is from the camera. |
ZTest
|
ZTest | Determines whether this object should render when it is in front of or behind other objects that respect depth from the camera |
OffsetFactor
|
Float | how much this material should be pushed forwards or backwards on the depth buffer factor wise |
OffsetUnits
|
Float | how much this material should be pushed forwards or backwards on the depth buffer unit wise |
RenderQueue
|
Int | changes at which point a material renders on the render stack |
Overlay
|
Bool | |
OverlayTint
|
ColorX | |
Rect
|
Rect | See RectClip on Materials. |
RectClip
|
Bool | Toggles if the material should use Rect
|
ColorMask
|
ColorMask | What colors behind the material should make it through the filter. |
StencilComparison
|
StencilComparison | See Type:StencilComparison for an in depth explanation on what this does. |
StencilOperation
|
StencilOperation | See Type:StencilOperation for an in depth explanation on what this does. |
StencilID
|
Byte | 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. |
StencilWriteMask
|
Byte | 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. |
StencilReadMask
|
Byte | is bitwise ANDed with the Stencil in the frame buffer before the test compares them. |
Usage
This article or section is a Stub. You can help the Resonite Wiki by expanding it.
Examples
This article or section is a Stub. You can help the Resonite Wiki by expanding it.