Component:StaticTexture2D

This article or section is a Stub. You can help the Resonite Wiki by expanding it.

Component image 

StaticTexture2D component as seen in the Scene Inspector

The StaticTexture2D Component stores a reference to a static asset representing a 2D Texture.

Usage

Fields

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.
URL	Uri	The Asset URI that references the raw texture data
FilterMode	TextureFilterMode	The type of filtering to use for this texture.
AnisotropicLevel	Int	The level of anisotropy to use when TextureFilterMode is set to Anisotropic
Uncompressed	Bool	Do not use texture compression
DirectLoad	Bool	Whether to load the image directly from it's URI source and to not cache it locally.
ForceExactVariant	Bool	Only allow one variant of the texture to exist, part of Asset Variant System.
PreferredFormat	Nullable`1<TextureCompression>	The format to use for texture compression rather than the auto picked one
PreferredProfile	Nullable`1<ColorProfile>	The color profile to use rather than the auto picked one. (usually linear)
MipMapBias	Float	Offset to the MipMap calculation.
IsNormalMap	Bool	This texture should be interpreted as a Normal Map
WrapModeU	TextureWrapMode	How to handle U values outside of the range [0.0,1.0]
WrapModeV	TextureWrapMode	How to handle V values outisde of the range [0.0,1.0]
PowerOfTwoAlignThreshold	Float	The threshold for pixel count from range [0.0,1.0] before scaling both axes to a power of 2.
CrunchCompressed	Bool	Whether to compress the texture to extreme lengths to reduce VRam usage.
MaxSize	Nullable`1<Int>	The maxiumum size to show to the user, which scaled versions are generated by the cloud on the fly from the original and sent as part of the Asset Variant System
MipMaps	Bool	Whether to enable the rendering of mipmaps, which are lower res textures at further distances from the camera to improve performance.
KeepOriginalMipMaps	Bool	Whether to use the original mipmaps that came with the image data (yes you could have rainbow mipmaps at further distances) or not.
MipMapFilter	Filtering	How to apply filtering to the image's mipmaps. please see Filtering!
Readable	Bool	Whether this can be read per pixel via things like ProtoFlux

Behavior

By default Filter is set to Bilinear Filtering, however Anisotropic Filtering results in a much better appearance at very steep angles, and only has a very minor performance impact. If visual fidelity of your texture is a concern, you should set Filter to Anisotropic, and AnisotropicLevel to 4 or 8.

Special Functions

Any of the operations listed below will generate a new static texture asset, and anything referring to this StaticTexture2D component will be updated with the new texture. The existing asset is deleted from the servers if no other items refer to it.

Troubleshooting

When importing images into Resonite, sometimes the image will have a row of pixels taken from the bottom of the image rendered at the top. To fix this issue, go to the FilterMode property on the StaticTexture2D component, click the checkbox, and select "Point". This prevents the issue

Triggers

Name	Arguments	Description
InvertRGB()	null	Inverts the colors of the texture
InvertR()	null	Same as above, but only effects the red channel of the texture
InvertG()	null	Same as above, but only effects the green channel of the texture
InvertB()	null	Same as above, but only effects the blue channel of the texture
InvertA()	null	Same as above, but only effects the alpha channel of the texture
ColorToAlphaWhite()	null	Converts all pure white colors in the image to alpha
ColorToAlphaBlack()	null	Converts all pure black colors in the image to alpha
AlphaFromIntensity()	null	Makes the texture transparent based on the intensity of colors in the image.
AlphaToMask()	null	Creates a black and white mask texture from an alpha image
RemoveAlpha()	null	Forces the entire image to full opacity on the alpha channel
GrayscaleAverage()	null	Converts the image to grayscale based on the average of the red, green and blue channel.
SwapRG()	null	Swaps the red and green channels on the image
SwapRB()	null	Swaps the red and blue channels on the image
SwapGB()	null	Swaps the green and blue channels on the image
ShiftHue()	null	Adjusts the hue of the image by the increment specified in the Input box
AdjustGamma()	null	Adjusts the gamma the image by the increment specified in the Input box
Resize()	null	Resizes the image such that the longest size of the image is equal to the size specified in the input box.
FlipHorizontal()	null	Flips the image horizontally
FlipVertical()	null	Flips the image vertical
Rotate90CW()	null	Rotates the image by 90° clockwise
Rotate90CCW()	null	Rotates the image by 90° counterclockwise
Rotate180()	null	Rotates the image by 180°
TrimTransparent()	null	Stretches the image such that both sides are equal to the longest side
ToNearestPOT()	null	Stretches the image on each axis individually, to the next largest power of two.
InvalidFloats()	null	Highlights any pixels that are out of range
GenerateBitmapMetadata()	null	Spawns a Texture Metadata window displaying the asset's texture metadata as a string