# [name]

Uniforms 是 [link:https://www.opengl.org/documentation/glsl/ GLSL] 着色器中的全局变量。

### 示例

在声明一个 [page:ShaderMaterial] 的 Uniform 变量时，该变量被值或对象声明。 When declaring a uniform of a [page:ShaderMaterial], it is declared by value or by object.

`uniforms: { time: { value: 1.0 }, resolution: new THREE.Uniform(new THREE.Vector2()) }`

### Uniform 种类

每个 Uniform 必须包括一个 *value* 属性。value 的类型必须和下表中 GLSL 的基本类型相对应。同样，Uniform 的结构体和队列 也是支持的。 GLSL基本类型队列必须要么被显示声明为一个 THREE 对象的队列，要么被声明为一个包含所有对象数据的队列。这就是说， 队列中的 GLSL 基础类型不能再是一个队列。举例，一个有 5 个 *vec2* 元素的队列，必须是一个包含 5 个 [page:Vector2] 的队列数组， 或包含 10 个 *number* 的队列。

Uniform 类型
GLSL 类型 | JavaScript 类型
--- | ---
int | [page:Number]
float | [page:Number]
bool | [page:Boolean]
bool | [page:Number]
vec2 | [page:Vector2 THREE.Vector2]
vec2 | [page:Float32Array Float32Array] (*)
vec2 | [page:Array Array] (*)
vec3 | [page:Vector3 THREE.Vector3]
vec3 | [page:Color THREE.Color]
vec3 | [page:Float32Array Float32Array] (*)
vec3 | [page:Array Array] (*)
vec4 | [page:Vector4 THREE.Vector4]
vec4 | [page:Quaternion THREE.Quaternion]
vec4 | [page:Float32Array Float32Array] (*)
vec4 | [page:Array Array] (*)
mat2 | [page:Float32Array Float32Array] (*)
mat2 | [page:Array Array] (*)
mat3 | [page:Matrix3 THREE.Matrix3]
mat3 | [page:Float32Array Float32Array] (*)
mat3 | [page:Array Array] (*)
mat4 | [page:Matrix3 THREE.Matrix4]
mat4 | [page:Float32Array Float32Array] (*)
mat4 | [page:Array Array] (*)
ivec2, bvec2 | [page:Float32Array Float32Array] (*)
ivec2, bvec2 | [page:Array Array] (*)
ivec3, bvec3 | [page:Int32Array Int32Array] (*)
ivec3, bvec3 | [page:Array Array] (*)
ivec4, bvec4 | [page:Int32Array Int32Array] (*)
ivec4, bvec4 | [page:Array Array] (*)
sampler2D | [page:Texture THREE.Texture]
samplerCube | [page:CubeTexture THREE.CubeTexture]

(*) 与最内层队列中 GSLS 的类型保持一致。包含队列中所有矢量的元素或矩阵中的元素。

## 构造函数

### [name]( [param:Object value] )

value -- 包含需要设置 Uniform 数据的对象。 数据类型必须是上述类型中的一种。

## 属性

### [property:Object value]

当前 uniform 的值。

## 方法

### [method:Uniform clone]()

返回该 Uniform 的克隆。
如果 Uniform 的 value 属性是一个带 clone() 方法的 [page:Object]，则克隆该对象时，value 的 clone() 方法也会被调用，否则克隆时只会使用赋值语句。 队列中的值会在该 Uniform 和 被克隆对象间共享。
该方法的使用示例详见 [example:webgldeferred_animation WebGL deferred animation]。

## 源代码

[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]