Chapter 214: XYZLoader

Core Idea

A loader for the XYZ format.

XYZ is a very simple format for storing point clouds. The layouts XYZ (points) and XYZRGB (points + colors) are supported.

Code Examples

const loader = new XYZLoader();
const geometry = await loader.loadAsync( 'models/xyz/helix_201.xyz' );
geometry.center();
const vertexColors = ( geometry.hasAttribute( 'color' ) === true );
const material = new THREE.PointsMaterial( { size: 0.1, vertexColors: vertexColors } );
const points = new THREE.Points( geometry, material );
scene.add( points );

• What it demonstrates: Typical usage of XYZLoader.

Reference Tables

Constructor

Signature
new XYZLoader()

Methods

Method	Description
.load( url : string, onLoad : function, onProgress : onProgressCallback, onError : onErrorCallback )	Starts loading from the given URL and passes the loaded XYZ asset to the onLoad() callback.
.parse( text : string ) : BufferGeometry	Parses the given XYZ data and returns the resulting geometry.

Key Takeaways

1. XYZLoader extends: Loader
2. Key methods: load, parse.

Connects To

• Loader: parent class
• Source: examples/jsm/loaders/XYZLoader.js