https://github.com/salvatorepreviti/spglsl

A webgl GLSL minifier based on Angle compiler
https://github.com/salvatorepreviti/spglsl

compiler glsl javascript minifier node nodejs webassembly webgl webgl2

Last synced: 6 days ago
JSON representation

A webgl GLSL minifier based on Angle compiler

• Host: GitHub
• URL: https://github.com/salvatorepreviti/spglsl
• Owner: SalvatorePreviti
• Created: 2020-08-23T21:54:12.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2024-10-09T09:06:23.000Z (28 days ago)
• Last Synced: 2024-10-24T17:16:40.692Z (13 days ago)
• Topics: compiler, glsl, javascript, minifier, node, nodejs, webassembly, webgl, webgl2
• Language: JavaScript
• Homepage:
• Size: 3.15 MB
• Stars: 27
• Watchers: 4
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# spglsl - a webgl glsl minifier based on Google Angle, written for JS13K

Executes preprocessor directives, removes whitespaces, applies constant folding, mangle non exported functions and variable names.

Used in "Island Not Found" https://github.com/SalvatorePreviti/js13k-2020 and "Dante" https://github.com/SalvatorePreviti/js13k-2022 (first place on JS13K 2022)

## Installation

Package is precompiled at https://www.npmjs.com/package/spglsl

It includes a rollup plugin.

For an esbuild plugin, see https://github.com/rottencandy/esbuild-plugin-spglsl

```sh

npm i spglsl --save

```

## Usage

```js

import { spglslAngleCompile } from "spglsl";

async function compileFile() {

  const result = await spglslAngleCompile({

    mainFilePath: "myfile.frag",

    mainSourceCode: fs.readFileSync("myfile.frag", "utf8"),

    minify: true,

    // Mangle everything, except uniforms and globals, "main" and function starting with "main"

    mangle: true,

    // Map of global variables to rename

    mangle_global_map: {

      my_uniform_to_rename: "x",

      my_fragment_input_to_rename: "y",

    },

  });

  if (!result.valid) {

    console.log(result.infoLog);

    throw new Error("compilation failed");

  }

  // Prints all the uniform used, key is the original uniform name and value is the renamed uniform, if it was defined in mangle_global_map

  console.log(result.uniforms);

  // Prints all the globals used, key is the original variable name and value is the renamed uniform, if it was defined in mangle_global_map

  // Globals are varying, vertex and fragment input, outputs and buffers ...

  // Globals do not include uniforms.

  console.log(result.globals);

  return result.output;

}

```

There is also an handy rollup and vite plugin:

```js

import { rollupPluginSpglsl } from "spglsl";

const pluginToPassToRollupOrVite = rollupPluginSpglsl({ ...options });

```

## License

MIT license

Salvatore Previti Copyright 2020-2022

Angle Copyright 2018 The ANGLE Project Authors.

## Development

The project is mostly C++, compiled to WASM with Emscripten and runnable in NodeJS.

Look at project/scripts folder on how to install dependencies and build.