File: PointsMaterial.md | Updated: 11/15/2025
A material for rendering point primitives.
Materials define the appearance of renderable 3D objects.
const vertices = [];
for ( let i = 0; i < 10000; i ++ ) {
const x = THREE.MathUtils.randFloatSpread( 2000 );
const y = THREE.MathUtils.randFloatSpread( 2000 );
const z = THREE.MathUtils.randFloatSpread( 2000 );
vertices.push( x, y, z );
}
const geometry = new THREE.BufferGeometry();
geometry.setAttribute( 'position', new THREE.Float32BufferAttribute( vertices, 3 ) );
const material = new THREE.PointsMaterial( { color: 0x888888 } );
const points = new THREE.Points( geometry, material );
scene.add( points );
Constructs a new points material.
parameters | An object with one or more properties defining the material's appearance. Any property of the material (including any property from inherited materials) can be passed in here. Color values can be passed any type of value accepted by Color#set.
---|---
The alpha map is a grayscale texture that controls the opacity across the surface (black: fully transparent; white: fully opaque).
Only the color of the texture is used, ignoring the alpha channel if one exists. For RGB and RGBA textures, the renderer will use the green channel when sampling this texture due to the extra bit of precision provided for green in DXT-compressed and uncompressed RGB 565 formats. Luminance-only and luminance/alpha textures will also still work as expected.
Default is null.
Color of the material.
Default is (1,1,1).
Whether the material is affected by fog or not.
Default is true.
This flag can be used for type testing.
Default is true.
The color map. May optionally include an alpha channel, typically combined with Material#transparent or Material#alphaTest. The texture map color is modulated by the diffuse color.
Default is null.
Defines the size of the points in pixels.
Might be capped if the value exceeds hardware dependent parameters like gl.ALIASED_POINT_SIZE_RANGE.
Default is 1.
Specifies whether size of individual points is attenuated by the camera depth (perspective camera only).
Default is true.