Component:StaticTexture2D: Difference between revisions

From Resonite Wiki
← Older edit
VisualWikitext
No edit summary
replace some with templates
 
(2 intermediate revisions by the same user not shown)
Line 6: Line 6:
|Name=StaticTexture2D
|Name=StaticTexture2D
}}
}}
== Intoduction ==
The '''StaticTexture2D''' Component stores a reference to a static [[Type:IAssetProvider`1|asset]] representing a [[Texture2D|2D Texture]].
The '''StaticTexture2D''' Component stores a reference to a static [[Type:IAssetProvider`1|asset]] representing a [[Texture2D|2D Texture]].
== Usage ==
 
== Fields ==
{{Table ComponentFields
{{Table ComponentFields
|URL|Uri| The Asset URI that references the raw texture data
|URL|Uri| The Asset URI that references the raw texture data
|FilterMode|TextureFilterMode| The type of filtering to use for this texture.
|FilterMode|TextureFilterMode| {{Template:Texture FilterMode Field}}
|AnisotropicLevel|Int| The level of anisotropy to use when <code>TextureFilterMode</code> is set to '''Anisotropic'''
|AnisotropicLevel|Int| {{Template:Texture AnisotropicLevel Field}}
|Uncompressed|Bool| Do not use texture compression
|Uncompressed|Bool| Do not use texture compression
|DirectLoad|Bool|
|DirectLoad|Bool| Whether to load the image directly from it's URI source and to not cache it locally.
|ForceExactVariant|Bool|
|ForceExactVariant|Bool| Only allow one variant of the texture to exist, part of [[Asset Variant|Asset Variant System]].
|PreferredFormat|'''[[Type:Nullable`1|Nullable`1]]&lt;[[Type:TextureCompression|TextureCompression]]&gt;'''|TypeAdv6=true|
|PreferredFormat|'''[[Type:Nullable`1|Nullable`1]]&lt;[[Type:TextureCompression|TextureCompression]]&gt;'''|TypeAdv6=true| The format to use for texture compression rather than the auto picked one
|PreferredProfile|'''[[Type:Nullable`1|Nullable`1]]&lt;[[Type:ColorProfile|ColorProfile]]&gt;'''|TypeAdv7=true|
|PreferredProfile|'''[[Type:Nullable`1|Nullable`1]]&lt;[[Type:ColorProfile|ColorProfile]]&gt;'''|TypeAdv7=true| The color profile to use rather than the auto picked one. (usually linear)
|MipMapBias|Float| Offset to the [[Texture MipMap|MipMap]] calculation.
|MipmapBias|Float| {{Template:Texture MipmapBias Field}}
|IsNormalMap|Bool| This texture should be interpreted as a [[Normal Map]]
|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]
|WrapModeU|TextureWrapMode| {{Template:Texture WrapMode Field|X}}
|WrapModeV|TextureWrapMode| How to handle V values outisde of the range [0.0,1.0]
|WrapModeV|TextureWrapMode| {{Template:Texture WrapMode Field|Y}}
|PowerOfTwoAlignThreshold|Float|
|PowerOfTwoAlignThreshold|Float| The threshold for pixel count from range [0.0,1.0] before scaling both axes to a power of 2.
|CrunchCompressed|Bool|
|CrunchCompressed|Bool| Whether to compress the texture to extreme lengths to reduce VRam usage.
|MaxSize|'''[[Type:Nullable`1|Nullable`1]]&lt;[[Type:Int|Int]]&gt;'''|TypeAdv14=true|
|MaxSize|'''[[Type:Nullable`1|Nullable`1]]&lt;[[Type:Int|Int]]&gt;'''|TypeAdv14=true| 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|Asset Variant System]]
|MipMaps|Bool|
|Mipmaps|Bool| {{Template:Texture Mipmaps Field}}
|KeepOriginalMipMaps|Bool|
|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|
|MipMapFilter|Filtering| How to apply filtering to the image's mipmaps. please see [[Type:Filtering|Filtering]]!
|Readable|Bool|
|Readable|Bool| Whether this can be read per pixel via things like [[ProtoFlux]]
}}
}}
== Behavior ==
== Usage ==
By default <code>Filter</code> 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 <code>Filter</code> to Anisotropic, and <code>AnisotropicLevel</code> to 4 or 8.
By default <code>Filter</code> 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 <code>Filter</code> to Anisotropic, and <code>AnisotropicLevel</code> to 4 or 8.
=== Special Functions ===
=== Special Functions ===
Line 37: Line 37:
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
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


{| class="wikitable" style="font-size:10pt;"
{{Table ComponentTriggers
! colspan="2" style="background: lightblue; font-size:10pt;" | Custom UI Elements
|InvertRGB()|null|Inverts the colors of the texture
|- style="font-size:10pt; text-align:center; font-weight:bold;"
|InvertR()|null|Same as above, but only effects the red channel of the texture
| Name
|InvertG()|null|Same as above, but only effects the green channel of the texture
| Description
|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
| Invert RGB
|ColorToAlphaWhite()|null|Converts all pure white colors in the image to alpha
| Inverts the colors of the texture
|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.
| Invert R
|AlphaToMask()|null|Creates a black and white mask texture from an alpha image
| Same as above, but only effects the red channel of the texture
|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.
| Invert G
|SwapRG()|null|Swaps the red and green channels on the image
| Same as above, but only effects the green channel of the texture
|SwapRB()|null|Swaps the red and blue channels on the image
|-
|SwapGB()|null|Swaps the green and blue channels on the image
| Invert B
|ShiftHue()|null|Adjusts the hue of the image by the increment specified in the Input box
| Same as above, but only effects the blue channel of the texture
|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.
| Invert A
|FlipHorizontal()|null|Flips the image horizontally
| Same as above, but only effects the alpha channel of the texture
|FlipVertical()|null|Flips the image vertical
|-
|Rotate90CW()|null|Rotates the image by 90° clockwise
| Color to Alpha (White)
|Rotate90CCW()|null|Rotates the image by 90° counterclockwise
| Converts all pure white colors in the image to alpha
|Rotate180()|null|Rotates the image by 180°
|-
|TrimTransparent()|null|Stretches the image such that both sides are equal to the longest side
| Color to Alpha (Black)
|ToNearestPOT()|null|Stretches the image on each axis individually, to the next largest power of two.
| Converts all pure black colors in the image to alpha
|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
| Alpha from intensity
}}
|  
|-
| Alpha to mask
| Creates a black and white mask texture from an alpha image
|-
| Remove Alpha
| Forces the entire image to full opacity on the alpha channel
|-
| Convert to grayscale (average)
| Converts the image to grayscale based on the average of the red, green and blue channel.
|-
| Swap R and G
| Swaps the red and green channels on the image
|-
| Swap R and B
| Swaps the red and blue channels on the image
|-
| Swap G and B
| Swaps the green and blue channels on the image
|-
| Shift Hue
| Adjusts the hue of the image by the increment specified in the Input box
|-
| Adjust Gamma
| Adjusts the gamma the image by the increment specified in the Input box
|-
| Resize
| Resizes the image such that the longest size of the image is equal to the size specified in the input box.
|-
| Flip Horizontal
| Flips the image horizontally
|-
| Flip Vertical
| Flips the image vertical
|-
| Rotate 90° CW
| Rotates the image by 90° clockwise
|-
| Rotate 90° CCW
| Rotates the image by 90° counterclockwise
|-
| Rotate 180°
| Rotates the image by 180°
|-
| Make square
| Stretches the image such that both sides are equal to the longest side
|-
| To nearest power of two
| Stretches the image on each axis individually, to the next largest power of two.
|-
| Diagnostic: Invalid floats
| Highlights any pixels that are out of range
|-
| Diagnostic: Generate Bitmap Metadata
| Spawns a [[Texture Metadata]] window displaying the asset's texture metadata as a string
|-
|}
== Examples ==
== Examples ==
== Related Components ==
== See Also ==
</translate>
</translate>
[[Category:Components{{#translation:}}|Static Texture 2D]]
[[Category:Components{{#translation:}}|Static Texture 2D]]
[[Category:Components:Assets{{#translation:}}|Static Texture 2D]]
[[Category:Components:Assets{{#translation:}}|Static Texture 2D]]

Latest revision as of 15:33, 19 November 2024


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.

Fields

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 How to handle the interpolation between pixels.
AnisotropicLevel Int The levels of Anisotropic filtering distances when using Anisotropic for FilterMode
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 Whether to see lower resolution versions of the texture closer up or not (MipMaps).
IsNormalMap Bool This texture should be interpreted as a Normal Map
WrapModeU TextureWrapMode How to repeat or mirror the texture along the X axis. this goes into affect when X values are outside of the range [0.0 to 1.0].
WrapModeV TextureWrapMode How to repeat or mirror the texture along the Y axis. this goes into affect when Y values are outside of the range [0.0 to 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

Usage

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
Method Name Method type and 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

Examples

See Also

Retrieved from "https://wiki.resonite.com/index.php?title=Component:StaticTexture2D&oldid=92711"