StencilFunction

StencilFunction是CesiumJS中的一个对象，用于设置渲染器的模板测试功能。

Stencil Testing是一种技术，它允许在渲染几何体时对像素进行测试，并在通过测试后才绘制它们。Stencil Testing常常与其它渲染技术（如抗锯齿、阴影等）一起使用。

在CesiumJS中，StencilFunction可以用来指定一个Stencil Test，它定义了三个属性：

1. enabled：指示是否启用Stencil Testing
2. referenceValue：Stencil Testing使用一个参考值（Reference Value），与每个像素值进行比较。这个属性用于指定参考值。
3. compareFunction：Stencil Testing使用一个比较函数（Compare Function），将每个像素的值与参考值进行比较。这个属性用于指定比较函数。

StencilFunction的语法如下：

var stencilFunction = new Cesium.StencilFunction({
    enabled: true | false,
    referenceValue: number,
    compareFunction: Cesium.StencilFunctionCompareFunction
});

其中，enabled可以是一个布尔值，表示是否启用Stencil Testing。

referenceValue是一个数字，用于设置Stencil Testing的参考值。需要注意的是，这个值应该在0到255之间。

compareFunction是一个枚举值，用于指定Stencil Testing的比较函数。CesiumJS支持以下比较函数：

• LESS
• EQUAL
• LESS_OR_EQUAL
• GREATER
• NOT_EQUAL
• GREATER_OR_EQUAL
• ALWAYS
• NEVER

Stencil Testing的工作原理如下：

1. 每个像素首先进入Stencil Test。
2. 然后，将像素的值与参考值进行比较。
3. 如果比较结果满足要求（根据比较函数决定），则像素通过了Stencil Test。否则，该像素将不被渲染。

例如，如果设置了以下StencilFunction：

var stencilFunction = new Cesium.StencilFunction({
    enabled: true,
    referenceValue: 100,
    compareFunction: Cesium.StencilFunctionCompareFunction.LESS_OR_EQUAL
});

则像素的Stencil Testing将使用如下规则：

• 如果当前像素值小于等于100，则该像素通过了Stencil Testing。
• 如果当前像素值大于100，则该像素未通过Stencil Testing，不被渲染。

StencilFunction还可以通过设置Cesium.RenderState的stencil属性来应用。例如：

var renderState = Cesium.RenderState.fromCache({
    stencil : {
        enabled : true,
        frontFunction : stencilFunction
    }
});

这个renderState可以将Stencil Testing应用到某个Primitive或GeometryInstance的渲染过程中。

更多内容请参阅Cesium官方文档中有关StencilFunction和RenderState的部分。

（完）