ResourceImporterTexture

继承： ResourceImporter < RefCounted < Object

导入图像以用于 2D 或 3D 渲染。

描述

该导入器导入 CompressedTexture2D 资源。如果你需要以更方便的方式处理脚本中的图像，请改用 ResourceImporterImage。另见 ResourceImporterLayeredTexture。

教程

• 导入图像

属性

属性说明

int compress/channel_pack = 0 🔗

控制在导入的纹理中应如何使用颜色通道。

sRGB 友好：阻止使用 RG 颜色格式，因为它不支持 sRGB 颜色。

优化：如果纹理不使用蓝色通道，则允许使用 RG 颜色格式。如果可以丢弃纹理的蓝色通道（所有像素的蓝色值必须为 0），则可以减少内存占用。

int compress/hdr_compression = 1 🔗

控制如何对 HDR 图像执行 VRAM 压缩。

禁用：永远不要对 HDR 纹理使用 VRAM 压缩，无论它们是否透明。相反，该纹理会被转换为 RGBE9995（每通道 9 位 + 5 位指数 = 每像素 32 位），与半浮点或单精度浮点图像格式相比，会减少内存使用量。

仅不透明：仅对不透明 HDR 纹理使用 VRAM 压缩。这是由于 HDR 格式的限制，因为没有支持 VRAM 压缩且同时支持透明度的 HDR 格式。

始终：强制 VRAM 压缩，即使对于具有 Alpha 通道的 HDR 纹理也是如此。为此，在导入时将丢弃 Alpha 通道。

注意：仅对 Radiance HDR（.hdr）和 OpenEXR（.exr）图像有效。

bool compress/high_quality = false 🔗

如果为 true，则在桌面平台上使用 BPTC 压缩，在移动平台上使用 ASTC 压缩。使用 BPTC 时，BC7 被用于 SDR 纹理，BC6H 被用于 HDR 纹理。

如果为 false，则在桌面平台上使用速度更快但质量较低的 S3TC 压缩，在移动/Web 平台上使用 ETC2。使用 S3TC 时，DXT1 (BC1) 被用于不透明纹理，DXT5 (BC3) 被用于透明或法线贴图（RGTC）纹理。

BPTC 和 ASTC 支持 HDR 纹理的 VRAM 压缩，但 S3TC 和 ETC2 不支持（请参阅 compress/hdr_compression）。

float compress/lossy_quality = 0.7 🔗

使用有损压缩模式时使用的质量。值越高，质量越好，但文件大小越大。有损质量不会影响导入纹理的内存使用情况，只会影响它在磁盘上的文件大小。

int compress/mode = 0 🔗

要使用的压缩模式。每种压缩模式都提供不同的权衡：

无损：原始质量、高内存占用、高磁盘占用、导入速度快。

有损：质量降低、高内存占用、低磁盘占用、导入速度快。

VRAM 压缩：质量降低、低内存占用、低磁盘占用、导入速度最慢。仅适用于 3D 场景中的纹理，不适用于 2D 元素。

VRAM 未压缩：原始质量、高内存占用、最高磁盘占用、导入速度最快。

Basis Universal：质量降低、低内存占用、最低磁盘占用、导入速度慢。仅适用于 3D 场景中的纹理，不适用于 2D 元素。

有关更多详细信息，请参阅手册中的 压缩模式。

int compress/normal_map = 0 🔗

当使用纹理作为法线贴图时，仅需要红色和绿色通道。鉴于常规纹理压缩算法会产生在法线贴图中看起来不太好的伪像，因此 RGTC 压缩格式最适合该数据。 强制该选项启用将使 Godot 以 RGTC 压缩形式导入图像。默认情况下，它被设置为“检测”。这意味着，如果纹理被检测到用作法线贴图，它将被更改为“启用”并自动重新导入。

请注意，RGTC 压缩会影响生成的法线贴图图像。你必须调整使用法线贴图的蓝色通道的自定义着色器才能考虑到这一点。内置材质着色器已经忽略法线贴图中的蓝色通道（无论实际法线贴图的内容如何）。

int detect_3d/compress_to = 1 🔗

这会更改检测到纹理在 3D 中使用时使用的 compress/mode 选项。

仅当检测到纹理正在 3D 中使用时，更改该导入选项才会生效。将其更改为禁用，然后重新导入不会更改纹理上的已有压缩模式（如果被检测到在 3D 中使用），但选择 VRAM 压缩或 Basis Universal 却会。

bool editor/convert_colors_with_editor_theme = false 🔗

如果为 true，则转换导入图像的颜色以匹配 EditorSettings.interface/theme/icon_and_font_color。这假设该图像使用与 Godot 自己的编辑器图标调色板完全相同的颜色，源文件是为深色编辑器主题设计的。应该为编辑器插件图标和自定义类图标启用该功能，否则应保持禁用状态。

注意：仅适用于 SVG 图像。

bool editor/scale_with_editor_scale = false 🔗

如果为 true，则缩放导入的图像以匹配 EditorSettings.interface/editor/custom_display_scale。应该为编辑器插件图标和自定义类图标启用该功能，否则应保持禁用状态。

注意：仅适用于 SVG 图像。

bool mipmaps/generate = false 🔗

如果为 true，则在导入时生成较小版本的纹理。例如，64×64 纹理将生成 6 个多级渐远纹理（32×32、16×16、8×8、4×4、2×2、1×1）。这样做有几个好处：

• 纹理在远处（在 3D 中）或由于 Camera2D 缩放或 CanvasItem 缩放（在 2D 中）而缩小时不会变得具有颗粒感。

• 如果纹理显示在远处，性能将会提高，因为对原始纹理的较小版本进行采样速度更快并且需要更少的内存带宽。

多级渐远纹理的缺点是它们会增加大约 33% 的内存占用。

建议在 3D 中启用多级渐远纹理。但是，在 2D 中，仅当你的项目明显受益于启用多级渐远纹理时才应启用该功能。如果相机从不大幅缩小，启用多级渐远纹理不会有任何好处，但内存占用会增加。

int mipmaps/limit = -1 🔗

未实现。目前，更改后没有效果。

bool process/fix_alpha_border = true 🔗

如果为 true，则将相同周围颜色的像素置于从透明区域到不透明区域的过渡中。对于使用双线性过滤显示的纹理，这有助于减轻从图像编辑器导出图像时的轮廓效果。

建议启用该功能（默认情况下），除非这会导致特定图像出现问题。

bool process/hdr_as_srgb = false 🔗

你在网上可以找到的一些 HDR 图像可能已损坏并包含 sRGB 颜色数据（而不是线性颜色数据）。建议不要使用这些文件。 如果你一定要这样做，启用 process/hdr_as_srgb 将使它们看起来正确。

警告：在格式良好的 HDR 图像上启用 process/hdr_as_srgb 将导致生成的图像看起来太暗，因此如果不确定，请将其保留为 false。

bool process/hdr_clamp_exposure = false 🔗

如果为 true，则使用智能钳制公式钳制导入的高动态范围图像中的曝光（而不引入可见的裁剪）。

你在网上可以找到的一些 HDR 全景图像可能包含非常明亮的像素，因为这些图像取自现实生活来源，没有任何裁剪。

虽然这些 HDR 全景图像准确反映现实生活，但这可能会导致 Godot 生成的辐射图在用作背景天空时包含闪光。这可以在材质反射中看到（即使在极端情况下的粗糙材质上）。启用 process/hdr_clamp_exposure 可以解决该问题。

bool process/normal_map_invert_y = false 🔗

如果为 true，则通过反转其绿色通道将法线贴图从 Y-（DirectX 风格）转换为 Y+（OpenGL 风格）。这是 Godot 所期望的法线贴图约定。

有关法线贴图（包括流行引擎的坐标顺序表）的更多信息，可以在这里找到。

bool process/premult_alpha = false 🔗

使用 process/fix_alpha_border 修复黑色边框的另一种方法是使用预乘 Alpha。通过启用该选项，纹理将被转换为该格式。预乘 Alpha 纹理需要特定材质才能正确显示：

• 在 2D 中，需要创建并配置 CanvasItemMaterial，以便在使用该纹理的 CanvasItem 上使用 CanvasItemMaterial.BLEND_MODE_PREMULT_ALPHA 混合模式。

• 在 3D 中，尚不支持预乘 Alpha 混合模式，因此该选项仅适用于 2D。

int process/size_limit = 0 🔗

如果被设置为大于 0 的值，则导入时纹理的大小将被限制为小于或等于此处指定的值。对于非方形纹理，大小限制会影响较长的尺寸，而较短的尺寸会被缩放以保持纵横比。调整大小是使用三次插值来执行的。

这可被用于减少内存占用而不影响源图像，或避免纹理在移动/Web 平台上不显示的问题（因为这些平台通常无法显示大于 4096×4096 的纹理）。

int roughness/mode = 0 🔗

将该纹理视为粗糙度贴图的颜色通道。仅当粗糙度 > Src Normal 不为空时才有效。

String roughness/src_normal = "" 🔗

纹理的路径被视为导入时粗糙度过滤的法线贴图。指定该项有助于稍微减少 3D 中的镜面锯齿。

导入时的粗糙度过滤仅被用于 3D 渲染，不适用于 2D。

float svg/scale = 1.0 🔗

SVG 应渲染的比例，1.0 是原始设计尺寸。值越高，图像越大。请注意，与字体过采样不同，这会影响 SVG 在 2D 中渲染的大小。另请参阅 editor/scale_with_editor_scale。

注意：仅适用于 SVG 图像。