Babylon.Font

Tentang

Hasilkan Mesh Teks untuk Babylonjs Menggunakan Wasm, Ditulis dalam AssemblyScript.

Contoh

Instalasi

Dengan CDN

https://cdn.jsdelivr.net/gh/ycw/babylon.font@{version}/build/babylon.font.js

atau NPM

 npm i ycw/babylon.font
npm i ycw/babylon.font#{VERSION_TAG}

Penggunaan

 import * as BABYLON from "babylonjs"
import * as opentype from "opentype.js"
import earcut from "earcut"
import { Compiler , Font , TextMeshBuilder } from "babylon.font" ;

( async function ( ) {
  const compiler = await Compiler . Build ( ) ;
  const font = await Font . Install ( "a.ttf" , compiler , opentype ) ;
  const builder = new TextMeshBuilder ( BABYLON , earcut ) ;
  const scene = . . ;
  const mesh = builder . create ( { font , text : "foo" } , scene ) ;
} ) ( ) ;

Dokumen

Compiler

 // (1) auto-probe .wasm url
await Compiler . Build ( ) ;

// (2) specify .wasm url
await Compiler . Build ( wasmUrl ) ;

Tanda tangan (2) berguna saat menggunakan server bundler / dev:

 // ex. obtain static asset url for ViteJS/Vite
import wasmUrl from "babylon.font/build/optimized.wasm?url" ;
const compiler = await Compiler . Build ( wasmUrl ) ;

---

Font

 await Font . Install ( fontUrl , compiler , opentype ) ;
// fontUrl:  font(.otf/.ttf) url
// compiler: a Compiler instance
// opentype: the 'opentype.js' lib

• .measure(text, fontSize) : ukur teks; mengembalikan Metrics .

Metrics

• .advanceWidth
• .ascender
• .descender

---

TextMeshBuilder

Bangun pembangun jala teks

 new TextMeshBuilder ( BABYLON , earcut ) ;
// BABYLON: the 'babylonjs' lib
// earcut: the 'earcut' lib

• .create(options, scene) : Buat mesh teks yang diekstrusi.
  • Mengembalikan Mesh jika mesh dibuat.
  • Returns null jika tidak ada mesh dibuat, mis. Teks adalah semua whitespace.
  • pengembalian undefined jika wasm gagal memproses (misalnya keluar dari mem)

 builder . create ( {
  font , // Font instance
  text , // text
  size , // font size; default is 100
  ppc , // points per curve, [0, 255], default is 2
  eps , // decimation threshold, default is 0.001

  // plus `BABYLON.MeshBuilder.CreatePolygon` options
  depth ,
  sideOrientation ,
  faceColors ,
  faceUV ,
  backUVs ,
  frontUVs ,
  updatable ,
} , scene ) ;

mantan. Fallback

 var mesh = builder . create ( opt1 , scene )
if ( mesh === undefined ) mesh = builder . create ( opt2 , scene ) 

Terima kasih

MAXGRAEY - Membantu dengan Optimalisasi Assemblyscript/WASM

OpenTypeJS - Baca dan tulis font openType menggunakan JavaScript.

Earcut - Perpustakaan Triangulasi JavaScript Polygon Tercepat dan Terkecil Untuk Aplikasi WebGL Anda

Babylonjs - mesin permainan yang kuat, indah, sederhana, dan terbuka serta rendering yang dikemas dalam kerangka kerja JavaScript yang ramah.

AssemblyScript - mengkompilasi subset yang ketat dari TypeScript (pada dasarnya JavaScript dengan tipe) ke WebAssembly menggunakan Binaryen.

Lisensi

Mit