Skip to content

Material ​

继承自:

描述 ​

材质节点,管理渲染相关的通用材质属性(深度测试/写入、背面剔除、主纹理与平铺、法线、自发光、边缘光、透明度、阴影与亮度等)

属性 ​

DepthFunc  DepthFunc
深度测试函数。决定片元通过与否的深度比较方式,常用于透明/半透明与遮挡关系的控制。默认值为NearEqual
DepthWrite  DepthWrite
深度写入开关。开启时当前片元会写入深度缓冲;关闭常用于透明物体以避免遮挡错误。默认值为kDepthWriteEnable
int  RenderGroup
渲染分组。用于渲染阶段的排序/筛选策略,较小的分组优先渲染。默认值为0
CullMode  CullMode
背面剔除模式。用于控制三角形正面/背面的剔除策略,减少无效像素绘制。默认值为kCullBack,即剔除背面三角形
string  MainTexture
主纹理资源路径。物体表面的基础颜色贴图,默认值为空字符串
Vector2  MainTextureTileScale
主纹理平铺缩放。设置UV平铺倍率,用于控制重复与缩放。默认值为(1.0,1.0)
Vector2  MainTextureTileOffset
主纹理平铺偏移。设置UV偏移量,用于滚动或取样起点调整。默认值为(0.0,0.0)
float  SpecScale
高光范围系数。控制高光分布范围/粗糙度相关的系数。默认值为1.0
float  SpecIntensity
高光强度。控制镜面高光亮度。默认值为1.0
ColorQuad  ShadowColor
阴影着色颜色。用于调整阴影区域的颜色倾向。默认值为(255,255,255,255)
float  AlphaTransparent
整体透明度系数(0~1)。影响整体输出颜色的透明度。默认值为1.0
float  RGBATransparent
RGB 通道透明度系数。对颜色通道透明度进行额外缩放。默认值为1.0
bool  EnableEmissive
是否启用自发光。启用后可使用自发光纹理/颜色及闪光参数。默认值为false
string  EmissiveTexture
自发光纹理资源路径。用于提供发光图样或遮罩,默认值为空字符串
ColorQuad  EmissiveTextureColor
自发光颜色。与自发光纹理一起决定最终发光颜色与强度。默认值为(255,255,255,255)
float  GlitterSpeed
闪光速度(特效)。控制自发光闪烁动画的速度。默认值为1.0
float  GlitterPower
闪光强度(特效)。控制自发光闪烁的亮度幅度。默认值为1.0
float  ShadowPowerMin
阴影调节系数最小值。与最大值配合用于控制阴影强弱范围。默认值为0.8
float  ShadowPowerMax
阴影调节系数最大值。配合最小值共同限定阴影影响强度。默认值为1.1
float  Brightness
亮度。用于提升整体发光/反射强度,常用于卡通或高亮效果。默认值为0.0
float  StepAmount
阶梯化过渡强度。用于非真实感/卡通分段过渡的强度。默认值为0.0
float  OnStep
阶梯化阈值。与 StepAmount 配合用于确定分段边界。默认值为0.0
ColorQuad  InnerColor
内发光颜色。用于角色/物体内部发光的颜色调节。默认值为(255,255,255,255)
bool  EnableRimColor
是否启用边缘光。启用后可设置边缘光宽度/强度/颜色。默认值为false
float  RimWidth
边缘光宽度。控制由视角决定的轮廓高亮的厚度。默认值为0.0
float  RimIntensity
边缘光强度。控制轮廓高亮亮度。默认值为0.0
ColorQuad  RimColor
边缘光颜色。与宽度/强度配合决定边缘光最终观感。默认值为(255,255,255,255)
string  NormalTexture
法线纹理资源路径。用于细节凹凸效果的光照响应。默认值为空字符串
float  DiffuseIns
漫反射强度。控制漫反射分量的整体强弱。默认值为0.6
float  ShadowIns
阴影影响强度。决定阴影对最终光照结果的影响程度。默认值为0.54