TextureMinificationFilter | Cesium JS手册

Cesium JS API

TextureMinificationFilter

在Cesium中，TextureMinificationFilter（纹理缩小滤波器）决定了当纹理被缩小时，如何从多个纹素中计算一个像素的颜色。

在三维计算机图形学中，纹理是对一个或多个图像的描述，由多个小方块组成，每个小方块称为纹素，每个纹素存储了图像的颜色信息。在渲染中，我们将纹理映射到几何图形上，以实现更加真实的视觉效果。

当纹理需要被缩小时，由于多个颜色值需要被压缩到一起，一些问题可能会发生，例如图像像素块平滑程度下降、出现棋盘格等其他伪像，因此我们需要通过滤波器来消除可能发生的问题。

在 Cesium 中，TextureMinificationFilter 提供了三种可用的缩小滤波方式：

NEAREST: 使用最邻近滤波器选择最接近的单个纹素，它是最快的过滤方式，但可能会导致锯齿状的纹理。
LINEAR: 使用双线性滤波器计算相邻四个纹素的平均值，它比 NEAREST 有更好的平滑处理效果，并且适用于大多数情况。
NEAREST_MIPMAP_NEAREST: 使用最邻近滤波器选择合适的 mipmap 并使用该 mipmap 上的最邻近值。由于使用了预计算的 mipmap，它比 NEAREST 更消耗性能。
LINEAR_MIPMAP_NEAREST: 对合适的 mipmap 使用双线性滤波器来计算相邻4个纹素的平均值，选中的 mipmap 将使用最邻近滤波器。由于使用了预计算的 mipmap，它比 LINEAR 更消耗性能。
NEAREST_MIPMAP_LINEAR: 使用最邻近滤波器选择上下 mipmaps 的最邻近值，并在 mipmap 中执行双线性滤波。由于使用了预计算的 mipmap，它比 LINEAR_MIPMAP_NEAREST 更消耗性能。
LINEAR_MIPMAP_LINEAR: 使用双线性滤波器选择上下 mipmaps 的最邻近值，并在不同 mipmaps 之间执行双线性滤波，以平滑结果。由于使用了预计算的 mipmap，它比 NEAREST_MIPMAP_NEAREST 更消耗性能。

注意：在使用 mipmaps 方式时，需要调用贴图 generateMipmaps() 方法进行预计算。

var textureMinificationFilter = Cesium.TextureMinificationFilter.LINEAR;

NEAREST: 以最邻近滤波器进行缩放。
LINEAR: 使用双线性滤波器计算纹理，以进行缩放。
NEAREST_MIPMAP_NEAREST: 选择使用 mipmap 中最适合大小的图像，并在该图像上使用最邻近滤波器，以进行纹理缩小。
LINEAR_MIPMAP_NEAREST: 选择使用mipmap中最适合的大小的图像，并使用双线性滤波计算颜色值。
NEAREST_MIPMAP_LINEAR: 选择上下两个 mipmaps 中最适合的大小的图像，并执行双线性滤波来计算颜色值。
LINEAR_MIPMAP_LINEAR: 同上。

例如，将默认的 TextureMinificationFilter 值从 LINEAR 更改为 NEAREST：

var viewer = new Cesium.Viewer('cesiumContainer', {
    terrainProvider: provider
});

// 从 `LINEAR` 更改为 `NEAREST` 以进行缩小纹理过滤
viewer.scene.groundPrimitive.createEntityPrimitives = false;
viewer.scene.groundPrimitive._tileProvider._volumes[0].material.westTexture.minificationFilter =
   Cesium.TextureMinificationFilter.NEAREST;
viewer.scene.groundPrimitive._tileProvider._volumes[0].material.southTexture.minificationFilter =
   Cesium.TextureMinificationFilter.NEAREST;
viewer.scene.groundPrimitive._tileProvider._volumes[0].material.eastTexture.minificationFilter =
   Cesium.TextureMinificationFilter.NEAREST;
viewer.scene.groundPrimitive._tileProvider._volumes[0].material.northTexture.minificationFilter =
   Cesium.TextureMinificationFilter.NEAREST;

枚举值之一： NEAREST、LINEAR、NEAREST_MIPMAP_NEAREST、LINEAR_MIPMAP_NEAREST、NEAREST_MIPMAP_LINEAR 或 LINEAR_MIPMAP_LINEAR。

语法

实例

参见

示例

返回值