Accueil / npm / three@0.186.1 / examples / jsm / transpiler / Transpiler.js
Transpiler.js
import Linker from './Linker.js';
/**
* A class that transpiles shader code from one language into another.
*
* `Transpiler` can only be used to convert GLSL into TSL right now. It is intended
* to support developers when they want to migrate their custom materials from the
* current to the new node-based material system.
*
* @three_import import Transpiler from 'three/addons/transpiler/Transpiler.js';
*/
class Transpiler {
/**
* Constructs a new transpiler.
*
* @param {GLSLDecoder} decoder - The GLSL decoder.
* @param {TSLEncoder} encoder - The TSL encoder.
*/
constructor( decoder, encoder ) {
/**
* The GLSL decoder. This component parse GLSL and produces
* a language-independent AST for further processing.
*
* @type {GLSLDecoder}
*/
this.decoder = decoder;
/**
* The TSL encoder. It takes the AST and emits TSL code.
*
* @type {TSLEncoder}
*/
this.encoder = encoder;
/**
* The linker. It processes the AST and resolves
* variable and function references, ensuring that all
* dependencies are properly linked.
*
* @type {Linker}
*/
this.linker = new Linker();
}
/**
* Parses the given GLSL source and returns TSL syntax.
*
* @param {string} source - The GLSL source.
* @return {string} The TSL code.
*/
parse( source ) {
const ast = this.decoder.parse( source );
// Process the AST to resolve variable and function references and optimizations.
this.linker.process( ast );
return this.encoder.emit( ast );
}
}
export default Transpiler;