使用vue学习three.js之高级几何体-TextGeometry文本几何体

1.TextGeometry文本几何体介绍

TextGeometry可以用来创建三维文本。其实是通过指定字体创建字符，然后像拉伸几何体那样把文字拉伸，继而得到三维文本。创建TextGeometry文本几何体有很多参数与ExtrudeGeometry几何体一样，具体如下：

属性	必须	描述
size	否	该属性指定文本大小，默认值是100
height	否	该属性指定文本可以厚度，默认值是50
font	否	该属性指定文本的字体，是一个THREE.Font对象
bevelEnabled	否	该属性指定文本拉伸时是否启用斜角，默认false
bevelThickness	否	该属性指定文本拉伸体斜角的厚度，默认值是10
bevelSize	否	该属性指定文本拉伸体斜角的高度。默认值是8
bevelSegments	否	该属性指定文本拉伸体斜角的分段数，段数越多斜角越光滑，默认值是3
curveSegments	否	该属性指定文本拉伸时拉伸曲线的分段数，段数越多曲线越光滑，默认值是4

2.TextGeometry文本几何体使用

2.1字体文件引入

示例中使用的是helvetiker字体，通过文件 helvetiker_regular.typeface.js导入字体，文件helvetiker_regular.typeface.js 与工作文件在相同目录下，字体文件可以在这里下载helvetiker_regular.typeface.js引入过程如下:

const textLoader = new THREE.FontLoader()
const url = './helvetiker_regular.typeface.js'
//导入字体
textLoader.load(url, font => {
    
    
	// 这里可以获取到font就是创建文本几何体需要的字体
})

2.2创建文本几何体

const options = {
    
    
  size: this.properties.size.value,
  height: this.properties.height.value,
  font: font,
  bevelThickness: this.properties.bevelThickness.value,
  bevelSize: this.properties.bevelSize.value,
  bevelSegments: this.properties.bevelSegments.value,
  bevelEnabled: this.properties.bevelEnabled,
  curveSegments: this.properties.curveSegments.value
}
// 创建文本几何体
const textGeo = new THREE.TextGeometry('Learning', options)

2.3创建网格对象并添加到场景

// 创建材质
const meshMaterial = new THREE.MeshStandardMaterial({
    
    
  color: 0xeeffff
})
// 创建文字网格对象
this.mesh = new THREE.Mesh(textGeo, meshMaterial)
this.mesh.position.set(40, -30, -60)
this.mesh.rotation.y = -1.1
// 网格对象添加到场景中
this.scene.add(this.mesh)

3.demo说明

如上图，该示例支持以下功能

1. 通过size属性调整文本大小
2. 通过height 属性调整文本厚度
3. 通过bevelEnabled属性指定文本是否启用斜角
4. 通过bevelThickness属性指定文本斜角的厚度
5. 通过bevelSize属性指定文本斜角的高度
6. 通过bevelSegments属性指定文本斜角的分段数
7. 通过curveSegments属性指定文本拉伸时拉伸曲线的分段数

4.demo代码

<template>
  <div>
    <div id="container"></div>
    <div class="controls-box">
      <section>
        <el-row>
          <div v-for="(item,key) in properties" :key="key">
            <div v-if="item&&item.name!=undefined">
              <el-col :span="8">
                <span class="vertice-span">{
    
    {
    
    item.name}}</span>
              </el-col>
              <el-col :span="13">
                <el-slider v-model="item.value" :min="item.min" :max="item.max" :step="item.step" :format-tooltip="formatTooltip" @change="redraw(item.name)"></el-slider>
              </el-col>
              <el-col :span="3">
                <span class="vertice-span">{
    
    {
    
    item.value}}</span>
              </el-col>
            </div>
          </div>
        </el-row>
        <el-row>
          <el-checkbox v-model="properties.bevelEnabled" @change="redraw">bevelEnabled</el-checkbox>
        </el-row>
      </section>
    </div>
  </div>
</template>

<script>
import * as THREE from 'three'
import {
    
     OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js'
import {
    
     SceneUtils } from 'three/examples/jsm/utils/SceneUtils.js'
export default {
    
    
  data() {
    
    
    return {
    
    
      properties: {
    
    
        size: {
    
    
          name: 'size',
          value: 20,
          min: 0,
          max: 100,
          step: 1
        },
        height: {
    
    
          name: 'height',
          value: 20,
          min: 0,
          max: 100,
          step: 1
        },
        bevelThickness: {
    
    
          name: 'bevelThickness',
          value: 2,
          min: 0,
          max: 10,
          step: 0.1
        },
        bevelSize: {
    
    
          name: 'bevelSize',
          value: 0.5,
          min: 0,
          max: 10,
          step: 0.1
        },
        bevelSegments: {
    
    
          name: 'bevelSegments',
          value: 3,
          min: 0,
          max: 30,
          step: 1
        },
        curveSegments: {
    
    
          name: 'curveSegments',
          value: 12,
          min: 1,
          max: 30,
          step: 1
        },
        bevelEnabled: false
      },
      mesh: null,
      camera: null,
      scene: null,
      renderer: null,
      controls: null
    }
  },
  mounted() {
    
    
    this.init()
  },
  methods: {
    
    
    formatTooltip(val) {
    
    
      return val
    },
    // 初始化
    init() {
    
    
      this.createScene() // 创建场景
      this.createMesh() // 创建网格模型
      this.createLight() // 创建光源
      this.createCamera() // 创建相机
      this.createRender() // 创建渲染器
      this.createControls() // 创建控件对象
      this.render() // 渲染
    },
    // 创建场景
    createScene() {
    
    
      this.scene = new THREE.Scene()
    },
    // 创建网格模型
    createMesh() {
    
    
      const textLoader = new THREE.FontLoader()
      const url = './helvetiker_regular.typeface.js'
      //导入字体
      textLoader.load(url, font => {
    
    
        const options = {
    
    
          size: this.properties.size.value,
          height: this.properties.height.value,
          font: font,
          bevelThickness: this.properties.bevelThickness.value,
          bevelSize: this.properties.bevelSize.value,
          bevelSegments: this.properties.bevelSegments.value,
          bevelEnabled: this.properties.bevelEnabled,
          curveSegments: this.properties.curveSegments.value
        }
        // 创建文本几何体
        const textGeo = new THREE.TextGeometry('Learning', options)
        // 创建材质
        const meshMaterial = new THREE.MeshStandardMaterial({
    
    
          color: 0xeeffff
        })
        // 创建文字网格对象
        this.mesh = new THREE.Mesh(textGeo, meshMaterial)
        this.mesh.position.set(40, -30, -60)
        this.mesh.rotation.y = -1.1
        // 网格对象添加到场景中
        this.scene.add(this.mesh)
      })
    },

    // 创建光源
    createLight() {
    
    
      // 环境光
      const ambientLight = new THREE.AmbientLight(0xffffff, 0.1) // 创建环境光
      this.scene.add(ambientLight) // 将环境光添加到场景

      const spotLight = new THREE.SpotLight(0xffffff) // 创建聚光灯
      spotLight.position.set(-40, 60, -10)
      spotLight.castShadow = true
      this.scene.add(spotLight)
    },
    // 创建相机
    createCamera() {
    
    
      const element = document.getElementById('container')
      const width = element.clientWidth // 窗口宽度
      const height = element.clientHeight // 窗口高度
      const k = width / height // 窗口宽高比
      // PerspectiveCamera( fov, aspect, near, far )
      this.camera = new THREE.PerspectiveCamera(35, k, 0.1, 1000)
      this.camera.position.set(-80, 60, 40) // 设置相机位置

      this.camera.lookAt(new THREE.Vector3(10, 0, 0)) // 设置相机方向
      this.scene.add(this.camera)
    },
    // 创建渲染器
    createRender() {
    
    
      const element = document.getElementById('container')
      this.renderer = new THREE.WebGLRenderer({
    
     antialias: true, alpha: true })
      this.renderer.setSize(element.clientWidth, element.clientHeight) // 设置渲染区域尺寸
      this.renderer.shadowMap.enabled = true // 显示阴影
      this.renderer.shadowMap.type = THREE.PCFSoftShadowMap
      this.renderer.setClearColor(0x3f3f3f, 1) // 设置背景颜色
      element.appendChild(this.renderer.domElement)
    },

    // 重新绘制
    redraw() {
    
    
      this.scene.remove(this.mesh)
      this.createMesh()
    },
    render() {
    
    
      this.renderer.render(this.scene, this.camera)
      requestAnimationFrame(this.render)
    },
    // 创建控件对象
    createControls() {
    
    
      this.controls = new OrbitControls(this.camera, this.renderer.domElement)
    }
  }
}
</script>
<style>
#container {
    
    
  position: absolute;
  width: 100%;
  height: 100%;
}
.controls-box {
    
    
  position: absolute;
  right: 5px;
  top: 5px;
  width: 300px;
  padding: 10px;
  background-color: #fff;
  border: 1px solid #c3c3c3;
}
.vertice-span {
    
    
  line-height: 38px;
  padding: 0 2px 0 10px;
}
</style>