q5 2.21.5 → 2.22.2

package/q5.js

@@ -1,6 +1,6 @@
 /**
  * q5.js
- * @version 2.21
+ * @version 2.22
  * @author quinton-ashley, Tezumie, and LingDong-
  * @license LGPL-3.0
  * @class Q5
@@ -41,7 +41,8 @@ function Q5(scope, parent, renderer) {
 
 	$.canvas = $.ctx = $.drawingContext = null;
 	$.pixels = [];
-	let looper = null;
+	let looper = null,
+		useRAF = true;
 
 	$.frameCount = 0;
 	$.deltaTime = 16;
@@ -83,13 +84,22 @@ function Q5(scope, parent, renderer) {
 			$._didResize = false;
 		}
 
-		if ($._loop) looper = raf($._draw);
-		else if ($.frameCount && !$._redraw) return;
+		if ($._loop) {
+			if (useRAF) looper = raf($._draw);
+			else {
+				let nextTS = ts + $._targetFrameDuration;
+				let frameDelay = nextTS - performance.now();
+				while (frameDelay < 0) frameDelay += $._targetFrameDuration;
+				log(frameDelay);
+				looper = setTimeout(() => $._draw(nextTS), frameDelay);
+			}
+		} else if ($.frameCount && !$._redraw) return;
 
-		if (looper && $.frameCount) {
-			let time_since_last = ts - $._lastFrameTime;
-			if (time_since_last < $._targetFrameDuration - 4) return;
+		if ($.frameCount && useRAF) {
+			let timeSinceLast = ts - $._lastFrameTime;
+			if (timeSinceLast < $._targetFrameDuration - 4) return;
 		}
+
 		q.deltaTime = ts - $._lastFrameTime;
 		$._frameRate = 1000 / $.deltaTime;
 		q.frameCount++;
@@ -100,7 +110,6 @@ function Q5(scope, parent, renderer) {
 		try {
 			$.draw();
 		} catch (e) {
-			if (!Q5.disableFriendlyErrors && $._askAI) $._askAI(e);
 			if (!Q5.errorTolerant) $.noLoop();
 			throw e;
 		}
@@ -117,6 +126,10 @@ function Q5(scope, parent, renderer) {
 	};
 	$.noLoop = () => {
 		$._loop = false;
+		if (looper) {
+			if (useRAF) cancelAnimationFrame(looper);
+			else clearTimeout(looper);
+		}
 		looper = null;
 	};
 	$.loop = () => {
@@ -140,6 +153,14 @@ function Q5(scope, parent, renderer) {
 		if (hz) {
 			$._targetFrameRate = hz;
 			$._targetFrameDuration = 1000 / hz;
+
+			if ($._loop && $._setupDone && looper != null) {
+				if (useRAF) cancelAnimationFrame(looper);
+				else clearTimeout(looper);
+				looper = null;
+			}
+			useRAF = hz <= 60;
+			setTimeout(() => $._draw(), $._targetFrameDuration);
 		}
 		return $._frameRate;
 	};
@@ -243,20 +264,13 @@ function Q5(scope, parent, renderer) {
 	for (let k of userFns) {
 		if (!t[k]) $[k] = () => {};
 		else if ($._isGlobal) {
-			$[k] = (event) => {
-				try {
-					return t[k](event);
-				} catch (e) {
-					if ($._askAI) $._askAI(e);
-					throw e;
-				}
-			};
+			$[k] = (event) => t[k](event);
 		}
 	}
 
 	async function _setup() {
 		$._startDone = true;
-		if ($._preloadCount > 0) return raf(_setup);
+		if ($._preloadCount > 0 || $._g?._preloadCount > 0) return raf(_setup);
 		millisStart = performance.now();
 		await $.setup();
 		$._setupDone = true;
@@ -314,7 +328,7 @@ function createCanvas(w, h, opt) {
 	}
 }
 
-Q5.version = Q5.VERSION = '2.21';
+Q5.version = Q5.VERSION = '2.22';
 
 if (typeof document == 'object') {
 	document.addEventListener('DOMContentLoaded', () => {
@@ -407,7 +421,6 @@ Q5.modules.canvas = ($, q) => {
 		if ($._hooks) {
 			for (let m of $._hooks.postCanvas) m();
 		}
-		if ($._beginRender) $._beginRender();
 
 		if ($._addEventMethods) $._addEventMethods(c);
 
@@ -514,7 +527,7 @@ Q5.modules.canvas = ($, q) => {
 	$.pixelDensity = (v) => {
 		if (!v || v == $._pixelDensity) return $._pixelDensity;
 		$._pixelDensity = v;
-		$._setCanvasSize(c.w, c.h);
+		$._resizeCanvas(c.w, c.h);
 		return v;
 	};
 
@@ -688,6 +701,22 @@ Q5.renderers.c2d.canvas = ($, q) => {
 
 	if ($._scope == 'image') return;
 
+	$.background = function (c) {
+		$.ctx.save();
+		$.ctx.resetTransform();
+		$.ctx.globalAlpha = 1;
+		if (c.canvas) $.image(c, 0, 0, $.canvas.width, $.canvas.height);
+		else {
+			if (Q5.Color && !c._q5Color) {
+				if (typeof c != 'string') c = $.color(...arguments);
+				else if ($._namedColors[c]) c = $.color(...$._namedColors[c]);
+			}
+			$.ctx.fillStyle = c.toString();
+			$.ctx.fillRect(0, 0, $.canvas.width, $.canvas.height);
+		}
+		$.ctx.restore();
+	};
+
 	$._resizeCanvas = (w, h) => {
 		let t = {};
 		for (let prop in $.ctx) {
@@ -868,22 +897,6 @@ Q5.renderers.c2d.shapes = ($) => {
 
 	// DRAWING
 
-	$.background = function (c) {
-		$.ctx.save();
-		$.ctx.resetTransform();
-		$.ctx.globalAlpha = 1;
-		if (c.canvas) $.image(c, 0, 0, $.canvas.width, $.canvas.height);
-		else {
-			if (Q5.Color && !c._q5Color) {
-				if (typeof c != 'string') c = $.color(...arguments);
-				else if ($._namedColors[c]) c = $.color(...$._namedColors[c]);
-			}
-			$.ctx.fillStyle = c.toString();
-			$.ctx.fillRect(0, 0, $.canvas.width, $.canvas.height);
-		}
-		$.ctx.restore();
-	};
-
 	$.line = (x0, y0, x1, y1) => {
 		if ($._doStroke) {
 			$._da && ((x0 *= $._da), (y0 *= $._da), (x1 *= $._da), (y1 *= $._da));
@@ -1217,8 +1230,8 @@ Q5.renderers.c2d.shapes = ($) => {
 	$.erase = function (fillAlpha = 255, strokeAlpha = 255) {
 		$.ctx.save();
 		$.ctx.globalCompositeOperation = 'destination-out';
-		$.ctx.fillStyle = `rgba(0, 0, 0, ${fillAlpha / 255})`;
-		$.ctx.strokeStyle = `rgba(0, 0, 0, ${strokeAlpha / 255})`;
+		$.ctx.fillStyle = `rgb(0 0 0 / ${fillAlpha / 255})`;
+		$.ctx.strokeStyle = `rgb(0 0 0 / ${strokeAlpha / 255})`;
 	};
 
 	$.noErase = function () {
@@ -1868,7 +1881,7 @@ Q5.renderers.c2d.text = ($, q) => {
 
 	$.createTextImage = (str, w, h) => {
 		genTextImage = true;
-		img = $.text(str, 0, 0, w, h);
+		let img = $.text(str, 0, 0, w, h);
 		genTextImage = false;
 		return img;
 	};
@@ -2095,21 +2108,29 @@ Q5.modules.ai = ($) => {
 };
 Q5.modules.color = ($, q) => {
 	$.RGB = $.RGBA = $._colorMode = 'rgb';
-	$.SRGB = 'srgb';
+	$.HSL = 'hsl';
+	$.HSB = 'hsb';
 	$.OKLCH = 'oklch';
 
-	$.colorMode = (mode, format) => {
+	$.SRGB = 'srgb';
+	$.DISPLAY_P3 = 'display-p3';
+
+	$.colorMode = (mode, format, gamut) => {
 		$._colorMode = mode;
-		let srgb = $.canvas.colorSpace == 'srgb' || mode == 'srgb';
+		let srgb = $.canvas.colorSpace == 'srgb' || gamut == 'srgb';
 		format ??= srgb ? 'integer' : 'float';
 		$._colorFormat = format == 'float' || format == 1 ? 1 : 255;
 		if (mode == 'oklch') {
 			q.Color = Q5.ColorOKLCH;
+		} else if (mode == 'hsl') {
+			q.Color = srgb ? Q5.ColorHSL : Q5.ColorHSL_P3;
+		} else if (mode == 'hsb') {
+			q.Color = srgb ? Q5.ColorHSB : Q5.ColorHSB_P3;
 		} else {
 			if ($._colorFormat == 255) {
-				q.Color = srgb ? Q5.ColorRGBA_8 : Q5.ColorRGBA_P3_8;
+				q.Color = srgb ? Q5.ColorRGB_8 : Q5.ColorRGB_P3_8;
 			} else {
-				q.Color = srgb ? Q5.ColorRGBA : Q5.ColorRGBA_P3;
+				q.Color = srgb ? Q5.ColorRGB : Q5.ColorRGB_P3;
 			}
 			$._colorMode = 'rgb';
 		}
@@ -2203,7 +2224,8 @@ Q5.modules.color = ($, q) => {
 
 	$.lightness = (c) => {
 		if (c.l) return c.l;
-		return ((0.2126 * c.r + 0.7152 * c.g + 0.0722 * c.b) * 100) / 255;
+		let l = (0.2126 * c.r + 0.7152 * c.g + 0.0722 * c.b) * 100;
+		return $._colorFormat == 255 ? l / 255 : l;
 	};
 	$.hue = (c) => {
 		if (c.h) return c.h;
@@ -2248,6 +2270,12 @@ Q5.Color = class {
 	constructor() {
 		this._q5Color = true;
 	}
+	get alpha() {
+		return this.a;
+	}
+	set alpha(v) {
+		this.a = v;
+	}
 };
 
 Q5.ColorOKLCH = class extends Q5.Color {
@@ -2289,15 +2317,9 @@ Q5.ColorOKLCH = class extends Q5.Color {
 	set hue(v) {
 		this.h = v;
 	}
-	get alpha() {
-		return this.a;
-	}
-	set alpha(v) {
-		this.a = v;
-	}
 };
 
-Q5.ColorRGBA = class extends Q5.Color {
+Q5.ColorRGB = class extends Q5.Color {
 	constructor(r, g, b, a) {
 		super();
 		this.r = r;
@@ -2317,6 +2339,7 @@ Q5.ColorRGBA = class extends Q5.Color {
 	toString() {
 		return `color(srgb ${this.r} ${this.g} ${this.b} / ${this.a})`;
 	}
+
 	get red() {
 		return this.r;
 	}
@@ -2335,22 +2358,16 @@ Q5.ColorRGBA = class extends Q5.Color {
 	set blue(v) {
 		this.b = v;
 	}
-	get alpha() {
-		return this.a;
-	}
-	set alpha(v) {
-		this.a = v;
-	}
 };
 
-Q5.ColorRGBA_P3 = class extends Q5.ColorRGBA {
+Q5.ColorRGB_P3 = class extends Q5.ColorRGB {
 	toString() {
 		return `color(display-p3 ${this.r} ${this.g} ${this.b} / ${this.a})`;
 	}
 };
 
-// legacy 8-bit (0-255) integer color format
-Q5.ColorRGBA_8 = class extends Q5.ColorRGBA {
+// legacy 8-bit (0-255) integer color format, srgb color space
+Q5.ColorRGB_8 = class extends Q5.ColorRGB {
 	constructor(r, g, b, a) {
 		super(r, g, b, a ?? 255);
 	}
@@ -2373,7 +2390,7 @@ Q5.ColorRGBA_8 = class extends Q5.ColorRGBA {
 };
 
 // p3 10-bit color in integer color format, for backwards compatibility
-Q5.ColorRGBA_P3_8 = class extends Q5.ColorRGBA {
+Q5.ColorRGB_P3_8 = class extends Q5.ColorRGB_8 {
 	constructor(r, g, b, a) {
 		super(r, g, b, a ?? 255);
 		this._edited = true;
@@ -2418,6 +2435,159 @@ Q5.ColorRGBA_P3_8 = class extends Q5.ColorRGBA {
 		return this._css;
 	}
 };
+
+Q5.ColorHSL = class extends Q5.Color {
+	constructor(h, s, l, a) {
+		super();
+		this.h = h;
+		this.s = s;
+		this.l = l;
+		this.a = a ?? 1;
+	}
+	get levels() {
+		return [this.h, this.s, this.l, this.a];
+	}
+	equals(c) {
+		return c && this.h == c.h && this.s == c.s && this.l == c.l && this.a == c.a;
+	}
+	isSameColor(c) {
+		return c && this.h == c.h && this.s == c.s && this.l == c.l;
+	}
+	toString() {
+		return `hsl(${this.h} ${this.s} ${this.l} / ${this.a})`;
+	}
+
+	get hue() {
+		return this.h;
+	}
+	set hue(v) {
+		this.h = v;
+	}
+	get saturation() {
+		return this.s;
+	}
+	set saturation(v) {
+		this.s = v;
+	}
+	get lightness() {
+		return this.l;
+	}
+	set lightness(v) {
+		this.l = v;
+	}
+};
+
+Q5.ColorHSL_P3 = class extends Q5.ColorHSL {
+	toString() {
+		let o = Q5.HSLtoRGB(this.h, this.s, this.l);
+		return `color(display-p3 ${o.join(' ')} / ${this.a})`;
+	}
+};
+
+Q5.ColorHSB = class extends Q5.ColorHSL {
+	constructor(h, s, b, a) {
+		super(h, s, b, a);
+		delete this.l;
+		this.b = b;
+	}
+	get levels() {
+		return [this.h, this.s, this.b, this.a];
+	}
+	equals(c) {
+		return c && this.h == c.h && this.s == c.s && this.b == c.b && this.a == c.a;
+	}
+	isSameColor(c) {
+		return c && this.h == c.h && this.s == c.s && this.b == c.b;
+	}
+	toString() {
+		let o = Q5.HSBtoHSL(this.h, this.s, this.b);
+		return `hsl(${o.join(' ')} / ${this.a})`;
+	}
+
+	get v() {
+		return this.b;
+	}
+	set v(v) {
+		this.b = v;
+	}
+	get brightness() {
+		return this.b;
+	}
+	set brightness(v) {
+		this.b = v;
+	}
+	get value() {
+		return this.b;
+	}
+	set value(v) {
+		this.b = v;
+	}
+};
+
+Q5.ColorHSB_P3 = class extends Q5.ColorHSB {
+	toString() {
+		let o = Q5.HSLtoRGB(...Q5.HSBtoHSL(this.h, this.s, this.b));
+		return `color(display-p3 ${o.join(' ')} / ${this.a})`;
+	}
+};
+
+Q5.HSLtoRGB = (h, s, l) => {
+	l /= 100;
+	let m = (s / 100) * Math.min(l, 1 - l);
+	let f = (n, k = (n + h / 30) % 12) => l - m * Math.max(Math.min(k - 3, 9 - k, 1), -1);
+	return [f(0), f(8), f(4)];
+};
+
+Q5.HSBtoHSL = (h, s, v, l = v * (1 - s / 200)) => [h, !l || l == 100 ? 0 : ((v - l) / Math.min(l, 100 - l)) * 100, l];
+
+{
+	const multiplyMatrices = (A, B) => [
+		A[0] * B[0] + A[1] * B[1] + A[2] * B[2],
+		A[3] * B[0] + A[4] * B[1] + A[5] * B[2],
+		A[6] * B[0] + A[7] * B[1] + A[8] * B[2]
+	];
+
+	const oklch2oklab = (l, c, h) => [
+		l,
+		isNaN(h) ? 0 : c * Math.cos((h * Math.PI) / 180),
+		isNaN(h) ? 0 : c * Math.sin((h * Math.PI) / 180)
+	];
+
+	const srgbLinear2rgb = (rgb) =>
+		rgb.map((c) =>
+			Math.max(
+				0,
+				Math.min(1, Math.abs(c) > 0.0031308 ? (c < 0 ? -1 : 1) * (1.055 * Math.abs(c) ** (1 / 2.4) - 0.055) : 12.92 * c)
+			)
+		);
+
+	const oklab2xyz = (lab) => {
+		const LMSg = multiplyMatrices(
+			[
+				1, 0.3963377773761749, 0.2158037573099136, 1, -0.1055613458156586, -0.0638541728258133, 1, -0.0894841775298119,
+				-1.2914855480194092
+			],
+			lab
+		);
+		return multiplyMatrices(
+			[
+				1.2268798758459243, -0.5578149944602171, 0.2813910456659647, -0.0405757452148008, 1.112286803280317,
+				-0.0717110580655164, -0.0763729366746601, -0.4214933324022432, 1.5869240198367816
+			],
+			LMSg.map((val) => val ** 3)
+		);
+	};
+	const xyz2rgbLinear = (xyz) =>
+		multiplyMatrices(
+			[
+				3.2409699419045226, -1.537383177570094, -0.4986107602930034, -0.9692436362808796, 1.8759675015077202,
+				0.04155505740717559, 0.05563007969699366, -0.20397695888897652, 1.0569715142428786
+			],
+			xyz
+		);
+
+	Q5.OKLCHtoRGB = (l, c, h) => srgbLinear2rgb(xyz2rgbLinear(oklab2xyz(oklch2oklab(l, c, h))));
+}
 Q5.modules.display = ($) => {
 	if (!$.canvas || $._scope == 'graphics') return;
 
@@ -4556,9 +4726,11 @@ struct Q5 {
 	$._pipelineConfigs = [];
 	$._pipelines = [];
 	$._buffers = [];
+	$._prevFramePL = 0;
 	$._framePL = 0;
 
 	// local variables used for slightly better performance
+
 	// stores pipeline shifts and vertex counts/image indices
 	let drawStack = ($.drawStack = []);
 
@@ -4595,7 +4767,7 @@ struct Q5 {
 	$.bindGroupLayouts = [mainLayout];
 
 	let uniformBuffer = Q5.device.createBuffer({
-		size: 64, // Size of four floats
+		size: 64,
 		usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST
 	});
 
@@ -4695,7 +4867,7 @@ fn fragMain(f: FragParams ) -> @location(0) vec4f {
 			fragment: {
 				module: frameShader,
 				entryPoint: 'fragMain',
-				targets: [{ format, blend: $.blendConfigs.normal }]
+				targets: [{ format }]
 			},
 			primitive: { topology: 'triangle-strip' },
 			multisample: { count: 4 }
@@ -4723,27 +4895,24 @@ fn fragMain(f: FragParams ) -> @location(0) vec4f {
 		createMainView();
 	};
 
-	$.pixelDensity = (v) => {
-		if (!v || v == $._pixelDensity) return $._pixelDensity;
-		$._pixelDensity = v;
-		$._setCanvasSize(c.w, c.h);
-		createMainView();
-		return v;
-	};
-
-	// current color index, used to associate a vertex with a color
 	let addColor = (r, g, b, a = 1) => {
-		if (typeof r == 'string') r = $.color(r);
-		else if (b == undefined) {
+		if (typeof r == 'string' || $._colorMode != 'rgb') {
+			r = $.color(r, g, b, a);
+		} else if (b == undefined) {
 			// grayscale mode `fill(1, 0.5)`
 			a = g ?? 1;
 			g = b = r;
 		}
 		if (r._q5Color) {
-			a = r.a;
-			b = r.b;
-			g = r.g;
-			r = r.r;
+			let c = r;
+			if (c.r) ({ r, g, b, a } = c);
+			else {
+				a = c.a;
+				if (c.c != undefined) c = Q5.OKLCHtoRGB(c.l, c.c, c.h);
+				else if (c.l != undefined) c = Q5.HSLtoRGB(c.h, c.s, c.l);
+				else c = Q5.HSLtoRGB(...Q5.HSBtoHSL(c.h, c.s, c.b));
+				[r, g, b] = c;
+			}
 		}
 
 		let cs = colorStack,
@@ -4776,7 +4945,6 @@ fn fragMain(f: FragParams ) -> @location(0) vec4f {
 		$._tint = colorIndex;
 	};
 	$.opacity = (a) => ($._globalAlpha = a);
-
 	$.noFill = () => ($._doFill = false);
 	$.noStroke = () => ($._doStroke = false);
 	$.noTint = () => ($._tint = 1);
@@ -4784,6 +4952,7 @@ fn fragMain(f: FragParams ) -> @location(0) vec4f {
 	$._strokeWeight = 1;
 	$._hsw = 0.5;
 	$._scaledSW = 1;
+
 	$.strokeWeight = (v) => {
 		v = Math.abs(v);
 		$._strokeWeight = v;
@@ -4934,7 +5103,7 @@ fn fragMain(f: FragParams ) -> @location(0) vec4f {
 		$._matrixDirty = true;
 	};
 
-	// function to save the current matrix state if dirty
+	// saves the current matrix state
 	$._saveMatrix = () => {
 		transforms.set(matrix, matrices.length * MATRIX_SIZE);
 		$._matrixIndex = matrices.length;
@@ -5066,13 +5235,28 @@ fn fragMain(f: FragParams ) -> @location(0) vec4f {
 	};
 
 	let shouldClear;
+
 	$.clear = () => {
 		shouldClear = true;
 	};
 
-	$._beginRender = () => {
-		if (encoder) return;
+	$.background = (r, g, b, a) => {
+		$.push();
+		$.resetMatrix();
+		if (r.canvas) {
+			let img = r;
+			$._imageMode = 'corner';
+			$.image(img, -c.hw, -c.hh, c.w, c.h);
+		} else {
+			$._rectMode = 'corner';
+			$.fill(r, g, b, a);
+			$._doStroke = false;
+			$.rect(-c.hw, -c.hh, c.w, c.h);
+		}
+		$.pop();
+	};
 
+	$._beginRender = () => {
 		// swap the frame textures
 		const temp = frameA;
 		frameA = frameB;
@@ -5103,7 +5287,7 @@ fn fragMain(f: FragParams ) -> @location(0) vec4f {
 		});
 
 		if (!shouldClear) {
-			pass.setPipeline($._pipelines[0]);
+			pass.setPipeline($._pipelines[$._prevFramePL]);
 			pass.setBindGroup(0, frameBindGroup);
 			pass.draw(4);
 		}
@@ -5120,6 +5304,8 @@ fn fragMain(f: FragParams ) -> @location(0) vec4f {
 		new Float32Array(transformBuffer.getMappedRange()).set(transforms.slice(0, matrices.length * MATRIX_SIZE));
 		transformBuffer.unmap();
 
+		$._buffers.push(transformBuffer);
+
 		let colorsBuffer = Q5.device.createBuffer({
 			size: colorStackIndex * 4,
 			usage: GPUBufferUsage.STORAGE,
@@ -5129,6 +5315,8 @@ fn fragMain(f: FragParams ) -> @location(0) vec4f {
 		new Float32Array(colorsBuffer.getMappedRange()).set(colorStack.slice(0, colorStackIndex));
 		colorsBuffer.unmap();
 
+		$._buffers.push(colorsBuffer);
+
 		$._uniforms = [
 			$.width,
 			$.height,
@@ -5189,7 +5377,7 @@ fn fragMain(f: FragParams ) -> @location(0) vec4f {
 				pass.setBindGroup(1, $._textureBindGroups[v]);
 				pass.draw(4, 1, imageVertOffset);
 				imageVertOffset += 4;
-			} else if (curPipelineIndex == 1 || curPipelineIndex >= 1000) {
+			} else {
 				// draw a shape
 				// v is the number of vertices
 				pass.draw(v, 1, drawVertOffset);
@@ -5198,7 +5386,7 @@ fn fragMain(f: FragParams ) -> @location(0) vec4f {
 		}
 	};
 
-	$._finishRender = () => {
+	$._finishRender = async () => {
 		pass.end();
 
 		pass = encoder.beginRenderPass({
@@ -5228,6 +5416,7 @@ fn fragMain(f: FragParams ) -> @location(0) vec4f {
 		pass.end();
 
 		Q5.device.queue.submit([encoder.finish()]);
+		$._pass = pass = encoder = null;
 
 		// destroy buffers
 		Q5.device.queue.onSubmittedWorkDone().then(() => {
@@ -5235,8 +5424,6 @@ fn fragMain(f: FragParams ) -> @location(0) vec4f {
 			$._buffers = [];
 		});
 
-		$._pass = pass = encoder = null;
-
 		// clear the stacks for the next frame
 		drawStack.splice(0, drawStack.length);
 		colorIndex = 1;
@@ -5886,22 +6073,6 @@ fn fragMain(f: FragParams) -> @location(0) vec4f {
 		$.endShape(true);
 	};
 
-	$.background = (r, g, b, a) => {
-		$.push();
-		$.resetMatrix();
-		if (r.canvas) {
-			let img = r;
-			$._imageMode = 'corner';
-			$.image(img, -c.hw, -c.hh, c.w, c.h);
-		} else {
-			$._rectMode = 'corner';
-			$.fill(r, g, b, a);
-			$._doStroke = false;
-			$.rect(-c.hw, -c.hh, c.w, c.h);
-		}
-		$.pop();
-	};
-
 	$._hooks.preRender.push(() => {
 		$._pass.setPipeline($._pipelines[1]);
 
@@ -6231,9 +6402,11 @@ fn fragMain(f: FragParams) -> @location(0) vec4f {
 
 	$.createGraphics = (w, h, opt) => {
 		let g = _createGraphics(w, h, opt);
-		$._addTexture(g, g._frameA);
-		$._addTexture(g, g._frameB);
-		g._beginRender();
+		if (g.canvas.renderer == 'webgpu') {
+			$._addTexture(g, g._frameA);
+			$._addTexture(g, g._frameB);
+			g._beginRender();
+		}
 		return g;
 	};
 
@@ -6720,6 +6893,7 @@ fn fragMain(f : FragParams) -> @location(0) vec4f {
 		leadPercent = 1.25;
 
 	$.textFont = (fontName) => {
+		if (!fontName) return $._font;
 		if (typeof fontName != 'string') fontName = fontName.family;
 		let font = fonts[fontName];
 		if (font) $._font = font;
@@ -7049,6 +7223,7 @@ Q5.renderers.webgpu.shaders = ($) => {
 
 		let pl = plCounters[type];
 		$._pipelines[pl] = Q5.device.createRenderPipeline(config);
+		$._pipelines[pl].shader = shader;
 		shader.pipelineIndex = pl;
 
 		plCounters[type]++;
@@ -7063,15 +7238,17 @@ Q5.renderers.webgpu.shaders = ($) => {
 	$.createTextShader = (code) => $._createShader(code, 'text');
 
 	$.shader = (shader) => {
-		$['_' + shader.type + 'PL'] = shader.pipelineIndex;
+		if (shader.applyBeforeDraw) $._prevFramePL = shader.pipelineIndex;
+		else $['_' + shader.type + 'PL'] = shader.pipelineIndex;
 	};
 
 	$.resetShader = (type = 'shapes') => {
+		if (type == 'frame') $._prevFramePL = 0;
 		$['_' + type + 'PL'] = pipelineTypes.indexOf(type);
 	};
 
 	$.resetShaders = () => {
-		$._framePL = 0;
+		$._prevFramePL = $._framePL = 0;
 		$._shapesPL = 1;
 		$._imagePL = 2;
 		$._videoPL = 3;