The '''ItemTextureThumbnailSource''' component can be used to customize the inventory preview of an item, setting it to a texture.
== Introduction ==
{{PAGENAME}} can be used to customize the inventory preview of an item, setting it to a texture.
<!--T:2-->
<!--T:2-->
== Fields ==
== Fields ==
{{Table ComponentFields
{{Table ComponentFields
|Texture|IAssetProvider`1|TypeString0=IAssetProvider<Texture2D>|The texture that should be used as the item's inventory preview. If null, the component will be ignored.
|Texture|{{RootFieldType|AssetRef`1|[[Type:Texture2D|Texture2D]]}}|TypeAdv0=true|The texture that should be used as the item's inventory preview. If null, the component will be ignored.
|Crop|Nullable`1|TypeString1=Nullable<Rect>|The rectangle that defines what section of the image to use. (Or null to use the entire image)
|Crop|'''[[Type:Nullable`1|Nullable`1]]<[[Type:Rect|Rect]]>'''|TypeAdv1=true|The rectangle that defines what section of the image to use. (Or null to use the entire image)
}}
== Sync Delegates ==
{{Table ComponentTriggers
|OnEnsureSingleThumbnailSource:[[Type:ButtonEventHandler|ButtonEventHandler]]|[[Type:ButtonEventHandler|ButtonEventHandler]]|true| All other components of the same type on the hiearchy of this slot will be deleted when this is pressed.
}}
}}
<!--T:3-->
<!--T:3-->
== Usage ==
== Usage ==
To work, the component just needs to be attached to any slot in the object's hierarchy and have an image in its <code>Texture</code>. The <code>Ensure single thumbnail source</code> button can be used to remove all other instances of the component in the item's hierarchy.
To work, the component needs to be attached to the object's root slot and have an image in its <code>Texture</code>. The <code>Ensure single thumbnail source</code> button can be used to remove all other instances of the component in the item's hierarchy.
<!--T:4-->
<!--T:4-->
Line 25:
Line 27:
An example of an item that uses this is default Tools in the <code>Resonite Essentials > Tools</code> folder.
An example of an item that uses this is default Tools in the <code>Resonite Essentials > Tools</code> folder.
All other components of the same type on the hiearchy of this slot will be deleted when this is pressed.
Usage
To work, the component needs to be attached to the object's root slot and have an image in its Texture. The Ensure single thumbnail source button can be used to remove all other instances of the component in the item's hierarchy.
Examples
This component can be used when the automatically generated preview for an item isn't satisfying enough or you want to ensure that the preview looks the same every time or shows the item off in a certain way.
An example of an item that uses this is default Tools in the Resonite Essentials > Tools folder.
