You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
68 lines
1.5 KiB
JavaScript
68 lines
1.5 KiB
JavaScript
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;
|