@hyperviz/worker

A library for efficient web worker management and parallel processing.

Key Features

• Worker pool and task queue management
• Event stream support
• Image processing and caching
• OffscreenCanvas support
• Advanced WebGL rendering

WebGL Rendering Capabilities

The latest version provides enhanced WebGL rendering capabilities:

Shader Management System

• Automated shader program compilation and linking
• Simplified uniform and attribute management
• WebGL 2.0 shader support
• GLSL error detection and reporting

VAO and Geometry System

• Vertex Array Object (VAO) support
• Efficient buffer management
• Automatic VAO extension application in WebGL 1.0
• Support for complex geometry data structures

Texture Management

• Texture loading and caching
• Support for various formats (RGBA, RGB, Luminance, etc.)
• Automatic mipmap generation
• Texture atlas support for efficient rendering

Instance Rendering

• Efficient rendering of large quantities of objects
• WebGL 2.0 instancing support
• Automatic extension application in WebGL 1.0
• Dynamic instance data updates

Performance Optimization

• Automatic worker thread balancing
• Transferable objects usage for zero-copy transfers
• Task prioritization system
• Memory management utilities

Usage Examples

Basic Worker Pool

import { WorkerPool } from "@hyperviz/worker";

// Create a worker pool
const pool = new WorkerPool({
  minWorkers: 2,
  maxWorkers: 4,
  workerFile: "worker.js",
});

// Submit a task
const result = await pool.submitTask({
  type: "calculation",
  data: [1, 2, 3, 4, 5],
});

console.log("Result:", result);

// Clean up when done
await pool.shutdown();

OffscreenCanvas Rendering

import { OffscreenCanvasManager } from "@hyperviz/worker";

const canvas = document.getElementById("canvas");
const manager = new OffscreenCanvasManager({
  canvas,
  contextType: "webgl2",
  autoResize: true,
});

// Handle ready event
manager.on("ready", () => {
  // Send WebGL rendering commands
  manager.sendCommand({
    type: "render",
    params: {
      // Rendering parameters
    },
  });
});

// Handle resize events
window.addEventListener("resize", () => {
  manager.resize();
});

Installation

npm install @hyperviz/worker

or

yarn add @hyperviz/worker

Browser Compatibility

• Chrome 69+
• Firefox 79+
• Safari 16.4+
• Edge 79+

Works in all modern browsers that support Web Workers and OffscreenCanvas.

Documentation

For comprehensive API documentation, see the API reference.

Examples

The package includes several examples demonstrating various features:

• Calculation Worker Demo - Basic worker operations
• OffscreenCanvas Demo - High-performance canvas rendering
• Image Processing - Image filters and transformations
• WebGL Rendering - 3D rendering with WebGL
• Event Streams - Real-time data streaming
• Particle Effects - Complex particle simulations

For more detailed examples explanation, see the examples documentation.

License

MIT