StandardMaterial3D 完全指南:Godot 内置 PBR 材质的核心参数与实战调参

原创2026-10-15 10:25:37930 阅读
文章标签:文档教程

StandardMaterial3D 完全指南:Godot 内置 PBR 材质的核心参数与实战调参

StandardMaterial3D 是 Godot 引擎默认的 3D 物理渲染(PBR)材质,它把艺术家日常所需的绝大多数材质功能封装成一组无需编写着色器代码即可调用的属性,并可在需要时一键转换为着色器代码。本文以官方类参考 classes/class_standardmaterial3d.rst 及其关联教程 tutorials/3d/standard_material_3d.rst 为骨架,结合 BaseMaterial3D 类参考中的枚举与默认值细节,系统讲解 StandardMaterial3D 与 ORMMaterial3D 的透明模式、着色方式、PBR 参数、纹理通道与渲染技巧,帮助你在不写 shader 的前提下快速做出材质,并在遇到性能瓶颈时知道该调整哪个开关。

认识 StandardMaterial3D 与 ORMMaterial3D

类继承体系与定位

从类参考的继承声明可以确认,StandardMaterial3D 继承自抽象基类 BaseMaterial3D,完整链条为:

StandardMaterial3D → BaseMaterial3D → Material → Resource → RefCounted → Object

BaseMaterial3D 是"定义网格 3D 渲染属性"的抽象基类,StandardMaterial3D 与 ORMMaterial3D 是它的两个直接实现类。StandardMaterial3D 的几乎所有属性都继承自 BaseMaterial3D——这正是它属性面板上写着 "BaseMaterial3D" 分类的原因。这意味着类参考中 BaseMaterial3D 页面上列出的全部属性、枚举与方法,在 StandardMaterial3D 上同样可用。

StandardMaterial3D 与 ORMMaterial3D 的核心差异

两者都是"用于 3D 物体的 PBR 材质",唯一的区别在于纹理组织方式:

  • StandardMaterial3D:为环境光遮蔽(Ambient Occlusion)、粗糙度(Roughness)、金属度(Metallic)分别使用独立的纹理槽位。
  • ORMMaterial3D:将三者合并进单张 ORM 纹理(Occlusion/Roughness/Metallic)。从 BaseMaterial3D 的 orm_texture 属性说明可以确认其通道约定:红色通道存环境光遮蔽,绿色通道存粗糙度,蓝色通道存金属度,Alpha 通道被忽略。

Substance Painter、Armor Paint 等软件都提供 ORM 导出选项(通常对应"Unreal Engine 导出预设",因为 UE 也使用 ORM 纹理),拿到这类资源时直接用 ORMMaterial3D 即可。此外 BaseMaterial3D 的 ao_texture_channel、roughness_texture_channel、metallic_texture_channel 都允许选择 R/G/B/A/灰度通道,说明即便使用 StandardMaterial3D,也支持把多种信息打包进同一张纹理再按通道读取,从而减少纹理数量。

四种方式为 3D 对象添加材质

在 Godot 中,材质可以挂到四个位置(对应 GeometryInstance3D 与 Mesh 的相关属性):

  1. Mesh 的 Material 属性:材质随网格本身存储,所有使用该网格的节点都会共享这块材质。
  2. 节点的 Material 属性:只影响该节点,且会覆盖 Mesh 自身的材质。
  3. 节点的 Material Override 属性:只影响该节点,且同时覆盖节点的 Material 与 Mesh 的 Material。
  4. 节点的 Material Overlay 属性:在网格当前使用的材质之上再渲染一层,例如给网格叠加一个透明护盾特效。

Godot 中四种添加材质的位置

Transparency 透明模式

默认情况下 Godot 材质是不透明的——渲染最快,且支持全部渲染特性。即使你在 Albedo > Texture 里放了一张带透明通道的贴图,或把 Albedo > Color 调成透明颜色,材质依然是实心的,必须显式开启透明模式。

Godot 提供五种透明模式(对应 BaseMaterial3D 的 Transparency 枚举):

模式 枚举值 渲染行为 典型用途
Disabled TRANSPARENCY_DISABLED = 0 完全不透明,渲染最快 默认状态
Alpha TRANSPARENCY_ALPHA = 1 半透明区域按混合绘制,允许部分透明(半透明),但不能投射阴影、不出现在屏幕空间反射中 粒子特效、VFX
Alpha Scissor TRANSPARENCY_ALPHA_SCISSOR = 2 不透明度低于 Alpha Scissor Threshold 的像素直接裁掉,高于阈值的按不透明绘制;支持投射阴影,无透明排序问题 植被、栅栏等硬边物体
Alpha Hash TRANSPARENCY_ALPHA_HASH = 3 用抖动(dithering)近似半透明,"全有或全无",支持投射阴影 写实头发(风格化头发更适合 Alpha Scissor)
Depth Pre-Pass TRANSPARENCY_ALPHA_DEPTH_PRE_PASS = 4 先让完全不透明像素走不透明管线写入深度,再混合绘制其余部分,让透明排序"大体正确";支持投射阴影 透明草地、树冠

自动强制透明的条件

教程中明确给出了三条"自动进入 Alpha 混合透明管线"的触发条件:

  • 将透明模式设为 Alpha;
  • 将 Blend Mode 设为非默认的 Mix 以外的值;
  • 启用 Refraction、Proximity Fade 或 Distance Fade。

Alpha 混合的已知限制

TRANSPARENCY_ALPHA 虽然效果最通用,但代价明显:显著更慢(尤其多个透明物体交叠时);透明表面互相交叠时可能产生排序错误(远表面画到近表面前面);不能投射阴影(但能接收阴影);除反射探针外不参与任何反射;屏幕空间反射(SSR)与锐利 SDFGI 反射不会出现在 Alpha 混合材质上(启用 SDFGI 时退化为粗糙反射)。动手前先评估:这个透明效果是否真的需要 Alpha 混合?

Alpha 混合(左)与 Alpha Scissor(右)透明对比

Alpha Antialiasing 抗锯齿

仅当透明模式为 Alpha Scissor 或 Alpha Hash 时,Alpha Antialiasing 属性才会在检查器中显示。Scissor/Hash 材质在不透明与透明区域交界处有生硬边缘,而 FXAA/TAA 这类后处理抗锯齿可能让画面发糊或产生鬼影,于是 Godot 提供三种 alpha 抗锯齿模式:

  • Disabled:无抗锯齿,边缘走样(除非使用后处理抗锯齿)。
  • Alpha Edge Blend(即 alpha to coverage):不透明与透明之间平滑过渡。
  • Alpha Edge Clip(即 alpha to coverage + alpha to one):锐利但仍抗锯齿的过渡。

选择 Alpha Edge Blend/Clip 后会出现 Alpha Antialiasing Edge 属性,控制"低于该值像素变为透明"的额外阈值。它必须严格低于 Alpha Scissor Threshold:默认 0.3 搭配 scissor 阈值 0.5 是合理组合,修改 scissor 阈值时记得同步调整。若抗锯齿效果不足,可增大 Edge 值(仍须低于 Scissor Threshold);若靠近摄像机时贴图外观明显变化,则应减小 Edge 值。

关键前提:使用 alpha 抗锯齿时,建议在项目设置中把 MSAA 3D 设为至少 2×,因为该功能依赖 MSAA 提供的 alpha to coverage;未开启 MSAA 时只在边缘套用固定抖动图案,平滑效果有限。

Blend Mode 混合模式

除 Mix(默认,alpha 控制可见度)外,任何其他混合模式都会强制物体进入透明管线:

  • Mix:颜色按 alpha 覆盖到背景上。
  • Add:把最终颜色加到屏幕颜色上,适合光晕、火焰类效果。
  • Subtract:把最终颜色从屏幕颜色中减去。
  • Multiply:最终颜色与屏幕颜色相乘。
  • Premultiplied Alpha:期望颜色已预先乘以 alpha,alpha 为 0.0 时表现为 Add,为 1.0 时表现为 Mix;对"火焰要加色、烟雾要混合"这类效果很实用。着色材质还可借助 PREMUL_ALPHA_FACTOR 内建量同步调制光照。

Cull Mode 背面剔除

决定绘制哪一侧:Back(默认,剔除背对相机的背面)、Front(剔除正面,闭合网格会画出内部)、Disabled(双面渲染,不剔除)。注意:Blender 默认关闭材质背面剔除,导出的 glTF 到 Godot 后会变成 Cull Disabled,双面渲染拖慢性能——可在 Blender 材质面板勾选 Backface Culling 后重新导出 glTF。

Depth Draw Mode 深度写入

  • Opaque Only(默认):仅为不透明物体写深度。
  • Always:不透明与透明物体都写深度。
  • Never:完全不写深度(注意与下方的 No Depth Test 区分)。
  • Depth Pre-Pass:透明物体先以不透明部分做一次不透明 pass,再在其上绘制透明度,适合透明草地、树冠。

No Depth Test 与 Depth Test

  • No Depth Test:关闭深度测试,物体恒显示在其他物体之上(或之下)。最适合绘制世界空间指示器,配合下方的 Render Priority 属性效果极佳。
  • Depth Test(Inverted):反转标准深度测试,物体只在被遮挡时出现、平时隐藏——常用于配合 stencil 效果。若已启用 No Depth Test 则此项无效。

Shading 着色设置

Shading Mode 三种着色方式

  • Per-Pixel(默认):逐像素计算光照,画质最好,适合绝大多数场景。
  • Per-Vertex:每个顶点计算一次光照再插值,俗称"顶点光照"。在低端或移动设备上能显著提升渲染性能;粒子多层透明叠加(尤其镜头贴近粒子)时也推荐;还能用来做复古风格。
  • Unshaded:完全不计算光照,直接输出 Albedo 颜色,灯光完全不作用于材质,物体通常明显更亮。适合特定视觉特效、追求极致性能的粒子或低端/移动设备。

Per-Pixel、Per-Vertex、Unshaded 三种着色模式对比

Diffuse Mode 漫反射算法

默认 Burley(Disney Principled PBS 原始漫反射算法)。其余选项:

  • Lambert:不受粗糙度影响。
  • Lambert Wrap:粗糙度增大时把受光范围扩展到 90° 之外,适合头发与廉价的次表面散射模拟,且能量守恒。
  • Toon:光照硬切,粗糙度影响平滑度。配合关闭环境光(或在材质里禁用 Ambient Light)效果更佳。

Specular Mode 高光光斑

高光光斑是光源反射在物体上的形状:SchlickGGX(当前 PBR 引擎最常用的光斑;注意 Forward+ 使用多散射,粗糙金属表面反射更准确,而 Mobile/Compatibility 只做单散射,粗糙金属可能略暗)、Toon(大小随粗糙度变化的卡通光斑)、Disabled(不渲染高光光斑,略快)。注意该设置只作用于光源光斑,不影响天空、SSR、VoxelGI、SDFGI 或反射探针等反射来源;要连这些反射一起关掉,请把 metallic_specular 设为 0.0。

三个"禁用"开关

  • Disable Ambient Light:物体不接受任何环境光照明。
  • Disable Fog:不受深度雾或体积雾影响,避免粒子等加法混合材质暴露出网格轮廓。
  • Disable Specular Occlusion:不在本应被遮蔽处减弱反射。

核心 PBR 参数:Albedo、Metallic、Roughness

Albedo 基础色

Albedo 是材质的基底颜色,所有其他设置都在其上运算;Unshaded 模式下它是唯一可见的颜色。早期 Godot 称其为 Diffuse,改名是因为在 PBR 中该颜色参与的运算远不止漫反射一路。Albedo 颜色与纹理是相乘关系,可以叠加使用;其 Alpha 通道用于物体透明度,使用带 alpha 的颜色或纹理时,务必同时开启透明或 Alpha Scissor 才能生效。默认值 Color(1, 1, 1, 1)。

Metallic 金属度

Godot 采用"金属/非金属"模型而非其他模型,因为更简单。该参数决定材质反射能力:越接近金属,漫反射/环境光影响越小、反射越多,即"能量守恒"模型。非金属用 albedo 作漫反射色并在其上叠加反射;金属用 albedo 乘反射并置漫反射为黑,得到染色反射。完全金属或完全非金属效果最好,0~1 中间值只应用于金属/非金属交界处的过渡混合。metallic 默认 0.0,要调反射量请用 Roughness 而非 Metallic。

Specular 参数(metallic_specular,默认 0.5)是反射率的一般调节量,不守恒能量,一般保持 0.5 别动。材质的最低内部反射率为 0.04——和现实一样,不可能做出完全不反射的材质。另注意 metallic_texture 与 metallic 是相乘关系。

Roughness 粗糙度

roughness 默认 1.0:0 是完美镜面,1 完全模糊反射(模拟自然微表面)。绝大多数常见材质都可以用 Metallic + Roughness 的正确组合配出来;roughness_texture 逐像素控制粗糙度并与标量相乘。

纹理通道逐一详解

Godot 的 TextureParam 枚举(见 BaseMaterial3D)定义了 19 个纹理槽位:TEXTURE_ALBEDO(0)、TEXTURE_METALLIC(1)、TEXTURE_ROUGHNESS(2)、TEXTURE_EMISSION(3)、TEXTURE_NORMAL(4)、TEXTURE_RIM(5)、TEXTURE_CLEARCOAT(6)、TEXTURE_FLOWMAP(7)、TEXTURE_AMBIENT_OCCLUSION(8)、TEXTURE_HEIGHTMAP(9)、TEXTURE_SUBSURFACE_SCATTERING(10)、TEXTURE_SUBSURFACE_TRANSMITTANCE(11)、TEXTURE_BACKLIGHT(12)、TEXTURE_REFRACTION(13)、TEXTURE_DETAIL_MASK(14)、TEXTURE_DETAIL_ALBEDO(15)、TEXTURE_DETAIL_NORMAL(16)、TEXTURE_ORM(17)、TEXTURE_BENT_NORMAL(18)。

Emission 自发光

自发光量会加到最终图像上,不受场景其他光照影响(但除非使用 VoxelGI 或 SDFGI,它不会照亮周围几何体)。emission 默认 Color(0, 0, 0, 1),emission_energy_multiplier 默认 1.0;启用物理光单位项目设置后还有以尼特计的 emission_intensity。emission_operator 决定颜色与纹理是相加(默认)还是相乘。

Normal Map 法线贴图

法线贴图用贴图表达更细的表面起伏,不改变几何,只影响光照入射角。Godot 只使用法线贴图的红、绿通道(利于压缩与兼容性)。两条硬性要求:网格顶点必须同时带法线与切线(用 SurfaceTool 生成几何时可调用 generate_normals() 与 generate_tangents());法线贴图必须使用 X+、Y+、Z+(OpenGL 风格) 坐标——从其他引擎(如 DirectX 风格)拿来的贴图需要翻转 Y 轴。

Bent Normal Map 弯曲法线贴图

弯曲法线贴图描述环境光的平均入射方向,作用是改善材质对光照的响应而非增加表面细节,有两种增益:间接漫反射更贴近全局光照;启用高光遮蔽时,用弯曲法线与环境光遮蔽(含 SSAO 等)联合计算。同样只用红、绿通道。烘焙时需满足三个条件:使用余弦分布的光线采样、切线空间、OpenGL 风格坐标(DirectX 风格可在导入面板的 Channel Remap 中把绿色通道设为 Inverted Green)。注意:弯曲法线贴图与普通法线贴图不可互换。

Rim 边缘光

模拟织物微绒毛导致的光散射,Godot 的实现会真实计算光照(无光则无边缘光),比单纯用自发光通道模拟可信得多。边缘光大小受粗糙度影响,rim_tint(默认 0.5)控制着色:0 用灯光颜色,1 用 albedo,中间值通常效果最好。rim 默认 1.0 为强度。

Clearcoat 清漆层

给材质叠加第二层透明涂层(常见于车漆、玩具),本质是叠加一个更小的高光光斑。clearcoat 默认 1.0,设为 0 等同于关闭;clearcoat_roughness 默认 0.5;clearcoat_texture 红色通道存强度、绿色通道存光泽度。Unshaded 模式下清漆不可见。

Anisotropy 各向异性

改变高光光斑形状并沿切线空间对齐,常用于头发、拉丝铝,配合 flowmap(流向图)效果尤其好。前提是网格必须带切线,否则效果是坏的;也不要与各向异性纹理过滤混淆(那是 texture_filter 的事)。anisotropy_flowmap 是导数贴图:红通道扭曲 X 轴、绿通道扭曲 Y 轴(低于 0.5 反向、高于 0.5 正向),其 alpha 通道可逐像素缩放各向异性强度,蓝通道忽略。

Ambient Occlusion 环境光遮蔽

烘焙好的 AO 贴图决定环境光能到达表面多少(默认不影响直接光)。SSAO 虽然能实时生成,但烘焙 AO 质量更高,只要条件允许就应烘焙。ao_light_affect 控制 AO 对灯光的附加影响(0 只影响环境光,1 对灯光与环境光影响相同,通常不真实);ao_on_uv2 可让 AO 使用第二套 UV。

Height 视差贴图

高度贴图通过沿视线方向"射线步进"搜索来模拟凹槽的真实位移,只是深度幻觉、不增加真实几何(需要物理碰撞的高度地形请用 HeightMapShape3D)。复杂物体上可能效果不佳,但对纹理能产生逼真深度。建议配合法线贴图使用,且高度贴图与三平面映射互斥(启用 uv1_triplanar 时高度贴图被忽略)。参数:heightmap_scale 默认 5.0(最高点比最低点高出约 5cm 的观感);heightmap_deep_parallax 启用视差遮蔽映射(更逼真但 GPU 代价高,可调 heightmap_min/max_layers);若移动镜头时效果异常可尝试 heightmap_flip_binormal、heightmap_flip_tangent;heightmap_flip_texture 兼容 Godot 3.x 的深度图。

Subsurface Scattering 次表面散射

模拟光穿透表面、内部散射再穿出的效果,适合皮肤、大理石、有色液体等。仅 Forward+ 渲染器支持(Mobile 与 Compatibility 不支持)。subsurf_scatter_strength 控制强度,全局质量由项目设置 rendering/environment/subsurface_scattering/subsurface_scattering_quality 控制;subsurf_scatter_skin_mode 提供针对人体皮肤优化的模式(如增强红色通道);subsurf_scatter_transmittance_* 系列控制透射效果(背光穿透,如耳朵、叶片)。透明背景视口不支持。

Back Lighting 背光

把受光面(面向光源侧)的光量转移到背光面,适合薄物体(叶片、草、人耳等)。由 backlight_enabled、backlight 颜色(默认黑)与 backlight_texture 控制。

Refraction 折射

启用后 Godot 尝试取物体背后的屏幕信息,近似真实折射地扭曲透明度。必须搭配透明 albedo(透明纹理或降低 albedo alpha)才有可见效果;折射强度受粗糙度影响——粗糙度高时背后物体更模糊,看不到背后时可降低 Roughness。refraction_scale 默认 0.05,可另放一张法线贴图到 Refraction Texture 做逐像素方向扭曲。

作为屏幕空间特效,折射强制材质透明并伴随限制:可能出现透明排序问题;不能自折射或折射到其他透明材质上(背后的透明材质会看不见);屏幕外的物体不参与折射(高强度时最明显);前方的透明物体边缘会出现"伪折射"。

Detail 细节层

允许叠加第二套 albedo 与法线贴图生成细节纹理,可与第二套 UV 或三平面映射组合出丰富效果。配套设置:

  • Mask:黑白遮罩,白=细节、黑=主材质、灰=两者按比例混合。
  • Blend Mode:四种混合方式——Mix(黑处只显示主贴图,白处只显示细节,灰平滑混合)、Add(白处两贴图完全混合,黑处主贴图几乎不变)、Sub(白处完全减去第二贴图)、Mul(逐像素 RGB 相乘)。
  • Albedo:待混合的 albedo 贴图,空槽默认视为白色。
  • Normal:待混合的法线贴图,空槽视为平坦法线(即使材质未开法线贴图也可用)。

细节说明:detail_albedo 的 alpha 通道在材质不透明时也充当遮罩;detail_albedo 不受 albedo_color 调制;detail_normal 只读取红、绿通道;细节层可选用 UV1 或 UV2(detail_uv_layer)。

UV1 / UV2 与三平面映射

Godot 每材质支持两套 UV:UV2 常用于环境光遮蔽或自发光(烘焙光照)。UV 支持缩放与偏移(uv1_scale/uv1_offset、uv2_scale/uv2_offset,默认 Vector3(1,1,1) / Vector3(0,0,0)),重复贴图时很实用;其 Z 分量仅在开启三平面映射时生效。

Triplanar Mapping(又称 "Autotexture")对 UV1、UV2 都可用:沿 X、Y、Z 三个轴采样再按法线混合,可在世界空间或对象空间计算。适合自然场景材质(让砖墙纹理在多个图元间平滑延续),但每像素读取次数多、明显更慢,也不适合追求清晰锐利的贴图。uv1_triplanar_sharpness 控制混合锐度(默认 1.0,钳制在 0~150);World Triplanar 让计算改在世界空间而非对象局部空间。

Sampling 采样设置

  • Filter:对应 TextureFilter 枚举(默认 3 = Linear With Mipmaps):Nearest(0)、Linear(1)、Nearest With Mipmaps(2)、Linear With Mipmaps(3)、Nearest/Linear With Mipmaps Anisotropic(4/5)。各向异性过滤能改善与镜头近乎平行表面的贴图质量,代价是略慢,过滤级别由项目设置 rendering/textures/default_filters/anisotropic_filtering_level 控制。注意高度贴图始终线性采样,即使选择最近邻过滤也不受影响。
  • Repeat:纹理超出 0-1 范围时是否平铺(texture_repeat 默认 true);线性过滤模式下平铺可能在贴图边缘出现采样伪影。

Shadows 阴影

  • Disable Receive Shadows:不接收投射到其上的任何阴影。
  • Shadow to Opacity:让光照改写 alpha——阴影区域不透明、非阴影区域透明,适合 AR 中把阴影叠加到摄像头画面上。

Billboard 公告板

控制物体如何面向相机:Disabled(关闭)、Enabled(-Z 轴始终面向相机视平面)、Y-Billboard(X 轴始终对齐相机视平面)、Particle Billboard(最适合粒子系统,支持 particles_anim_* 翻书动画:水平/垂直帧数、循环;配合 ParticleProcessMaterial.anim_speed_min 或 CPUParticles3D.anim_speed_min 大于 0 才会播放)。Billboard Keep Scale 保留网格缩放(否则公告板化会丢失缩放)。注意公告板模式不适合 VR(头显左右向量不水平)。

Grow 顶点膨胀与 Stencil 描边

Grow:沿顶点法线方向外扩顶点,常用作廉价描边:加一个第二材质通道,设黑色 + Unshaded,反转剔除(Cull Front),再加少量 Grow。前提是网格必须平滑着色(共享顶点的连接面);扁平着色(每个面独立顶点)会在膨胀处出现缝隙。

Godot 4.5 起提供基于模板缓冲(stencil buffer)的描边替代方案:StencilMode 提供 Outline(描边)、X-Ray(X 光透视轮廓)、Custom(自定义高级效果)预设。stencil_reference 参考值(0-255,通常取 2 的幂)、stencil_compare(7 种比较算子)、stencil_flags(读取/写入/深度失败写入)、stencil_color、stencil_outline_thickness(默认 0.01)等参数控制细节。注意:写入模板缓冲的材质总是走透明通道,受透明排序限制;Outline/X-Ray 预设会自动往 Next Pass 写入预配置材质,手动改动 Next Pass 会在修改模板属性或重载场景时丢失,需要安全叠加请改用 GeometryInstance3D.material_overlay。与 Grow 一样,模板描边也需要平滑着色网格,且描边效果与 Grow 在有些场景(尤其与不透明表面相交时)不完全一致。

Transform 变换技巧

  • Fixed Size:物体无论距离远近都以相同屏幕尺寸渲染(等效于相机在 1.0 单位距离),适合指示器(配 No Depth Test + 高 Render Priority)和某些公告板。
  • Use Point Size / Point Size:仅对点基元几何有效,可在像素单位下调整点大小。
  • Use Particle Trails:仅 Forward+ 与 Mobile 渲染器支持;为 GPUParticles3D 轨迹启用所需 shader 片段,需配合 RibbonTrailMesh 或 TubeTrailMesh,在普通网格材质上误开会破坏渲染。
  • Use Z Clip Scale:把物体向相机方向缩放以避免穿墙,适合随相机固定的物体(第一人称手臂、工具等);光照阴影仍正确,但低缩放值下 SSAO、SSR 等屏幕空间效果可能出错,尽量贴近 1.0。
  • Use FOV Override / FOV Override(默认 75.0°):覆盖 Camera3D 视场角;行为等价于 keep_aspect = KEEP_HEIGHT 的相机,且对忽略 FOV 的正交相机无效。

Proximity Fade 与 Distance Fade

Godot 支持两种淡出:Proximity Fade(按像素到其他物体的距离淡出,适合软粒子、水体与岸边平滑融合;proximity_fade_distance 默认 1.0)与 Distance Fade(按到观察者距离淡出,适合光柱或特定距离才出现的指示器)。Distance Fade 有三种模式:

  • Pixel Alpha:逐像素改变真实透明度,效果最好但强制进入透明管线(例如导致不能投阴影)。
  • Pixel Dither:只渲染一部分像素来近似透明。
  • Object Dither:与上者类似,但整块物体表面共享同一个透明度值,通常更快。

在 Pixel Alpha 模式下启用近距/远距淡出会开启 alpha 混合,更吃 GPU 并引入排序问题,还会禁用投阴影等特性。想隐藏"贴脸太近的角色",推荐 Pixel Dither 或更快的 Object Dither。

Material Settings 材质级设置

  • Render Priority:调整渲染顺序,主要对透明物体有用(或不透明但只写深度不写颜色、如地面裂纹)。物体先按不透明/透明队列排序,再按 render_priority 排序(值高者后绘制),透明物体还按深度排序。深度测试优先级高于 priority——priority 无法强制不透明物体互相覆盖。
  • Next Pass:为材质设置 next_pass 后,物体将被该下一个材质再渲染一遍(双通道描边即此原理)。两个通道间默认做相等深度测试,除非使用 Grow 等顶点变换;多层透明通道之间应依靠 render_priority 保证正确排序。

用代码创建 StandardMaterial3D

所有属性都有对应 setter,其中三类通用方法最为常用(见 BaseMaterial3D 方法表):

  • set_feature(feature, enable):开启/关闭各类功能(发射、法线映射、rim、清漆、各向异性、AO、高度映射、SSS、背光、折射、detail、bent normal、粒子动画等),只有先开启功能才产生对应着色成本。
  • set_flag(flag, enable):开关可选行为(禁用深度测试、顶点色作 albedo、sRGB 顶点色、点大小、固定尺寸、公告板保持缩放、双套 UV 三平面、AO/emission 用 UV2、强制 sRGB、不接收阴影、禁用环境光/雾/高光遮蔽、shadow to opacity、纹理平铺、反转高度贴图、皮肤模式、粒子轨迹等)。
  • set_texture(param, texture):向指定 TextureParam 槽位写入贴图(如 TEXTURE_ALBEDO、TEXTURE_NORMAL、TEXTURE_ORM)。

一个典型的运行时材质创建示例:

var mat := StandardMaterial3D.new()
mat.albedo_color = Color(1, 0.8, 0.3)
mat.metallic = 0.8          # 高金属度
mat.roughness = 0.3         # 较光滑
mat.emission_enabled = true # 等价于 set_feature(BaseMaterial3D.FEATURE_EMISSION, true)
mat.emission = Color(0.5, 0.2, 0.1)
mat.normal_enabled = true
mat.normal_texture = preload("res://brick_normal.png")
mesh_instance.material_override = mat  # 仅覆盖该节点

关键枚举速查

主题 选项
Transparency Disabled / Alpha / Alpha Scissor / Alpha Hash / Depth Pre-Pass
ShadingMode Unshaded / Per-Pixel / Per-Vertex(默认 Per-Pixel)
BlendMode Mix / Add / Subtract / Multiply / Premultiplied Alpha(默认 Mix)
CullMode Back / Front / Disabled(默认 Back)
DepthDrawMode Opaque Only / Always / Never / Depth Pre-Pass(默认 Opaque Only)
DiffuseMode Burley / Lambert / Lambert Wrap / Toon(默认 Burley)
SpecularMode SchlickGGX / Toon / Disabled(默认 SchlickGGX)
BillboardMode Disabled / Enabled / Y-Billboard / Particle Billboard
AlphaAntiAliasing Off / AlphaToCoverage / AlphaToCoverageAndToOne
TextureFilter Nearest / Linear / NearestWithMipmaps / LinearWithMipmaps / 两种各向异性(默认 LinearWithMipmaps)
TextureChannel Red / Green / Blue / Alpha / Grayscale
DistanceFadeMode Disabled / Pixel Alpha / Pixel Dither / Object Dither
StencilMode Disabled / Outline / XRay / Custom

在编辑器中,绝大多数参数位于检查器的 BaseMaterial3D 分类下;ORM 材质与该分类几乎一致,唯一区别是把 AO、粗糙度、金属度的独立纹理合并为单张 ORM 纹理。掌握了上述参数的含义、默认值与相互制约关系,你就能在 StandardMaterial3D、ORMMaterial3D 与 BaseMaterial3D 之间自由取舍,在不写一行 shader 的情况下覆盖从金属、皮肤到粒子特效的绝大多数 3D 材质需求。

登录后查看全文
godot-docs