distark-render 1.1.6 → 1.1.9

package/dist/modules/sceneRenderer.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Scene Renderer — Composites multiple characters onto a background.
+ *
+ * Matches CAM's rendering behavior:
+ *   - 2560×1440 base canvas (characters drawn at world coordinates)
+ *   - Character root = xCoor/yCoor (feet/bottom-center, same as CAM's Body.js cameraOffset trick)
+ *   - Animation interpolation via lerpAngle (shortest-path rotation), not frame snapping
+ *   - Camera viewport maps a region of the 2560×1440 world to the output resolution
+ *   - Background drawn at 0,0,2560,1440
+ *
+ * Performance: SceneEngine loads images once, caches rendered stamps per unique state.
+ */
+import type { RigData } from '../types.js';
+export interface WorldCharacter {
+    id: string;
+    name?: string;
+    xCoor?: number;
+    yCoor?: number;
+    width?: number;
+    height?: number;
+    [key: string]: any;
+}
+export interface WorldKeyframe {
+    time: number;
+    value: any;
+    easing?: string;
+}
+export interface WorldLane {
+    property: string;
+    keyframes: WorldKeyframe[];
+}
+export interface WorldCharacterTrack {
+    characterId: string;
+    lanes: WorldLane[];
+}
+export interface WorldAnimation {
+    id: string;
+    name: string;
+    frames: any[];
+}
+export interface WorldJSON {
+    scene?: {
+        background?: string | null;
+    };
+    characters?: WorldCharacter[];
+    objects?: any[];
+    dialogs?: any[];
+    timeline?: WorldCharacterTrack[];
+    variations?: any[];
+    animations?: Record<string, WorldAnimation>;
+    filename?: string;
+}
+export interface CharacterState {
+    id: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    hidden: boolean;
+    flipX: boolean;
+    animationId: string | null;
+    animationProgress: number;
+    variationName: string | null;
+}
+export interface CameraState {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface SceneState {
+    time: number;
+    camera: CameraState;
+    characters: CharacterState[];
+}
+export interface SceneRenderReport {
+    time: number;
+    output: string;
+    canvas: {
+        width: number;
+        height: number;
+    };
+    camera: CameraState;
+    characters: Array<{
+        id: string;
+        position: {
+            x: number;
+            y: number;
+        };
+        size: {
+            width: number;
+            height: number;
+        };
+        hidden: boolean;
+        flipX: boolean;
+        animationId: string | null;
+        variationName: string | null;
+        screenBounds: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        };
+    }>;
+    quality: {
+        total_characters: number;
+        visible_characters: number;
+        has_camera_move: boolean;
+        has_animation: boolean;
+        has_variation: boolean;
+        has_background: boolean;
+        shot_count: number;
+    };
+}
+export declare function evaluateScene(world: WorldJSON, time: number): SceneState;
+export declare class SceneEngine {
+    private world;
+    private rigDataMap;
+    private createCanvas;
+    private loadImage;
+    private renderers;
+    private bgCache;
+    private resolvedAnims;
+    private ready;
+    private objectImageCache;
+    constructor(world: WorldJSON, rigDataMap: Record<string, RigData>);
+    /** Draw a world-level object (prop) onto the canvas */
+    private drawWorldObject;
+    init(): Promise<void>;
+    /**
+     * Get the interpolated rig data for a character at a given animation progress.
+     * Applies: variation (expression swap) → animation interpolation → flip
+     */
+    private getInterpolatedRig;
+    /**
+     * Render one frame.
+     *
+     * Matches CAM's approach:
+     *   1. Create a 2560×1440 "world canvas"
+     *   2. Draw background at 0,0,2560,1440
+     *   3. For each visible character: compute rig at (xCoor, yCoor) using cameraOffset
+     *   4. Apply camera viewport: copy the camera region from world canvas to output canvas
+     */
+    renderFrame(time: number, outputPath: string, outWidth: number, outHeight: number): Promise<SceneRenderReport>;
+    /**
+     * Render one frame and return the raw canvas (no PNG encode, no file write).
+     * Used by video pipeline to pipe raw pixels to ffmpeg.
+     */
+    renderFrameToCanvas(time: number, outWidth: number, outHeight: number): Promise<any>;
+}
+export declare function renderScene(world: WorldJSON, time: number, outputPath: string, rigDataMap: Record<string, RigData>, options?: {
+    width?: number;
+    height?: number;
+}): Promise<SceneRenderReport>;
+export declare function renderSceneKeyFrames(world: WorldJSON, outputDir: string, rigDataMap: Record<string, RigData>, options?: {
+    width?: number;
+    height?: number;
+    frameCount?: number;
+}): Promise<SceneRenderReport[]>;
+//# sourceMappingURL=sceneRenderer.d.ts.map

package/dist/modules/sceneRenderer.d.ts.map

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