info, still a stub though |
No edit summary |
||
Line 10: | Line 10: | ||
== Introduction == | == Introduction == | ||
A '''SpriteProvider''' | A '''SpriteProvider''' defines a slice of a [[Texture2D]] as a [[Sprite]] that may be used by other components e.g. [[UIX]] [[Component:Image|Images]] to display graphics or produce backgrounds. | ||
<!--T:3--> | <!--T:3--> | ||
Line 18: | Line 18: | ||
|Texture|{{RootFieldType|AssetRef`1|[[Type:ITexture2D|ITexture2D]]}}|TypeAdv1=true|The sprite to provide. | |Texture|{{RootFieldType|AssetRef`1|[[Type:ITexture2D|ITexture2D]]}}|TypeAdv1=true|The sprite to provide. | ||
|Rect|Rect|The rectangle within the sprite to render. Note that the second x and y are actually the width and height of the Rect. The values are proportions of the width and height of the image in the Texture property. | |Rect|Rect|The rectangle within the sprite to render. Note that the second x and y are actually the width and height of the Rect. The values are proportions of the width and height of the image in the Texture property. | ||
|Borders|Float4| | |Borders|Float4|Border widths for [[9-slice scaling]]. The XYZW components set the left, bottom, right, and top borders respectively. | ||
|Scale|Float| | |Scale|Float| | ||
|FixedSize|Float| | |FixedSize|Float| |
Revision as of 05:20, 24 July 2024
Component image
Introduction
A SpriteProvider defines a slice of a Texture2D as a Sprite that may be used by other components e.g. UIX Images to display graphics or produce backgrounds.
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. |
HighPriorityIntegration
|
Bool | |
Texture
|
ITexture2D | The sprite to provide. |
Rect
|
Rect | The rectangle within the sprite to render. Note that the second x and y are actually the width and height of the Rect. The values are proportions of the width and height of the image in the Texture property. |
Borders
|
Float4 | Border widths for 9-slice scaling. The XYZW components set the left, bottom, right, and top borders respectively. |
Scale
|
Float | |
FixedSize
|
Float |
Behavior
Sprite providers due to the current Unity implementation at the time of writing this have issues with switching images very quickly. They will often flash white, causing a health hazard to photo sensitive users. Having all the sprites on UIX elements at once and switching their OrderOffset
to change which element renders on top will remove the flashing and is currently the only way to combat this issue.
Examples
ProbablePrime's video on Sprites