Babylon.Font

À propos

Générer un maillage texte pour babylonjs en utilisant WASM, écrit en assemblyscript.

Exemple

Installation

Avec CDN

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

ou npm

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

Usage

 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 ) ;
} ) ( ) ;

Docs

Compiler

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

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

La signature (2) est utile lors de l'utilisation du serveur 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) : mesurez le texte; retourner une Metrics .

Metrics

• .advanceWidth
• .ascender
• .descender

---

TextMeshBuilder

Construire un constructeur de maille texte

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

• .create(options, scene) : Créez un maillage texte extrudé.
  • Renvoie Mesh si un maillage est créé.
  • Renvoie null si aucun maillage n'est créé, par exemple le texte est tous des espaces blancs.
  • retourne undefined si wasm n'a pas réussi à traiter (par exemple de 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 ) ;

ex. retomber

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

Merci

Maxgraey - Aide avec les optimisations de l'assemblycript / wasm

OpenTypeJS - Lire et écrire des polices OpenType à l'aide de JavaScript.

Earcut - La bibliothèque de triangulation polygonale JavaScript la plus rapide et la plus petite pour vos applications Webgl

Babylonjs - Un moteur de jeu et de rendu puissant, beau, simple et ouvert, emballé dans un cadre JavaScript amical.

AssemblyScript - Compile un sous-ensemble strict de TypeScript (fondamentalement JavaScript avec des types) à WebAssembly en utilisant Binaryen.

Licence

Mit