# [name]

[page:Layers] 对象为 [page:Object3D] 分配 1个到 32 个图层。32个图层从 0 到 31 编号标记。 在内部实现上，每个图层对象被存储为一个 [link:https://en.wikipedia.org/wiki/Mask_(computing) bit mask]， 默认的，所有 [page:Object3D] 对象都存储在第 0 个图层上。
图层对象可以用于控制对象的显示。当 [page:Camera camera] 的内容被渲染时与其共享图层相同的物体会被显示。每个对象都需要与一个 [page:Camera camera] 共享图层。
每个继承自 [page:Object3D] 的对象都有一个 [page:Object3D.layers] 对象。

## 构造函数

### [name]()

创建一个新的图层对象，该对象默认与第 0 图层关联。

## 属性

### [property:Integer mask]

用 bit mask 表示当前图层对象与 0 - 31 中的哪些图层相对应。所属层所对应的比特位为 1，其他位位 0。

## 方法

### [method:undefined disable]( [param:Integer layer] )

layer - 一个 0 - 31 的整数。
删除图层对象与参数指定图层的对应关系。

### [method:undefined enable]( [param:Integer layer] )

layer - 一个 0 - 31 的整数。
增加图层对象与参数指定图层的对应关系。

### [method:undefined set]( [param:Integer layer] )

layer - 一个 0 - 31 的整数。
删除图层对象已有的所有对应关系，增加与参数指定的图层的对应关系。

### [method:Boolean test]( [param:Layers layers] )

layers - 一个图层对象。
如果传入图层对象与当前对象属于相同的一组图层，则返回 true，否则返回 false。

### [method:Boolean isEnabled]( [param:Integer layer] )

layer - an integer from 0 to 31.
Returns true if the given layer is enabled.

### [method:undefined toggle]( [param:Integer layer] )

layer - 一个 0 - 31 的整数。
根据参数切换对象所属图层。

### [method:undefined enableAll]()

Add membership to all layers.

### [method:undefined disableAll]()

Remove membership from all layers.

## 源代码

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