seedlingattempt/godot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

BasisU: Use KTX2 format and add import options to configure encoder

Browse Source
This commit is contained in:
LuoZhihao
2025-05-03 01:45:38 +08:00
parent 80a3d205f1
commit 237597b01f
17 changed files with 194 additions and 62 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
doc/classes/ResourceImporterTexture.xml
View File

@ -43,6 +43,14 @@
When using a texture as normal map, only the red and green channels are required. Given regular texture compression algorithms produce artifacts that don't look that nice in normal maps, the RGTC compression format is the best fit for this data. Forcing this option to Enable will make Godot import the image as RGTC compressed. By default, it's set to Detect. This means that if the texture is ever detected to be used as a normal map, it will be changed to Enable and reimported automatically.
Note that RGTC compression affects the resulting normal map image. You will have to adjust custom shaders that use the normal map's blue channel to take this into account. Built-in material shaders already ignore the blue channel in a normal map (regardless of the actual normal map's contents).
</member>
<member name="compress/rdo_quality_loss" type="float" setter="" getter="" default="0.0">
If greater than or equal to [code]0.01[/code], enables Rate-Distortion Optimization (RDO) to reduce file size. Higher values result in smaller file sizes but lower quality.
[b]Note:[/b] Enabling RDO makes encoding times significantly longer, especially when the image is large.
See also [member ProjectSettings.rendering/textures/basis_universal/rdo_dict_size] and [member ProjectSettings.rendering/textures/basis_universal/zstd_supercompression_level] if you want to reduce the file size further.
</member>
<member name="compress/uastc_level" type="int" setter="" getter="" default="0">
The UASTC encoding level. Higher values result in better quality but make encoding times longer.
</member>
<member name="detect_3d/compress_to" type="int" setter="" getter="" default="1">
This changes the [member compress/mode] option that is used when a texture is detected as being used in 3D.
Changing this import option only has an effect if a texture is detected as being used in 3D. Changing this to [b]Disabled[/b] then reimporting will not change the existing compress mode on a texture (if it's detected to be used in 3D), but choosing [b]VRAM Compressed[/b] or [b]Basis Universal[/b] will.