@flare-engine/render 0.4.7 → 0.4.10

package/dist/index.mjs

@@ -782,12 +782,21 @@ function flashIntensity(effect) {
 // src/frame-renderer.ts
 /** See the dev-flag note at the top of this file. */
 const G = globalThis;
+/** `SpriteDrawCommand.rotation` is radians; `DrawSurfaceLike.rotate` takes degrees. */
+const RAD_TO_DEG = 180 / Math.PI;
 const BLEND_SRC_OVER = 3;
 const BLEND_SRC_IN = 5;
 /** Skia BlendMode.SrcATop — r = s·da + d·(1−sa): keeps the art's alpha, lerps colour by the filter's alpha. */
 const BLEND_SRC_ATOP = 9;
 /** Skia BlendMode.Plus — additive: dst = clamp(src + dst). */
 const BLEND_PLUS = 12;
+/** Shared empty result for `compilePostFxPasses`, so a chain-free frame allocates nothing. */
+const EMPTY_COMPILED_PASSES = [];
+/** The two sampling objects `setImageSampling` hands to the surface — shared, never rebuilt. */
+const SAMPLING_NEAREST = { filter: 0 };
+const SAMPLING_LINEAR = { filter: 1 };
+/** Skia MipmapMode.None — the stretch path never mipmaps. */
+const MIPMAP_NONE = 0;
 const OUTLINE_OFFSETS = [
 	[1, 0],
 	[-1, 0],
@@ -846,6 +855,7 @@ function createFrameRenderer(Skia) {
 	const stretchDstRects = [];
 	let stretchPaint = null;
 	const zoneBgRects = [];
+	const imageSampling = /* @__PURE__ */ new WeakMap();
 	let _cachedSrcSlice = null;
 	let _cachedSrcSliceLen = 0;
 	let _cachedXformSlice = null;
@@ -893,6 +903,17 @@ function createFrameRenderer(Skia) {
 		_loggedOnce.add(msg);
 		console.warn(`[postfx] ${msg}`);
 	}
+	function compilePostFxPasses(runtime, chain, width, height) {
+		const rt = runtime ?? _boundRuntime;
+		const ch = chain ?? _boundChain;
+		if (rt === null || !rt.supported) return EMPTY_COMPILED_PASSES;
+		if (rt.buildPass === void 0) {
+			logOnce("buildPostFxPasses: runtime.supported but buildPass absent — no passes");
+			return EMPTY_COMPILED_PASSES;
+		}
+		if (ch === null) return EMPTY_COMPILED_PASSES;
+		return rt.buildPass(ch, width, height);
+	}
 	const canvas = {
 		save: () => current?.save() ?? 0,
 		restore: () => {
@@ -1201,21 +1222,19 @@ function createFrameRenderer(Skia) {
 		mountainHillsPaint.setShader(mountainHillsEffect.makeShader(mountainHillsUniforms));
 		return mountainHillsPaint;
 	}
-	function drawOutlined(cvs, image, commands, n, effect, alpha) {
+	function drawOutlined(cvs, image, commands, n, effect, alpha, sampling) {
 		const paint = applyOutlinePaint(effect);
 		paint.setAlphaf(alpha);
 		const srcs = getCachedSrcSlice(n);
 		for (let k = 0; k < OUTLINE_OFFSETS.length; k++) {
 			const offset = OUTLINE_OFFSETS[k];
 			fillXforms(commands, n, offset[0] * effect.width, offset[1] * effect.width);
-			const dsts = getCachedXformSlice(n);
-			cvs.drawAtlas(image, srcs, dsts, paint);
+			drawAtlasSampled(cvs, image, srcs, getCachedXformSlice(n), paint, sampling);
 		}
 		paint.setAlphaf(1);
 		defaultPaint.setAlphaf(alpha);
 		fillXforms(commands, n, 0, 0);
-		const mainDsts = getCachedXformSlice(n);
-		cvs.drawAtlas(image, srcs, mainDsts, defaultPaint);
+		drawAtlasSampled(cvs, image, srcs, getCachedXformSlice(n), defaultPaint, sampling);
 		defaultPaint.setAlphaf(1);
 	}
 	function resolveEffectPaint(effect) {
@@ -1259,6 +1278,7 @@ function createFrameRenderer(Skia) {
 			const blendAdditive = cmd0.blend === "additive";
 			const flipX = cmd0.flipX;
 			const flipY = cmd0.flipY;
+			const sampling = imageSampling.get(image);
 			currentSpriteW = cmd0.dstW;
 			currentSpriteH = cmd0.dstH;
 			if (effect?.type === "roofs-city" || effect?.type === "forest-canopy" || effect?.type === "river-wave" || effect?.type === "moon-crater" || effect?.type === "cave-interior" || effect?.type === "mountain-hills") {
@@ -1292,12 +1312,13 @@ function createFrameRenderer(Skia) {
 						const cx = cmd.dstX + cmd.dstW * .5;
 						const cy = cmd.dstY + cmd.dstH * .5;
 						current.save();
+						if (cmd.rotation !== 0) current.rotate(cmd.rotation * RAD_TO_DEG, cmd.dstX + cmd.anchorX * cmd.dstW, cmd.dstY + cmd.anchorY * cmd.dstH);
 						current.translate(cx, cy);
 						current.scale(cmd.flipX ? -1 : 1, cmd.flipY ? -1 : 1);
 						current.translate(-cx, -cy);
-						current.drawImageRect(image, srcR, dstR, sPaint);
+						drawImageRectSampled(current, image, srcR, dstR, sPaint, sampling);
 						current.restore();
-					} else current.drawImageRect(image, srcR, dstR, sPaint);
+					} else drawImageRectSampled(current, image, srcR, dstR, sPaint, sampling);
 				}
 				sPaint.setAlphaf(1);
 				if (blendAdditive) sPaint.setBlendMode?.(BLEND_SRC_OVER);
@@ -1310,7 +1331,7 @@ function createFrameRenderer(Skia) {
 					outlinePaint?.setBlendMode?.(BLEND_PLUS);
 					defaultPaint.setBlendMode?.(BLEND_PLUS);
 				}
-				drawOutlined(current, image, commands, n, effect, alpha);
+				drawOutlined(current, image, commands, n, effect, alpha, sampling);
 				if (blendAdditive) {
 					outlinePaint?.setBlendMode?.(BLEND_SRC_OVER);
 					defaultPaint.setBlendMode?.(BLEND_SRC_OVER);
@@ -1323,10 +1344,15 @@ function createFrameRenderer(Skia) {
 			const paint = effect === void 0 ? defaultPaint : resolveEffectPaint(effect);
 			if (blendAdditive) paint.setBlendMode?.(BLEND_PLUS);
 			paint.setAlphaf(alpha);
-			current.drawAtlas(image, srcs, dsts, paint);
+			drawAtlasSampled(current, image, srcs, dsts, paint, sampling);
 			paint.setAlphaf(1);
 			if (blendAdditive) paint.setBlendMode?.(BLEND_SRC_OVER);
 		},
+		setImageSampling(image, sampling) {
+			if (sampling === "nearest") imageSampling.set(image, SAMPLING_NEAREST);
+			else if (sampling === "linear") imageSampling.set(image, SAMPLING_LINEAR);
+			else throw new RangeError(`setImageSampling: unknown sampling '${String(sampling)}' (expected 'nearest' or 'linear')`);
+		},
 		setPostFxBinding(runtime, chain) {
 			_boundRuntime = runtime;
 			_boundChain = chain;
@@ -1334,16 +1360,9 @@ function createFrameRenderer(Skia) {
 		hasPostFxBinding() {
 			return _boundRuntime !== null && !!_boundRuntime.supported && _boundRuntime.buildPass !== void 0 && _boundChain !== null;
 		},
+		compilePostFxPasses,
 		buildPostFxPasses(runtime, chain, width, height) {
-			const rt = runtime ?? _boundRuntime;
-			const ch = chain ?? _boundChain;
-			if (rt === null || !rt.supported) return [];
-			if (rt.buildPass === void 0) {
-				logOnce("buildPostFxPasses: runtime.supported but buildPass absent — no passes");
-				return [];
-			}
-			if (ch === null) return [];
-			const passes = rt.buildPass(ch, width, height);
+			const passes = compilePostFxPasses(runtime, chain, width, height);
 			if (passes.length === 0) return [];
 			const out = [];
 			for (const pass of passes) {
@@ -1404,6 +1423,15 @@ function getXformCounters() {
 		unrotated: _xformUnrotatedCount
 	};
 }
+/** Without a sampling setting this is exactly the 4-argument call the surface always received. */
+function drawAtlasSampled(cvs, image, srcs, dsts, paint, sampling) {
+	if (sampling === void 0) cvs.drawAtlas(image, srcs, dsts, paint);
+	else cvs.drawAtlas(image, srcs, dsts, paint, void 0, void 0, sampling);
+}
+function drawImageRectSampled(cvs, image, src, dst, paint, sampling) {
+	if (sampling === void 0 || cvs.drawImageRectOptions === void 0) cvs.drawImageRect(image, src, dst, paint);
+	else cvs.drawImageRectOptions(image, src, dst, sampling.filter, MIPMAP_NONE, paint);
+}
 function writeColor(out, color, alphaMul) {
 	out[0] = color.r;
 	out[1] = color.g;