[page:BufferGeometry] → [page:ExtrudeGeometry] →

# 文本缓冲几何体（[name]）

一个用于将文本生成为单一的几何体的类。 它是由一串给定的文本，以及由加载的font（字体）和该几何体[page:ExtrudeGeometry]父类中的设置所组成的参数来构造的。 请参阅[page:FontLoader]页面来查看更多详细信息。

## 进口

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

`import { TextGeometry } from 'three/addons/geometries/TextGeometry.js';`

## 代码示例

`const loader = new FontLoader(); loader.load( 'fonts/helvetiker_regular.typeface.json', function ( font ) { const geometry = new TextGeometry( 'Hello three.js!', { font: font, size: 80, height: 5, curveSegments: 12, bevelEnabled: true, bevelThickness: 10, bevelSize: 8, bevelSegments: 5 } ); } );`

## 例子

[example:webgl_geometry_text geometry / text ]

## 构造器

### [name]([param:String text], [param:Object parameters])

text — 将要显示的文本。
parameters — 包含有下列参数的对象：

- font — THREE.Font的实例。
- size — Float。字体大小，默认值为100。
- height — Float。挤出文本的厚度。默认值为50。
- curveSegments — Integer。（表示文本的）曲线上点的数量。默认值为12。
- bevelEnabled — Boolean。是否开启斜角，默认为false。
- bevelThickness — Float。文本上斜角的深度，默认值为20。
- bevelSize — Float。斜角与原始文本轮廓之间的延伸距离。默认值为8。
- bevelSegments — Integer。斜角的分段数。默认值为3。

## 可用的字体

文本几何体使用 typeface.json所生成的字体。 一些已有的字体可以在/examples/fonts中找到，且必须在页面中引入。

字体 | 字重 | 风格 | 文件路径
--- | --- | --- | ---
helvetiker | normal | normal | /examples/fonts/helvetiker_regular.typeface.json
helvetiker | bold | normal | /examples/fonts/helvetiker_bold.typeface.json
optimer | normal | normal | /examples/fonts/optimer_regular.typeface.json
optimer | bold | normal | /examples/fonts/optimer_bold.typeface.json
gentilis | normal | normal | /examples/fonts/gentilis_regular.typeface.json
gentilis | bold | normal | /examples/fonts/gentilis_bold.typeface.json
droid sans | normal | normal | /examples/fonts/droid/droid_sans_regular.typeface.json
droid sans | bold | normal | /examples/fonts/droid/droid_sans_bold.typeface.json
droid serif | normal | normal | /examples/fonts/droid/droid_serif_regular.typeface.json
droid serif | bold | normal | /examples/fonts/droid/droid_serif_bold.typeface.json

## 属性

共有属性请参见其基类[page:ExtrudeGeometry]。

### [property:Object parameters]

一个包含着构造函数中每个参数的对象。在对象实例化之后，对该属性的任何修改都不会改变这个几何体。

## 方法(Methods)

共有方法请参见其基类[page:ExtrudeGeometry]。

## 源代码

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