webcodecs-node 0.5.2 → 0.7.0

package/README.md

@@ -9,6 +9,7 @@ This package provides a Node.js-compatible implementation of the [WebCodecs API]
 - **VideoEncoder / VideoDecoder** - H.264, HEVC, VP8, VP9, AV1
 - **AudioEncoder / AudioDecoder** - AAC, Opus, MP3, FLAC, Vorbis
 - **ImageDecoder** - PNG, JPEG, WebP, GIF, AVIF, BMP, TIFF (including animated with frame timing)
+- **ImageEncoder** - Encode VideoFrames to PNG, JPEG, WebP
 - **VideoFrame / AudioData** - Frame-level data manipulation
 - **MediaCapabilities** - Query codec support, smooth playback, and power efficiency
 - **Hardware Acceleration** - VAAPI, NVENC, QSV support
@@ -16,6 +17,7 @@ This package provides a Node.js-compatible implementation of the [WebCodecs API]
 - **Latency Modes** - Configure for real-time streaming vs maximum compression
 - **Bitrate Modes** - Constant, variable, and quantizer (CRF) encoding modes
 - **Alpha Channel** - Preserve transparency with VP9 and AV1 codecs
+- **10-bit & HDR** - I420P10, P010 formats with HDR10 metadata support
 - **Container Support** - MP4, WebM demuxing/muxing utilities
 
 ## Documentation
@@ -246,6 +248,36 @@ decoder.close();
 - `image/bmp`
 - `image/tiff`
 
+### ImageEncoder
+
+Encodes VideoFrames to image formats (PNG, JPEG, WebP). This is a utility class that mirrors ImageDecoder.
+
+```typescript
+import { ImageEncoder, VideoFrame } from 'webcodecs-node';
+
+// Check format support
+ImageEncoder.isTypeSupported('image/webp'); // true
+
+// Encode a frame to JPEG
+const result = await ImageEncoder.encode(frame, {
+  type: 'image/jpeg',
+  quality: 0.85,
+});
+
+fs.writeFileSync('output.jpg', Buffer.from(result.data));
+
+// Synchronous encoding
+const pngResult = ImageEncoder.encodeSync(frame, { type: 'image/png' });
+
+// Batch encode multiple frames
+const results = await ImageEncoder.encodeBatch(frames, { type: 'image/webp' });
+```
+
+**Supported output formats:**
+- `image/png` - Lossless, supports transparency
+- `image/jpeg` - Lossy, quality 0-1 (default: 0.92)
+- `image/webp` - Lossy/lossless, quality 0-1 (default: 0.8)
+
 ### MediaCapabilities API
 
 Query codec capabilities before encoding/decoding. Implements the standard [MediaCapabilities API](https://developer.mozilla.org/en-US/docs/Web/API/MediaCapabilities).
@@ -419,6 +451,207 @@ const frame = new VideoFrame(rgbaWithAlpha, {
 encoder.encode(frame);
 ```
 
+### 10-bit Pixel Formats & HDR
+
+Support for high bit-depth content and HDR metadata:
+
+```typescript
+import {
+  VideoFrame,
+  VideoColorSpace,
+  createHdr10MasteringMetadata,
+  createContentLightLevel,
+  is10BitFormat,
+  getBitDepth,
+} from 'webcodecs-node';
+
+// Create a 10-bit frame
+const frame = new VideoFrame(yuv10bitData, {
+  format: 'I420P10',  // 10-bit YUV 4:2:0
+  codedWidth: 3840,
+  codedHeight: 2160,
+  timestamp: 0,
+  colorSpace: new VideoColorSpace({
+    primaries: 'bt2020',
+    transfer: 'pq',        // HDR10 PQ transfer
+    matrix: 'bt2020-ncl',
+  }),
+});
+
+// Check format properties
+console.log(is10BitFormat('I420P10'));  // true
+console.log(getBitDepth('I420P10'));    // 10
+
+// HDR metadata for mastering display
+const hdrMetadata = {
+  smpteSt2086: createHdr10MasteringMetadata(1000, 0.0001), // max/min luminance
+  contentLightLevel: createContentLightLevel(800, 400),    // MaxCLL, MaxFALL
+};
+
+const colorSpace = new VideoColorSpace({
+  primaries: 'bt2020',
+  transfer: 'pq',
+  hdrMetadata,
+});
+
+console.log(colorSpace.isHdr);          // true
+console.log(colorSpace.hasHdrMetadata); // true
+```
+
+**10-bit pixel formats:**
+- `I420P10` - YUV 4:2:0 planar, 10-bit
+- `I422P10` - YUV 4:2:2 planar, 10-bit
+- `I444P10` - YUV 4:4:4 planar, 10-bit
+- `P010` - YUV 4:2:0 semi-planar, 10-bit
+
+**Pixel format utilities:**
+- `is10BitFormat(format)` - Check if format is 10-bit
+- `getBitDepth(format)` - Get bit depth (8 or 10)
+- `get8BitEquivalent(format)` - Get 8-bit version of a 10-bit format
+- `get10BitEquivalent(format)` - Get 10-bit version of an 8-bit format
+
+### Canvas Rendering (skia-canvas)
+
+GPU-accelerated 2D canvas rendering with automatic hardware detection:
+
+```typescript
+import {
+  createCanvas,
+  createFrameLoop,
+  detectGpuAcceleration,
+  isGpuAvailable,
+  getGpuApi,
+  ensureEvenDimensions,
+  VideoEncoder,
+} from 'webcodecs-node';
+
+// Check GPU availability
+const gpuInfo = detectGpuAcceleration();
+console.log(`Renderer: ${gpuInfo.renderer}`); // 'GPU' or 'CPU'
+console.log(`API: ${getGpuApi()}`);           // 'Metal', 'Vulkan', 'D3D', or null
+
+// Create GPU-accelerated canvas
+const canvas = createCanvas({
+  width: 1920,
+  height: 1080,
+  gpu: true, // or omit for auto-detection
+});
+
+const ctx = canvas.getContext('2d');
+ctx.fillStyle = 'red';
+ctx.fillRect(0, 0, 1920, 1080);
+
+// Create VideoFrame directly from canvas
+const frame = new VideoFrame(canvas, { timestamp: 0 });
+```
+
+**FrameLoop helper** for animation with backpressure:
+
+```typescript
+const loop = createFrameLoop({
+  width: 1920,
+  height: 1080,
+  frameRate: 30,
+  maxQueueSize: 8, // Backpressure limit
+  onFrame: (ctx, timing) => {
+    // Draw each frame
+    ctx.fillStyle = `hsl(${timing.frameIndex % 360}, 100%, 50%)`;
+    ctx.fillRect(0, 0, 1920, 1080);
+  },
+});
+
+loop.start(300); // Generate 300 frames
+
+while (loop.getState() !== 'stopped' || loop.getQueueSize() > 0) {
+  const frame = loop.takeFrame();
+  if (frame) {
+    encoder.encode(frame);
+    frame.close(); // Always close frames!
+  }
+}
+```
+
+**OffscreenCanvas polyfill** for browser-compatible code:
+
+```typescript
+import { installOffscreenCanvasPolyfill } from 'webcodecs-node';
+
+installOffscreenCanvasPolyfill();
+
+// Now use standard OffscreenCanvas API
+const canvas = new OffscreenCanvas(1920, 1080);
+const ctx = canvas.getContext('2d');
+const blob = await canvas.convertToBlob({ type: 'image/png' });
+```
+
+## Performance Tuning
+
+### Memory Management
+
+Always close VideoFrames and AudioData when done:
+
+```typescript
+const frame = new VideoFrame(buffer, { ... });
+try {
+  encoder.encode(frame);
+} finally {
+  frame.close(); // Prevent memory leaks
+}
+```
+
+### Even Dimensions
+
+Video codecs require even dimensions for YUV420 chroma subsampling:
+
+```typescript
+import { ensureEvenDimensions, validateEvenDimensions } from 'webcodecs-node';
+
+// Auto-fix odd dimensions (rounds up)
+const { width, height } = ensureEvenDimensions(1279, 719);
+// Returns { width: 1280, height: 720 }
+
+// Strict validation (throws if odd)
+validateEvenDimensions(1280, 720); // OK
+validateEvenDimensions(1279, 720); // Throws TypeError
+```
+
+### Backpressure Handling
+
+Monitor encoder queue to prevent memory exhaustion:
+
+```typescript
+encoder.addEventListener('dequeue', () => {
+  // Queue size decreased, safe to encode more
+  if (encoder.encodeQueueSize < 10) {
+    encodeNextFrame();
+  }
+});
+```
+
+### Raw Buffer Export
+
+For maximum performance, use raw RGBA buffers instead of PNG/JPEG:
+
+```typescript
+import { getRawPixels } from 'webcodecs-node';
+
+// Fast: raw RGBA buffer (no compression)
+const pixels = getRawPixels(canvas); // Returns Buffer
+
+// Slow: PNG encoding (avoid in hot paths)
+const png = await canvas.toBuffer('png');
+```
+
+### GPU vs CPU Tradeoffs
+
+| Scenario | Recommendation |
+|----------|----------------|
+| HD/4K encoding | `hardwareAcceleration: 'prefer-hardware'` |
+| Real-time streaming | Hardware + `latencyMode: 'realtime'` |
+| Maximum quality | Software + `bitrateMode: 'quantizer'` |
+| Batch processing | Hardware for throughput |
+| Low-end systems | Software (more compatible) |
+
 ## Demos
 
 Run the included demos to test functionality:
@@ -452,6 +685,52 @@ npm run demo:fourcorners
 
 # 1080p transcoding demo
 npm run demo:1080p
+
+# DVD bouncing logo animation
+npm run demo:dvd
+
+# Audio visualizer with waveform and spectrum
+npm run demo:visualizer
+```
+
+## Benchmarking
+
+Compare software vs hardware encoding performance:
+
+```bash
+# Quick benchmark (30 frames, 360p)
+npm run bench:quick
+
+# Default benchmark (120 frames, 720p)
+npm run bench
+
+# Full benchmark (300 frames, 1080p)
+npm run bench:full
+
+# Custom options
+node scripts/encoding-benchmark.mjs --frames 100 --resolution 1080p --codecs h264,hevc
+```
+
+**Options:**
+- `--frames <n>` - Number of frames to encode (default: 120)
+- `--resolution <res>` - 360p, 480p, 720p, 1080p, 4k (default: 720p)
+- `--bitrate <bps>` - Target bitrate in bps
+- `--framerate <fps>` - Target framerate (default: 30)
+- `--codecs <list>` - Comma-separated: h264,hevc,vp9,av1
+- `--skip-software` - Only test hardware encoding
+- `--verbose` - Show detailed output
+
+**Example output:**
+```
+════════════════════════════════════════════════════════════════════════════════
+ENCODING BENCHMARK RESULTS (720p)
+════════════════════════════════════════════════════════════════════════════════
+Codec       Mode           FPS      Time   Latency        Size       Bitrate
+────────────────────────────────────────────────────────────────────────────────
+H.264/AVC   SW           213.6     562ms     391ms     2.00 MB     4.20 Mbps
+H.264/AVC   HW           370.4     324ms     187ms     2.11 MB     4.43 Mbps
+H.265/HEVC  SW           141.4     848ms     106ms     1.94 MB     4.06 Mbps
+H.265/HEVC  HW           589.0     204ms      61ms     2.16 MB     4.54 Mbps
 ```
 
 ## API Compatibility

package/dist/backends/types.d.ts

@@ -40,6 +40,8 @@ export interface VideoEncoderBackendConfig {
     latencyMode?: 'quality' | 'realtime';
     alpha?: 'discard' | 'keep';
     hardwareAcceleration?: 'no-preference' | 'prefer-hardware' | 'prefer-software';
+    /** Output format: 'annexb' for raw Annex B, 'mp4' for length-prefixed (AVCC/HVCC) */
+    format?: 'annexb' | 'mp4';
 }
 /**
  * Video decoder configuration

package/dist/backends/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/backends/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/backends/types.ts"],"names":[],"mappings":"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"}

package/dist/backends/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/backends/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgLH,iDAAiD;AACjD,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C,gDAAgD;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAE3C,wDAAwD;AACxD,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C,2CAA2C;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAE1C,4CAA4C;AAC5C,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,GAAG,EAAE,EAAE;IACP,GAAG,EAAE,EAAE;IACP,GAAG,EAAE,EAAE;CACC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/backends/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkLH,iDAAiD;AACjD,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C,gDAAgD;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAE3C,wDAAwD;AACxD,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C,2CAA2C;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAE1C,4CAA4C;AAC5C,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,GAAG,EAAE,EAAE;IACP,GAAG,EAAE,EAAE;IACP,GAAG,EAAE,EAAE;CACC,CAAC"}

package/dist/canvas/canvas-utils.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Canvas Utilities for skia-canvas
+ *
+ * Raw buffer utilities for efficient pixel data handling.
+ * Always uses toBuffer('raw') - never PNG or other encoded formats.
+ */
+import { Canvas } from 'skia-canvas';
+import type { RawBufferOptions } from './types.js';
+/**
+ * Create a pixel buffer for image manipulation
+ *
+ * Uses Uint8ClampedArray which automatically clamps values to 0-255,
+ * preventing overflow bugs in filters and pixel manipulation code.
+ *
+ * @param width - Image width in pixels
+ * @param height - Image height in pixels
+ * @returns Uint8ClampedArray of size width * height * 4 (RGBA)
+ *
+ * @example
+ * ```typescript
+ * const pixels = createPixelBuffer(1920, 1080);
+ * // Safe manipulation - values auto-clamped to 0-255
+ * pixels[0] = 300; // Becomes 255
+ * pixels[1] = -50; // Becomes 0
+ * ```
+ */
+export declare function createPixelBuffer(width: number, height: number): Uint8ClampedArray;
+/**
+ * Create a pixel buffer initialized with a solid color
+ *
+ * @param width - Image width in pixels
+ * @param height - Image height in pixels
+ * @param r - Red component (0-255)
+ * @param g - Green component (0-255)
+ * @param b - Blue component (0-255)
+ * @param a - Alpha component (0-255, default 255)
+ * @returns Uint8ClampedArray filled with the specified color
+ */
+export declare function createPixelBufferWithColor(width: number, height: number, r: number, g: number, b: number, a?: number): Uint8ClampedArray;
+/**
+ * Get raw RGBA pixel data from canvas (synchronous)
+ * ALWAYS uses toBufferSync('raw') - never PNG or other encoded formats.
+ *
+ * @param canvas - The skia-canvas Canvas instance
+ * @param options - Optional buffer format options
+ * @returns Buffer containing raw RGBA pixel data
+ */
+export declare function getRawPixels(canvas: Canvas, options?: RawBufferOptions): Buffer;
+/**
+ * Get raw RGBA pixel data from canvas (asynchronous)
+ * ALWAYS uses toBuffer('raw') - never PNG or other encoded formats.
+ *
+ * @param canvas - The skia-canvas Canvas instance
+ * @param options - Optional buffer format options
+ * @returns Promise resolving to Buffer containing raw RGBA pixel data
+ */
+export declare function getRawPixelsAsync(canvas: Canvas, options?: RawBufferOptions): Promise<Buffer>;
+/**
+ * Reset canvas state for new frame
+ *
+ * Prevents Skia command history buildup which can cause memory
+ * growth and performance degradation over time.
+ *
+ * @param ctx - The 2D rendering context
+ */
+export declare function resetCanvas(ctx: CanvasRenderingContext2D): void;
+/**
+ * Simple ImageData-like object for internal use
+ */
+export interface SimpleImageData {
+    data: Uint8ClampedArray;
+    width: number;
+    height: number;
+    colorSpace?: string;
+    colorType?: string;
+}
+/**
+ * Convert Uint8Array/Buffer to ImageData-like object
+ * Compatible with skia-canvas putImageData
+ *
+ * @param data - Raw pixel data (RGBA format)
+ * @param width - Image width in pixels
+ * @param height - Image height in pixels
+ * @returns ImageData-like object
+ */
+export declare function pixelsToImageData(data: Uint8Array | Buffer, width: number, height: number): SimpleImageData;
+/**
+ * Draw raw RGBA pixels to canvas
+ *
+ * @param canvas - The skia-canvas Canvas instance
+ * @param data - Raw pixel data (RGBA format)
+ * @param width - Image width in pixels
+ * @param height - Image height in pixels
+ */
+export declare function drawPixelsToCanvas(canvas: Canvas, data: Uint8Array | Buffer, width: number, height: number): void;
+/**
+ * Create a Uint8Array view of a Buffer without copying
+ *
+ * @param buffer - Node.js Buffer
+ * @returns Uint8Array view of the same memory
+ */
+export declare function bufferToUint8Array(buffer: Buffer): Uint8Array;
+/**
+ * Resize raw pixel data using canvas
+ *
+ * @param data - Source pixel data (RGBA format)
+ * @param srcWidth - Source width
+ * @param srcHeight - Source height
+ * @param dstWidth - Destination width
+ * @param dstHeight - Destination height
+ * @param canvas - Optional canvas to reuse (for performance)
+ * @returns Resized pixel data as Buffer
+ */
+export declare function resizePixels(data: Uint8Array | Buffer, srcWidth: number, srcHeight: number, dstWidth: number, dstHeight: number, canvas?: Canvas): Buffer;
+//# sourceMappingURL=canvas-utils.d.ts.map

package/dist/canvas/canvas-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-utils.d.ts","sourceRoot":"","sources":["../../src/canvas/canvas-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAElF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,GAAE,MAAY,GACd,iBAAiB,CASnB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAI/E;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,wBAAwB,GAAG,IAAI,CAW/D;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,UAAU,GAAG,MAAM,EACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,eAAe,CAajB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,GAAG,MAAM,EACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,IAAI,CAIN;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAE7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,UAAU,GAAG,MAAM,EACzB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAqBR"}

package/dist/canvas/canvas-utils.js

@@ -0,0 +1,169 @@
+/**
+ * Canvas Utilities for skia-canvas
+ *
+ * Raw buffer utilities for efficient pixel data handling.
+ * Always uses toBuffer('raw') - never PNG or other encoded formats.
+ */
+import { Canvas } from 'skia-canvas';
+/**
+ * Create a pixel buffer for image manipulation
+ *
+ * Uses Uint8ClampedArray which automatically clamps values to 0-255,
+ * preventing overflow bugs in filters and pixel manipulation code.
+ *
+ * @param width - Image width in pixels
+ * @param height - Image height in pixels
+ * @returns Uint8ClampedArray of size width * height * 4 (RGBA)
+ *
+ * @example
+ * ```typescript
+ * const pixels = createPixelBuffer(1920, 1080);
+ * // Safe manipulation - values auto-clamped to 0-255
+ * pixels[0] = 300; // Becomes 255
+ * pixels[1] = -50; // Becomes 0
+ * ```
+ */
+export function createPixelBuffer(width, height) {
+    return new Uint8ClampedArray(width * height * 4);
+}
+/**
+ * Create a pixel buffer initialized with a solid color
+ *
+ * @param width - Image width in pixels
+ * @param height - Image height in pixels
+ * @param r - Red component (0-255)
+ * @param g - Green component (0-255)
+ * @param b - Blue component (0-255)
+ * @param a - Alpha component (0-255, default 255)
+ * @returns Uint8ClampedArray filled with the specified color
+ */
+export function createPixelBufferWithColor(width, height, r, g, b, a = 255) {
+    const pixels = new Uint8ClampedArray(width * height * 4);
+    for (let i = 0; i < pixels.length; i += 4) {
+        pixels[i] = r;
+        pixels[i + 1] = g;
+        pixels[i + 2] = b;
+        pixels[i + 3] = a;
+    }
+    return pixels;
+}
+/**
+ * Get raw RGBA pixel data from canvas (synchronous)
+ * ALWAYS uses toBufferSync('raw') - never PNG or other encoded formats.
+ *
+ * @param canvas - The skia-canvas Canvas instance
+ * @param options - Optional buffer format options
+ * @returns Buffer containing raw RGBA pixel data
+ */
+export function getRawPixels(canvas, options) {
+    return canvas.toBufferSync('raw', {
+        colorType: options?.colorType ?? 'rgba',
+    });
+}
+/**
+ * Get raw RGBA pixel data from canvas (asynchronous)
+ * ALWAYS uses toBuffer('raw') - never PNG or other encoded formats.
+ *
+ * @param canvas - The skia-canvas Canvas instance
+ * @param options - Optional buffer format options
+ * @returns Promise resolving to Buffer containing raw RGBA pixel data
+ */
+export async function getRawPixelsAsync(canvas, options) {
+    return canvas.toBuffer('raw', {
+        colorType: options?.colorType ?? 'rgba',
+    });
+}
+/**
+ * Reset canvas state for new frame
+ *
+ * Prevents Skia command history buildup which can cause memory
+ * growth and performance degradation over time.
+ *
+ * @param ctx - The 2D rendering context
+ */
+export function resetCanvas(ctx) {
+    // Use reset() if available (Canvas API), otherwise clearRect
+    if (typeof ctx.reset === 'function') {
+        ctx.reset();
+    }
+    else {
+        const canvas = ctx.canvas;
+        ctx.save();
+        ctx.setTransform(1, 0, 0, 1, 0, 0);
+        ctx.clearRect(0, 0, canvas.width, canvas.height);
+        ctx.restore();
+    }
+}
+/**
+ * Convert Uint8Array/Buffer to ImageData-like object
+ * Compatible with skia-canvas putImageData
+ *
+ * @param data - Raw pixel data (RGBA format)
+ * @param width - Image width in pixels
+ * @param height - Image height in pixels
+ * @returns ImageData-like object
+ */
+export function pixelsToImageData(data, width, height) {
+    const clampedArray = new Uint8ClampedArray(data.buffer, data.byteOffset, data.byteLength);
+    return {
+        data: clampedArray,
+        width,
+        height,
+        colorSpace: 'srgb',
+        colorType: 'rgba', // Required by skia-canvas
+    };
+}
+/**
+ * Draw raw RGBA pixels to canvas
+ *
+ * @param canvas - The skia-canvas Canvas instance
+ * @param data - Raw pixel data (RGBA format)
+ * @param width - Image width in pixels
+ * @param height - Image height in pixels
+ */
+export function drawPixelsToCanvas(canvas, data, width, height) {
+    const ctx = canvas.getContext('2d');
+    const imageData = pixelsToImageData(data, width, height);
+    ctx.putImageData(imageData, 0, 0);
+}
+/**
+ * Create a Uint8Array view of a Buffer without copying
+ *
+ * @param buffer - Node.js Buffer
+ * @returns Uint8Array view of the same memory
+ */
+export function bufferToUint8Array(buffer) {
+    return new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+}
+/**
+ * Resize raw pixel data using canvas
+ *
+ * @param data - Source pixel data (RGBA format)
+ * @param srcWidth - Source width
+ * @param srcHeight - Source height
+ * @param dstWidth - Destination width
+ * @param dstHeight - Destination height
+ * @param canvas - Optional canvas to reuse (for performance)
+ * @returns Resized pixel data as Buffer
+ */
+export function resizePixels(data, srcWidth, srcHeight, dstWidth, dstHeight, canvas) {
+    // Create source canvas
+    const srcCanvas = new Canvas(srcWidth, srcHeight);
+    const srcCtx = srcCanvas.getContext('2d');
+    const srcImageData = pixelsToImageData(data, srcWidth, srcHeight);
+    srcCtx.putImageData(srcImageData, 0, 0);
+    // Create or reuse destination canvas
+    const dstCanvas = canvas ?? new Canvas(dstWidth, dstHeight);
+    if (dstCanvas.width !== dstWidth || dstCanvas.height !== dstHeight) {
+        // Canvas dimensions don't match, need to create new one
+        const newDst = new Canvas(dstWidth, dstHeight);
+        const dstCtx = newDst.getContext('2d');
+        dstCtx.drawImage(srcCanvas, 0, 0, dstWidth, dstHeight);
+        return getRawPixels(newDst);
+    }
+    const dstCtx = dstCanvas.getContext('2d');
+    resetCanvas(dstCtx);
+    dstCtx.drawImage(srcCanvas, 0, 0, dstWidth, dstHeight);
+    return getRawPixels(dstCanvas);
+}
+//# sourceMappingURL=canvas-utils.js.map

package/dist/canvas/canvas-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-utils.js","sourceRoot":"","sources":["../../src/canvas/canvas-utils.ts"],"names":[],"mappings":"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"}