NSF框架(index)

// COMMENTS: 当NSF文件被解析后,NameOfShader是解析后的NSB文件名, // 如:NameOfShader.NSB
NSFShader NameOfShader
{
// 可选的描述字符串,它显示在艺术工具里.
"This is an optional description string.\nIt will be displayed to the
artists."
// 可选的用户定义数据块.这些允许开发者扩展NSF格式,避免和
// lex/grammar 文件混淆
UserDefinedData NameOfUDDBlock
{
... Data entries
}
UserDefinedData NameOfUDDBlock2
{
... Data entries
}
// 可选对象部分–只能有一个
Objects
{
// Object definitions
// Refer to the section on objects.
}
// 全局属性列表–只能有一个
Global_Attributes
{
// These are global attributes the shader utilizes
// Refer to the section on attributes.
}
// 每个对象属性列表–只能有一个
Attributes
{
// These are per-object attributes the shader utilizes
// Refer to the section on attributes.
}
// 封装定义–能有多个定义
PackingDef NameOfPackingDef0
{
// First Packing method defined here
// Refer to the packing definition section
}
...
PackingDef NameOfPackingDefN
{
// nth Packing method defined here
}
// 执行,这里可以有多个执行定义在一个着色器里.它允许使用适合老硬件
// 的落后的方法.
// First implementation
Implementation NameOfImplementation0
{
// 可选的描述字符串,它会显示在美工工具上.
"This is an optional description string.\nIt will be displayed to the
artists\nexplaining the implementation details."
// 这个implementation的需求.
Requirements
{
// Requirements of the implementation
// This section is detailed below.
}
// 可选的类名,用于扩展NSF/NSB着色器系统,使其允许开发者派生出他们自己的// 来自NiBinaryShader的类
ClassName = NameOfDerivedClass
// 可选的用户定义数据块.这些允许开发者扩展NSF格式,避免和
// lex/grammar 文件混淆
UserDefinedData NameOfUDDBlock
{
... Data entries
}
UserDefinedData NameOfUDDBlock2
{
... Data entries
}
// 封装定义声明
PackingDef NameOfPackingDefToUse
// 可选的“全局”渲染状态
// 这些是考虑好去设置每一个在Implementation中的pass的.
// pass可以自由地使用它们
RenderStates
{
// Render state settings
// This section is detailed below
}
// 可选的顶点着色器常量匹配
// 这些被考虑去设置每一个Implementation中的pass
// pass可以自由地使用它们
VS_Constantmap
{
// Constant mappings
// This section is detailed below
}
// 可选的几何体渲染器常量匹配
// 这些被考虑去设置每一个Implementation中的pass
// pass可以自由地使用它们
GS_Constantmap
{
// Constant mappings
// This section is detailed below
}
// 可选的像素着色器常量匹配
// 这些被考虑去设置每一个Implementation中的pass
// pass可以自由地使用它们
PS_Constantmap
{
// Constant mappings
// This section is detailed below
}
// 它能够作为一些效果需求的过程
// pass必须按照渲染顺序写
// First pass
Pass OPTIONAL_PassName1
{
// 可选的用户定义数据块.这些允许开发者扩展NSF格式,避免和// lex/grammar 文件混淆
UserDefinedData NameOfUDDBlock
{
... Data entries
}
UserDefinedData NameOfUDDBlock2
{
... Data entries
}
// 可选的局部渲染状态
RenderStates
{
// Render state settings
}
// 可选的顶点着色器常量映射
VS_Constantmap
{
// Vertex Shader Constant mappings
}
// 可选的顶点着色器程序
VSProgram VertexShaderProgramName
// 可选的几何着色器常量映射
GS_Constantmap
{
// Geometry Shader Constant mappings
}
// 可选的几何着色器程序
GSProgram GeometryShaderProgramName
// 可选的像素着色器常量映射
PS_Constantmap
{
// Pixel Shader Constant mappings
}
// 可选的像素着色器程序
PSProgram PixelShaderProgramName
// 可选的阶段0
Stage 0 OPTIONAL_StageName1
{
// Texture stage settings
// See section below for details
}
...
// 可选的阶段N
Stage N OPTIONAL_StageNameN
{
// Texture stage settings
// See section below for details
}
// 可选的采样器0
Sampler 0 OPTIONAL_SamplerName1
{
// Sampler settings
// See section below for details
}
...
// 可选的采样器N
Sampler M OPTIONAL_SamplerNameM
{
// Sampler settings
// See section below for details
}
// 可选的纹理0
Texture 0 OPTIONAL_TextureName1
{
// Texture settings
// See section below for details
}
// 可选的纹理N
Texture T OPTIONAL_TextureNameT
{
// Texture settings
// See section below for details
}
}// pass 0 End
...
// nth pass
Pass OPTIONAL_PassNameN
{
// Definition of a rendering pass.
// This section is detailed below.
}
}// Implementation 0 End
...
// nth implementation
Implementation NameOfImplementationN
{
}
}// NSFShader End。