# PLY导出器([name])

一个用于 `PLY` 文件格式的导出器。
[link:https://en.wikipedia.org/wiki/PLY_(file_format) PLY] (Polygon or Stanford Triangle Format) 是一种用于高效传输和加载简单、静态的3D内容的文件格式，采用紧凑的格式。支持二进制和 ASCII 两种格式。PLY 可以存储顶点位置、颜色、法线和 UV 坐标。不保存纹理或纹理引用。

## 引入

[name] 是一个附加组件，必须显式导入。请参阅 [link:#manual/introduction/Installation Installation / Addons]。

`import { PLYExporter } from 'three/addons/exporters/PLYExporter.js';`

## 代码示例

`// Instantiate an exporter const exporter = new PLYExporter(); // Parse the input and generate the ply output const data = exporter.parse( scene, options ); downloadFile( data );`

## 构造函数

### [name]()

创建一个新的 [name] 实例。

## 方法

### [method:Object parse]( [param:Object3D input], [param:Function onDone], [param:Object options] )

[page:Object input] — Object3D
[page:Function onCompleted] — 将在导出完成时调用。参数将是生成的 ply ascii 或二进制 ArrayBuffer。
[page:Options options] — 导出选项

- excludeAttributes - array. 要从导出的 PLY 文件中显式排除哪些属性。有效值为 'color'、'normal'、'uv' 和 'index'。如果排除三角形索引，则导出点云。默认是一个空数组。
- binary - bool. 以二进制格式导出，返回 ArrayBuffer。默认为 false。

从输入对象生成 PLY 文件数据作为字符串或 ArrayBuffer（ASCII 或二进制）输出。返回的数据与传递给 "onCompleted" 函数的数据相同。如果对象由多个子元素和几何体组成，它们将在文件中合并为一个单独的网格。

## 源代码

[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/exporters/PLYExporter.js examples/jsm/exporters/PLYExporter.js]