TextGeometry创建中文文本
1.引言
上一篇文章中使用TextGeometry创建三维文本使用的是helvetiker字体,只能创建英文字符的文本,不能创建中文字符的文本。实际使用中很可能会使用中文,经过一番折腾后,终于出现在屏幕上了,接下来就介绍一下实现过程。
2.创建中文实现步骤
2.1字体文件引入
示例中使用的是支持中文的YaHei字体,首先需要获取 YaHei_Regular.js 文件,这里给大家一个下载链接和上一篇是同一个链接,里面放了两个字体文件,一个是helvetiker_regular.typeface.js,一个是YaHei_Regular.js,如果需要请点击这里下载YaHei_Regular.js,
然后将该文件引入,引入过程如下:
const textLoader = new THREE.FontLoader()
const url = './YaHei_Regular.js'
//导入字体
textLoader.load(url, font => {
// 这里可以获取到font就是创建文本几何体需要的字体
})
注意:
1.字体文件与工作文件在同一目录下
2.同时需要在public目录下也存放该字体文件才可以正确导入,具体原因不详
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('中文文本测试', 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说明
如上图,该示例支持以下功能
- 通过size属性调整文本大小
- 通过height 属性调整文本厚度
- 通过bevelEnabled属性指定文本是否启用斜角
- 通过bevelThickness属性指定文本斜角的厚度
- 通过bevelSize属性指定文本斜角的高度
- 通过bevelSegments属性指定文本斜角的分段数
- 通过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'
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 = './YaHei_Regular.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('中文文本测试', 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>