BufferGeometry
Object3D
Raycaster
Camera
CubeCamera
PerspectiveCamera
OrthographicCamera
StereoCamera
Clock
Curve
CurvePath
Path
Shape
ShapePath
ArrowHelper
AxesHelper
BoxHelper
Box3Helper
CameraHelper
DirectionalLightHelper
GridHelper
PolarGridHelper
HemisphereLightHelper
PlaneHelper
PointLightHelper
SkeletonHelper
SpotLightHelper
Light
PointLight
RectAreaLight
SpotLight
DirectionalLight
HemisphereLight
LightShadow
PointLightShadow
AnimationLoader
AudioLoader
BufferGeometryLoader
CompressedTextureLoader
CubeTextureLoader
DataTextureLoader
FileLoader
ImageBitmapLoader
ImageLoader
Loader
LoaderUtils
MaterialLoader
ObjectLoader
TextureLoader
LoadingManager
Material
Box2
Box3
Color
Cylindrical
Euler
Frustum
Interpolant
Line3
MathUtils
Matrix3
Matrix4
Plane
Quaternion
AnimationAction
AnimationClip
AnimationMixer
AnimationObjectGroup
AnimationUtils
keyframeTrack
PropertyBinding
PropertyMixer
BooleanKeyframeTrack
QuaternionKeyframeTrack
StringKeyframeTrack
Audio
AudioAnalyser
AudioContext
AudioListener
PositionalAudio

Material.customProgramCacheKey()

customProgramCacheKey是three.js中的一个材料(Material)属性,用于定义自定义渲染程序的缓存键。如果两个材料具有相同的缓存键,则它们将共享相同的渲染程序。这有助于提高性能,因为这意味着渲染程序只需要构建一次,而不是每次绘制时都要重新构建。

语法

material.customProgramCacheKey = function () { return string; };

参数

该函数不接受任何参数。

返回值

该函数应返回一个唯一的字符串作为缓存键。

示例

下面的示例演示如何使用customProgramCacheKey来定义一个自定义渲染程序的缓存键:

var myMaterial = new THREE.MeshBasicMaterial();
myMaterial.customProgramCacheKey = function () {
    // 返回一个唯一的字符串作为缓存键
    return 'myMaterial';
};

在这个例子中,当渲染器需要使用该材料进行渲染时,它将首先检查是否存在具有缓存键myMaterial的渲染程序。如果存在,则重复使用该渲染程序。否则,渲染器将构建一个新的渲染程序,并将缓存键设置为myMaterial

注意事项

  • 如果一个材料的customProgramCacheKey与另一个材料的相同,则它们将共享相同的渲染程序。这可能会导致不希望的结果,例如材料之间的交叉通道等。
  • 请注意确保返回的缓存键是唯一的,并在所有材料中都是唯一的。最好使用一个唯一的字符串,例如材料的名称,以确保这一点。

参考文献