- 致编者:请牢记我们的域名wiki.mcbe-dev.net!
- 致编者:欢迎加入本Wiki的官方交流QQ群或Discord服务器!
- 基岩版1.19.31现已发布!(了解更多)
- Inner Core现已支持Xbox模组联机!(了解更多)
- 如果您是第一次来到本Wiki,欢迎注册一个账户
- 点击顶部的“编辑”或“编辑源代码”按钮即可编辑当前页面
- 请知悉:在不登录时也可以编辑和新建页面,但是您当前的IP地址会记录在编辑历史中
手册:材质/0.0.0..0.9.9
来自Minecraft基岩版开发Wiki
该格式版本下不允许字段继承。
- <material_name>[:<inherited_material_name>]:一个材质,可以使用
:
继承另一个材质。- states:定义了该材质的渲染状态列表,决定了该材质提供的功能。
- :一个渲染状态。如果在所有 [+-]states解析结束时列表中存在
EnableAlphaToCoverage
渲染状态,将自动为该材质添加ALPHA_TO_COVERAGE
宏定义,该操作先于 [+-]defines的解析。
- :一个渲染状态。如果在所有 [+-]states解析结束时列表中存在
- vertexShader:定义了该材质的顶点着色器路径,格式通常为
shaders/<shader_name>.vertex
。引擎会为GFX API插入中间值和追加后缀,对于HLSL,会在shaders
后插入/hlsl
,并在文件末追加.hlsl
扩展名以构成完整路径;对于GLSL,会在shaders
后插入/glsl
以构成完整路径。该追加操作适用于以下所有类型的着色器路径。 - fragmentShader:定义了该材质的片元着色器路径,格式通常为
shaders/<shader_name>.fragment
。 - geometryShader:定义了该材质的几何着色器路径,格式通常为
shaders/<shader_name>.geometry
。 - vrGeometryShader:定义了该材质的VR几何着色器路径,格式通常为
shaders/<shader_name>.geometry
。 - defines:定义了该材质使用的宏定义列表,用于配合激活或切换着色器代码中的特定部分。
- :一个宏定义。
- depthFunc:该材质的深度模板测试中使用的深度函数,是一个比较函数,负责源深度值与深度缓冲区比较。
- depthStencilFaceName:该材质的模板测试中使用的面的名称,当前为一个占位符。
- frontFace:该材质正面的模板测试。
- backFace:该材质背面的模板测试。
- stencilRefOverride:该材质的模板测试中是否使用参考值覆写,如果为真,将使用 stencilRef的值为模板测试参考值,默认为假。
- stencilRef:该材质的模板测试的参考值覆写,接受非负整数。存在该字段时 stencilRefOverride默认为真。
- stencilReadMask:该材质的模板测试的读取掩码,会在模板测试比较前与参考值进行按位与运算,接受非负整数。
- stencilWriteMask:该材质的模板测试的写入掩码,会在模板测试比较后与参考值进行按位与运算,接受非负整数。
- blendSrc:颜色混合前源颜色需要采取的操作,是一个混合目标,默认为
SourceAlpha
。 - blendDst:颜色混合前缓冲区中的目标颜色需要采取的操作,是一个混合目标,默认为
OneMinusSrcAlpha
。 - alphaSrc:透明度混合前源颜色需要采取的操作,是一个混合目标,默认为
One
。 - alphaDst:透明度混合前缓冲区中的目标颜色需要采取的操作,是一个混合目标,默认为
OneMinusSrcAlpha
。 - samplerStates:定义了该材质使用的纹理采样状态列表,用于配置纹理的过滤与折绕。
- vertexFields:该材质使用的顶点场列表,用于决定该材质渲染时网格的每个顶点都存有何种信息。
- :一个顶点场。
- field:该顶点场的顶点场类型。
- :一个顶点场。
- depthBias:该材质光栅化时使用的深度偏差。
- slopeScaledDepthBias:该材质光栅化时使用的斜率缩放深度偏差。
- depthBiasOGL:OpenGL平台上该材质光栅化时使用的深度偏差。
- slopeScaledDepthBiasOGL:OpenGL平台上该材质光栅化时使用的斜率缩放深度偏差。
- msaaSupport:材质光栅化时是否支持多重采样抗锯齿(MSAA),支持的值见MSAA支持。
- primitiveMode:该材质的基本图元模式,默认为
TriangleList
。 - renderTargetFormats:该材质的渲染目标格式列表。
- :一个渲染目标格式列表。
- :一个渲染目标格式,是一个纹理格式。
- :一个渲染目标格式列表。
- isAnimatedTexture:该材质的渲染目标是否是动态纹理。
- varients:定义了该材质的变体,变体会继承本体定义的所有属性,并支持覆写、添加或删去一些属性。
- varient:相当于 varients。
- :变体列表中的一个元素。
- <variant_name>:一个变体,变体列表中每个元素只允许定义一个变体,最终变体的可以用于引用的完整名称将为
<material_name>.<variant_name>
。- 材质定义V0 参见Manual:材质/RenderMaterialV0
- <variant_name>:一个变体,变体列表中每个元素只允许定义一个变体,最终变体的可以用于引用的完整名称将为
- :变体列表中的一个元素。
-
PolygonOffsetLevel:多边形偏移级别。
- states:定义了该材质的渲染状态列表,决定了该材质提供的功能。