JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 15
  • Score
    100M100P100Q73517F
  • License MIT

Easy GPU Rendering for Javascript, Python, Swift and Kotlin

Package Exports

  • fragmentcolor
  • fragmentcolor/fragmentcolor.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (fragmentcolor) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

FragmentColor for JavaScript (WASM)

FragmentColor is a cross‑platform GPU programming library implemented in Rust and wgpu, compiled to WebAssembly for JavaScript.

This README is specific to the npm package. For Rust usage, see the repository README.md. For Python, see README_PY.md.

Install

npm install fragmentcolor
# or
pnpm add fragmentcolor
# or
yarn add fragmentcolor

Quick start

import init, { Renderer, Shader, Pass, Frame } from "fragmentcolor";

async function start() {
  // Initializes the WASM module
  await init();

  // Initializes a renderer and a target compatible with the given canvas
  const canvas = document.getElementById("my-canvas");
  const renderer = new Renderer();
  const target = await renderer.createTarget(canvas);

  // You can pass the shader as a source string, file path, or URL:
  const circle = new Shader("./path/to/circle.wgsl");
  const triangle = new Shader("https://fragmentcolor.org/shaders/triangle.wgsl");
  const shader = new Shader(`
    struct VertexOutput {
        @builtin(position) coords: vec4<f32>,
    }

    struct MyStruct {
        my_field: vec3<f32>,
    }

    @group(0) @binding(0)
    var<uniform> my_struct: MyStruct;

    @group(0) @binding(1)
    var<uniform> my_vec2: vec2<f32>;

    @vertex
    fn vs_main(@builtin(vertex_index) in_vertex_index: u32) -> VertexOutput {
        const vertices = array(
            vec2( -1., -1.),
            vec2(  3., -1.),
            vec2( -1.,  3.)
        );
        return VertexOutput(vec4<f32>(vertices[in_vertex_index], 0.0, 1.0));
    }

    @fragment
    fn fs_main() -> @location(0) vec4<f32> {
        return vec4<f32>(my_struct.my_field, 1.0);
    }
  `);

  // The library binds and updates the uniforms automatically
  shader.set("my_struct.my_field", [0.1, 0.8, 0.9]);
  shader.set("my_vec2", [1.0, 1.0]);

  // One shader is all you need to render
  renderer.render(circle, target);

  // But you can also combine multiple shaders in a render Pass
  const rpass = new Pass("single pass");
  rpass.addShader(circle);
  rpass.addShader(triangle);
  rpass.addShader(shader);
  renderer.render(rpass, target);

  // Finally, you can combine multiple passes in a Frame
  const frame = new Frame();
  frame.addPass(rpass);
  frame.addPass(new Pass("GUI pass"));
  renderer.render(frame, target);

  // To animate, simply update the uniforms in a loop
  function animate() {
    circle.set("position", [0.0, 0.0]);
    renderer.render(frame, target);
    requestAnimationFrame(animate);
  }
  animate();
}

start();

Web (WASM) development

# Build WASM package (wasm-pack target web) and sync into local JS examples
./build_web        # add --debug for a debug build

# Run JS demos (Vite dev server) and open browser
./run_web repl     # or: ./run_web multipass | ./run_web headless

# Manual alternative
pnpm --dir examples/javascript install
pnpm --dir examples/javascript dev

Documentation & website

  • Docs source of truth lives in docs/api and is referenced from code via #[lsp_doc].
  • Examples on method pages are sliced from the healthcheck scripts; no filesystem reads in docs.
  • Doc examples follow async + pollster patterns on the Rust side and are converted to JavaScript automatically.

Platform support

Platform support is aligned with upstream wgpu:

API Windows Linux/Android macOS/iOS Web (wasm)
Vulkan βœ… βœ… πŸŒ‹
Metal βœ…
DX12 βœ…
OpenGL πŸ†— (GL 3.3+) πŸ†— (GL ES 3.0+) πŸ“ πŸ†— (WebGL2)
WebGPU βœ…

βœ… = First Class Support
πŸ†— = Downlevel/Best Effort Support
πŸ“ = Requires the ANGLE translation layer (GL ES 3.0 only)
πŸŒ‹ = Requires the MoltenVK translation layer

Limitations (planned features)

  • Swift & Kotlin bindings are not supported yet, but planned.

Note on generation: this README_JS.md is generated from this template (README_JS.tpl.md) and the repository README.md examples by the build script. Do not edit the generated README_JS.md directly.