TextGeometry - Verge3D 用户手册 - Soft8Soft
Description: 了解如何在使用 Verge3D 制作的交互式 3D 应用程序中使用 TextGeometry

Geometry → ExtrudeGeometry →

# 文本几何体（TextGeometry）

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

## 代码示例

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

## 构造函数

### TextGeometry(text : String, parameters : Object)

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

- font — v3d.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

## 属性

共有属性请参见其基类ExtrudeGeometry。

### # .parameters : Object

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

## 方法(Methods)

共有方法请参见其基类ExtrudeGeometry。

## 源代码

src/geometries/TextGeometry.js