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