Chapter 53: TextGeometry

Core Idea

A class for generating text as a single geometry. It is constructed by providing a string of text, and a set of parameters consisting of a loaded font and extrude settings.

See the FontLoader page for additional details.

TextGeometry uses typeface.json generated fonts. Some existing fonts can be found located in /examples/fonts.

Code Examples

const loader = new FontLoader();
const font = await loader.loadAsync( 'fonts/helvetiker_regular.typeface.json' );
const geometry = new TextGeometry( 'Hello three.js!', {
	font: font,
	size: 80,
	depth: 5,
	curveSegments: 12
} );

• What it demonstrates: Typical usage of TextGeometry.

Reference Tables

Constructor

Signature
new TextGeometry( text : string, parameters : TextGeometry~Options )

Key Takeaways

1. TextGeometry extends: EventDispatcher → BufferGeometry → ExtrudeGeometry

Connects To

• EventDispatcher: parent class
• BufferGeometry: parent class
• ExtrudeGeometry: parent class
• Source: examples/jsm/geometries/TextGeometry.js