@codexo/exojs 0.9.0 → 0.11.0

package/dist/esm/rendering/plan/RenderPlanBuilder.js

@@ -0,0 +1,242 @@
+import { Rectangle } from '../../math/Rectangle.js';
+import { RenderEntryKind, makeMaterialKey } from './RenderCommand.js';
+import { MutableRenderPlan } from './RenderPlan.js';
+import { ClipKind } from './RenderScope.js';
+
+/** @internal */
+class RenderPlanBuilder {
+    static _available = [];
+    static _active = [];
+    static acquire() {
+        const builder = RenderPlanBuilder._available.pop() ?? new RenderPlanBuilder();
+        RenderPlanBuilder._active.push(builder);
+        return builder;
+    }
+    static release(builder) {
+        const index = RenderPlanBuilder._active.lastIndexOf(builder);
+        if (index === -1) {
+            return;
+        }
+        RenderPlanBuilder._active.splice(index, 1);
+        builder._resetRuntimeState();
+        RenderPlanBuilder._available.push(builder);
+    }
+    backend;
+    _view = null;
+    _plan = new MutableRenderPlan();
+    _groupPool = [];
+    _scopeStack = [];
+    _groupPoolCursor = 0;
+    _pendingEntryPlacement = null;
+    _nodeIndex = 0;
+    build(root, backend) {
+        this.backend = backend;
+        this._view = null;
+        this._plan.reset();
+        this._groupPoolCursor = 0;
+        this._scopeStack.length = 0;
+        this._pendingEntryPlacement = null;
+        this._nodeIndex = 0;
+        const rootScope = this._acquireGroupScope(false);
+        this._scopeStack.push(rootScope);
+        root._collect(this);
+        this._scopeStack.pop();
+        if (rootScope.entries.length > 0) {
+            this._plan.passes.push({
+                target: null,
+                view: this.view,
+                clearColor: null,
+                root: rootScope,
+            });
+        }
+        this._plan.nodeCount = this._nodeIndex;
+        return this._plan;
+    }
+    get view() {
+        if (this._view === null) {
+            this._view = this.backend.view;
+        }
+        return this._view;
+    }
+    emitNode(node, seq) {
+        const placement = this._reserveEntryPlacement(seq, node.zIndex);
+        if (node._renderPlanHasBarrierEffects()) {
+            const effect = this._createEffectDescriptor(node);
+            const hasAlphaMask = effect.maskSource !== null && !(effect.maskSource instanceof Rectangle);
+            const needsBounds = effect.cacheAsBitmap || effect.filters.length > 0 || hasAlphaMask;
+            let left = 0;
+            let top = 0;
+            let width = 0;
+            let height = 0;
+            if (needsBounds) {
+                const bounds = node.getBounds();
+                if (bounds.width <= 0 || bounds.height <= 0) {
+                    return;
+                }
+                left = Math.floor(bounds.left);
+                top = Math.floor(bounds.top);
+                width = Math.max(1, Math.ceil(bounds.width));
+                height = Math.max(1, Math.ceil(bounds.height));
+            }
+            const childPlan = effect.cacheAsBitmap && node._renderPlanCanReuseBitmapCache(left, top, width, height)
+                ? null
+                : this._acquireGroupScope(this._resolvePreserveDrawOrder(node));
+            const barrierScope = {
+                kind: RenderEntryKind.Barrier,
+                node,
+                effect,
+                childPlan,
+                left,
+                top,
+                width,
+                height,
+            };
+            this._pushEntry({
+                kind: RenderEntryKind.Barrier,
+                seq: placement.seq,
+                zIndex: placement.zIndex,
+                scope: barrierScope,
+            });
+            if (childPlan !== null) {
+                this._scopeStack.push(childPlan);
+                try {
+                    node._collectForRenderPlan(this);
+                }
+                finally {
+                    this._scopeStack.pop();
+                }
+            }
+            return;
+        }
+        if (node._isDrawableForRenderPlan()) {
+            this._pendingEntryPlacement = placement;
+            try {
+                node._collectForRenderPlan(this);
+            }
+            finally {
+                this._pendingEntryPlacement = null;
+            }
+            return;
+        }
+        const groupScope = this._acquireGroupScope(this._resolvePreserveDrawOrder(node));
+        this._pushEntry({
+            kind: RenderEntryKind.Group,
+            seq: placement.seq,
+            zIndex: placement.zIndex,
+            scope: groupScope,
+        });
+        this._scopeStack.push(groupScope);
+        try {
+            node._collectForRenderPlan(this);
+        }
+        finally {
+            this._scopeStack.pop();
+        }
+    }
+    emitDraw(drawable, seq) {
+        const pendingPlacement = this._pendingEntryPlacement;
+        if (pendingPlacement !== null) {
+            this._pendingEntryPlacement = null;
+        }
+        const zIndex = pendingPlacement?.zIndex ?? drawable.zIndex;
+        const placement = this._reserveEntryPlacement(seq ?? pendingPlacement?.seq, zIndex);
+        const bounds = drawable.getBounds();
+        const command = {
+            kind: RenderEntryKind.Draw,
+            drawable,
+            nodeIndex: this._nodeIndex++,
+            seq: placement.seq,
+            zIndex: placement.zIndex,
+            material: makeMaterialKey(drawable, this.backend),
+            minX: bounds.left,
+            minY: bounds.top,
+            maxX: bounds.right,
+            maxY: bounds.bottom,
+        };
+        this._pushEntry({
+            kind: RenderEntryKind.Draw,
+            seq: placement.seq,
+            zIndex: placement.zIndex,
+            command,
+        });
+    }
+    _resetRuntimeState() {
+        this._scopeStack.length = 0;
+        this._pendingEntryPlacement = null;
+        this._groupPoolCursor = 0;
+        this._view = null;
+        this._nodeIndex = 0;
+    }
+    _acquireGroupScope(preserveDrawOrder) {
+        const scope = this._groupPool[this._groupPoolCursor] ?? {
+            kind: RenderEntryKind.Group,
+            entries: [],
+            hasMixedZ: false,
+            preserveDrawOrder: false,
+            _nextSeq: 0,
+            firstZ: null,
+        };
+        this._groupPool[this._groupPoolCursor] = scope;
+        this._groupPoolCursor++;
+        scope.entries.length = 0;
+        scope.hasMixedZ = false;
+        scope.preserveDrawOrder = preserveDrawOrder;
+        scope._nextSeq = 0;
+        scope.firstZ = null;
+        return scope;
+    }
+    _reserveEntryPlacement(seq, zIndex) {
+        const scope = this._currentScope();
+        const nextSeq = seq ?? scope._nextSeq;
+        if (nextSeq >= scope._nextSeq) {
+            scope._nextSeq = nextSeq + 1;
+        }
+        if (scope.firstZ === null) {
+            scope.firstZ = zIndex;
+        }
+        else if (!scope.hasMixedZ && scope.firstZ !== zIndex) {
+            scope.hasMixedZ = true;
+        }
+        return { seq: nextSeq, zIndex };
+    }
+    _pushEntry(entry) {
+        this._currentScope().entries.push(entry);
+    }
+    _currentScope() {
+        const scope = this._scopeStack[this._scopeStack.length - 1];
+        if (!scope) {
+            throw new Error('RenderPlanBuilder scope stack is empty.');
+        }
+        return scope;
+    }
+    _resolvePreserveDrawOrder(node) {
+        return node.preserveDrawOrder;
+    }
+    _createEffectDescriptor(node) {
+        const mask = node._renderPlanGetMaskSource();
+        let clip = ClipKind.None;
+        let clipShape = null;
+        if (node.clip) {
+            const shape = node.clipShape;
+            if (shape === null || shape instanceof Rectangle) {
+                clip = ClipKind.Rect;
+                clipShape = shape;
+            }
+            else {
+                clip = ClipKind.Stencil;
+                clipShape = shape;
+            }
+        }
+        return {
+            filters: node._renderPlanGetFilters(),
+            clip,
+            clipShape,
+            maskSource: mask,
+            cacheAsBitmap: node.cacheAsBitmap,
+            blendMode: node._renderPlanGetBlendMode(),
+        };
+    }
+}
+
+export { RenderPlanBuilder };
+//# sourceMappingURL=RenderPlanBuilder.js.map

package/dist/esm/rendering/plan/RenderPlanBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderPlanBuilder.js","sources":["../../../../../src/rendering/plan/RenderPlanBuilder.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/rendering/plan/RenderPlanOptimizer.d.ts

@@ -0,0 +1,10 @@
+import type { RenderPlan } from './RenderPlan';
+/** @internal */
+export declare class RenderPlanOptimizer {
+    static optimize(plan: RenderPlan): void;
+    private static _optimizeGroup;
+    private static _applyMaterialGrouping;
+    private static _assignGroupIndices;
+    private static _materialGroupSegment;
+    private static _overlapAwareGroup;
+}

package/dist/esm/rendering/plan/RenderPlanOptimizer.js

@@ -0,0 +1,180 @@
+import { RenderEntryKind } from './RenderCommand.js';
+
+const groupKey = (material) => `${material.pipelineKey}:${material.bindKey}`;
+const aabbOverlap = (a, b) => a.minX < b.maxX && a.maxX > b.minX && a.minY < b.maxY && a.maxY > b.minY;
+/** @internal */
+class RenderPlanOptimizer {
+    static optimize(plan) {
+        for (const pass of plan.passes) {
+            this._optimizeGroup(pass.root);
+        }
+    }
+    static _optimizeGroup(scope) {
+        if (scope.hasMixedZ) {
+            const indexed = scope.entries.map((entry, index) => ({ entry, index }));
+            indexed.sort((left, right) => {
+                return left.entry.zIndex - right.entry.zIndex || left.entry.seq - right.entry.seq || left.index - right.index;
+            });
+            for (let i = 0; i < indexed.length; i++) {
+                scope.entries[i] = indexed[i].entry;
+            }
+        }
+        this._applyMaterialGrouping(scope);
+        for (const entry of scope.entries) {
+            if (entry.kind === RenderEntryKind.Group) {
+                this._optimizeGroup(entry.scope);
+            }
+            else if (entry.kind === RenderEntryKind.Barrier && entry.scope.childPlan !== null) {
+                this._optimizeGroup(entry.scope.childPlan);
+            }
+        }
+    }
+    static _applyMaterialGrouping(scope) {
+        const entries = scope.entries;
+        const n = entries.length;
+        if (n === 0) {
+            return;
+        }
+        let segStart = 0;
+        for (let i = 0; i <= n; i++) {
+            const entry = i < n ? entries[i] : null;
+            const isBoundary = entry === null || entry.kind === RenderEntryKind.Group || entry.kind === RenderEntryKind.Barrier;
+            if (isBoundary && i > segStart) {
+                const segEnd = i;
+                const segLen = segEnd - segStart;
+                if (segLen >= 1) {
+                    this._materialGroupSegment(entries, segStart, segEnd, scope.preserveDrawOrder);
+                }
+                segStart = i + 1;
+            }
+            else if (isBoundary) {
+                segStart = i + 1;
+            }
+        }
+        this._assignGroupIndices(scope);
+    }
+    static _assignGroupIndices(scope) {
+        let nextGroupIndex = 1;
+        let prevKey = null;
+        let prevZ = null;
+        for (const entry of scope.entries) {
+            if (entry.kind !== RenderEntryKind.Draw) {
+                prevKey = null;
+                prevZ = null;
+                continue;
+            }
+            const key = groupKey(entry.command.material);
+            const z = entry.zIndex;
+            if (prevKey === null || prevZ === null || key !== prevKey || z !== prevZ) {
+                nextGroupIndex++;
+                prevKey = key;
+                prevZ = z;
+            }
+            entry.command.groupIndex = nextGroupIndex;
+        }
+    }
+    static _materialGroupSegment(entries, start, end, preserveDrawOrder) {
+        const len = end - start;
+        if (len <= 1) {
+            return;
+        }
+        const draws = [];
+        for (let i = start; i < end; i++) {
+            const entry = entries[i];
+            if (entry.kind === RenderEntryKind.Draw) {
+                draws.push({ entry, origIdx: i });
+            }
+        }
+        if (draws.length <= 1) {
+            return;
+        }
+        if (!preserveDrawOrder) {
+            const zGroups = new Map();
+            for (const d of draws) {
+                const z = d.entry.zIndex;
+                const list = zGroups.get(z) ?? [];
+                list.push(d);
+                zGroups.set(z, list);
+            }
+            for (const zGroup of zGroups.values()) {
+                if (zGroup.length > 1) {
+                    this._overlapAwareGroup(zGroup, entries, start, end);
+                }
+            }
+        }
+    }
+    static _overlapAwareGroup(zGroup, entries, segStart, segEnd) {
+        const keyGroups = new Map();
+        for (const d of zGroup) {
+            const key = groupKey(d.entry.command.material);
+            const list = keyGroups.get(key) ?? [];
+            list.push(d);
+            keyGroups.set(key, list);
+        }
+        if (keyGroups.size <= 1) {
+            return;
+        }
+        for (const group of keyGroups.values()) {
+            if (group.length <= 1) {
+                continue;
+            }
+            const positions = [];
+            for (const g of group) {
+                const pos = entries.indexOf(g.entry, segStart);
+                if (pos >= segStart && pos < segEnd) {
+                    positions.push(pos);
+                }
+            }
+            positions.sort((a, b) => a - b);
+            const first = positions[0];
+            const last = positions[positions.length - 1];
+            if (last - first + 1 === positions.length) {
+                continue;
+            }
+            let blocked = false;
+            for (let p = first + 1; p < last && !blocked; p++) {
+                const mid = entries[p];
+                if (mid.kind !== RenderEntryKind.Draw) {
+                    continue;
+                }
+                const midKey = groupKey(mid.command.material);
+                if (midKey === groupKey(group[0].entry.command.material)) {
+                    continue;
+                }
+                for (const g of group) {
+                    if (aabbOverlap(g.entry.command, mid.command)) {
+                        blocked = true;
+                        break;
+                    }
+                }
+            }
+            if (blocked) {
+                continue;
+            }
+            const beforeFirst = [];
+            for (let p = segStart; p < first; p++) {
+                beforeFirst.push(entries[p]);
+            }
+            const afterLast = [];
+            for (let p = last + 1; p < segEnd; p++) {
+                afterLast.push(entries[p]);
+            }
+            const groupSet = new Set(group.map(g => g.entry));
+            const betweenNonGroup = [];
+            for (let p = first; p <= last; p++) {
+                if (!groupSet.has(entries[p])) {
+                    betweenNonGroup.push(entries[p]);
+                }
+            }
+            const groupEntries = group.map(g => g.entry);
+            const reordered = [...beforeFirst, ...groupEntries, ...betweenNonGroup, ...afterLast];
+            for (let p = segStart; p < segEnd; p++) {
+                entries[p] = reordered[p - segStart];
+            }
+            break;
+        }
+    }
+}
+
+export { RenderPlanOptimizer };
+//# sourceMappingURL=RenderPlanOptimizer.js.map

package/dist/esm/rendering/plan/RenderPlanOptimizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderPlanOptimizer.js","sources":["../../../../../src/rendering/plan/RenderPlanOptimizer.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/rendering/plan/RenderPlanPlayer.d.ts

@@ -0,0 +1,13 @@
+import type { RenderBackend } from '@/rendering/RenderBackend';
+import type { RenderPlan } from './RenderPlan';
+import type { RenderScope } from './RenderScope';
+/** @internal */
+export declare class RenderPlanPlayer {
+    static play(plan: RenderPlan, backend: RenderBackend): void;
+    static playScope(scope: RenderScope, backend: RenderBackend): void;
+    private static _playScope;
+    private static _playGroup;
+    private static _createPlaybackContext;
+    private static _createRenderGroupPlaybackContext;
+    private static _createRenderInstructionSlot;
+}

package/dist/esm/rendering/plan/RenderPlanPlayer.js

@@ -0,0 +1,107 @@
+import { RenderEntryKind } from './RenderCommand.js';
+import { RenderEffectExecutor } from './RenderEffectExecutor.js';
+import { collectRenderGroups } from './RenderInstruction.js';
+
+/** @internal */
+class RenderPlanPlayer {
+    static play(plan, backend) {
+        const hooks = backend;
+        hooks._beginDrawPlan?.(plan.nodeCount);
+        try {
+            for (const pass of plan.passes) {
+                if (pass.target !== null && backend.renderTarget !== pass.target) {
+                    backend.setRenderTarget(pass.target);
+                }
+                if (backend.view !== pass.view) {
+                    backend.setView(pass.view);
+                }
+                if (pass.clearColor !== null) {
+                    backend.clear(pass.clearColor);
+                }
+                this._playScope(pass.root, backend, hooks, this._createPlaybackContext());
+            }
+        }
+        finally {
+            hooks._endDrawPlan?.();
+        }
+    }
+    static playScope(scope, backend) {
+        const hooks = backend;
+        this._playScope(scope, backend, hooks, this._createPlaybackContext());
+    }
+    static _playScope(scope, backend, hooks, context) {
+        if (scope.kind === RenderEntryKind.Barrier) {
+            RenderEffectExecutor.play(scope, backend, childScope => {
+                this._playScope(childScope, backend, hooks, context);
+            });
+            return;
+        }
+        this._playGroup(scope, backend, hooks, context);
+    }
+    static _playGroup(scope, backend, hooks, context) {
+        const groups = collectRenderGroups(scope);
+        let groupCursor = 0;
+        let currentGroup = null;
+        let currentInstructionIndex = 0;
+        for (const entry of scope.entries) {
+            if (entry.kind === RenderEntryKind.Draw) {
+                if (currentGroup === null) {
+                    currentGroup = groups[groupCursor];
+                    currentInstructionIndex = 0;
+                    hooks._beginRenderGroup?.(currentGroup);
+                    hooks._prepareRenderGroupUpload?.(currentGroup, this._createRenderGroupPlaybackContext(currentGroup.instructions.length, context.passInstructionIndex, context.passGroupIndex));
+                    context.passGroupIndex++;
+                }
+                // Allocate the per-draw instruction slot only when a backend consumes
+                // it. No shipped backend implements `_prepareRenderInstructionSlot`, so
+                // skipping the `Object.freeze` slot allocation removes per-draw garbage
+                // from the playback hot path while preserving the extension point.
+                if (hooks._prepareRenderInstructionSlot !== undefined) {
+                    const slot = this._createRenderInstructionSlot(currentInstructionIndex, context.passInstructionIndex);
+                    hooks._prepareRenderInstructionSlot(entry.command, slot);
+                }
+                hooks._prepareDrawCommand?.(entry.command);
+                backend.draw(entry.command.drawable);
+                currentInstructionIndex++;
+                context.passInstructionIndex++;
+                if (currentGroup !== null && currentInstructionIndex === currentGroup.instructions.length) {
+                    hooks._endRenderGroup?.(currentGroup);
+                    currentGroup = null;
+                    currentInstructionIndex = 0;
+                    groupCursor++;
+                }
+            }
+            else if (entry.kind === RenderEntryKind.Group) {
+                this._playGroup(entry.scope, backend, hooks, context);
+            }
+            else {
+                RenderEffectExecutor.play(entry.scope, backend, childScope => {
+                    this._playScope(childScope, backend, hooks, context);
+                });
+            }
+        }
+    }
+    static _createPlaybackContext() {
+        return {
+            passInstructionIndex: 0,
+            passGroupIndex: 0,
+        };
+    }
+    static _createRenderGroupPlaybackContext(groupInstructionCount, firstPassInstructionIndex, passGroupIndex) {
+        return Object.freeze({
+            groupInstructionCount,
+            firstPassInstructionIndex,
+            lastPassInstructionIndex: firstPassInstructionIndex + groupInstructionCount - 1,
+            passGroupIndex,
+        });
+    }
+    static _createRenderInstructionSlot(groupInstructionIndex, passInstructionIndex) {
+        return Object.freeze({
+            groupInstructionIndex,
+            passInstructionIndex,
+        });
+    }
+}
+
+export { RenderPlanPlayer };
+//# sourceMappingURL=RenderPlanPlayer.js.map

package/dist/esm/rendering/plan/RenderPlanPlayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderPlanPlayer.js","sources":["../../../../../src/rendering/plan/RenderPlanPlayer.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/rendering/plan/RenderScope.d.ts

@@ -0,0 +1,70 @@
+import type { Rectangle } from '@/math/Rectangle';
+import type { Filter } from '@/rendering/filters/Filter';
+import type { Geometry } from '@/rendering/geometry/Geometry';
+import type { MaskSource, RenderNode } from '@/rendering/RenderNode';
+import type { BlendModes } from '@/rendering/types';
+import type { DrawCommand, RenderEntryKind } from './RenderCommand';
+/**
+ * Geometric clip kind for a {@link RenderNode}'s `clip`/`clipShape`. Distinct
+ * from `maskSource` (alpha/visibility masking): `Rect` uses the GPU scissor
+ * fast path, `Stencil` writes a {@link Geometry} silhouette into the stencil
+ * buffer. `maskSource` continues to drive the separate alpha-mask machinery.
+ * @internal
+ */
+export declare const enum ClipKind {
+    None = 0,
+    Rect = 1,
+    Stencil = 2
+}
+/** @internal */
+export interface EffectDescriptor {
+    readonly filters: readonly Filter[];
+    readonly clip: ClipKind;
+    readonly clipShape: Rectangle | Geometry | null;
+    readonly maskSource: MaskSource;
+    readonly cacheAsBitmap: boolean;
+    readonly blendMode: BlendModes;
+}
+/** @internal */
+export interface DrawScopeEntry {
+    readonly kind: RenderEntryKind.Draw;
+    readonly seq: number;
+    readonly zIndex: number;
+    readonly command: DrawCommand;
+}
+/** @internal */
+export interface GroupScopeEntry {
+    readonly kind: RenderEntryKind.Group;
+    readonly seq: number;
+    readonly zIndex: number;
+    readonly scope: GroupScope;
+}
+/** @internal */
+export interface BarrierScopeEntry {
+    readonly kind: RenderEntryKind.Barrier;
+    readonly seq: number;
+    readonly zIndex: number;
+    readonly scope: BarrierScope;
+}
+/** @internal */
+export type ScopeEntry = DrawScopeEntry | GroupScopeEntry | BarrierScopeEntry;
+/** @internal */
+export interface GroupScope {
+    readonly kind: RenderEntryKind.Group;
+    entries: ScopeEntry[];
+    hasMixedZ: boolean;
+    preserveDrawOrder: boolean;
+}
+/** @internal */
+export interface BarrierScope {
+    readonly kind: RenderEntryKind.Barrier;
+    readonly node: RenderNode;
+    readonly effect: EffectDescriptor;
+    childPlan: GroupScope | null;
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/** @internal */
+export type RenderScope = GroupScope | BarrierScope;