manim-web 0.3.24 → 0.11.0

package/dist/mobjects/three-d/ThreeDAxes.d.ts

@@ -12,6 +12,22 @@ export interface ThreeDAxesOptions {
     yRange?: [number, number, number];
     /** Z-axis range as [min, max, step]. Default: [-4, 4, 1] */
     zRange?: [number, number, number];
+    /**
+     * Visual length of the x-axis in scene units, independent of xRange.
+     * When omitted, defaults to the x-range span (xMax - xMin), so the axis
+     * keeps a 1:1 range-to-visual mapping (unchanged default behavior).
+     */
+    xLength?: number;
+    /**
+     * Visual length of the y-axis in scene units, independent of yRange.
+     * When omitted, defaults to the y-range span (yMax - yMin).
+     */
+    yLength?: number;
+    /**
+     * Visual length of the z-axis in scene units, independent of zRange.
+     * When omitted, defaults to the z-range span (zMax - zMin).
+     */
+    zLength?: number;
     /** Default color for all axes. Default: '#ffffff' */
     axisColor?: string;
     /** Color for x-axis (overrides axisColor). Default: same as axisColor */
@@ -85,6 +101,12 @@ export declare class ThreeDAxes extends Group {
     private _xRange;
     private _yRange;
     private _zRange;
+    private _xLength;
+    private _yLength;
+    private _zLength;
+    private _xScale;
+    private _yScale;
+    private _zScale;
     private _showTicks;
     private _tickLength;
     private _ticks;
@@ -99,6 +121,12 @@ export declare class ThreeDAxes extends Group {
     private _labelOptions;
     constructor(options?: ThreeDAxesOptions);
     private _initRanges;
+    /**
+     * Resolve each axis visual length and its range-to-visual scale factor.
+     * When a length option is omitted, it defaults to the range span, which
+     * gives scale 1 and keeps the historical 1:1 mapping unchanged.
+     */
+    private _initLengths;
     private _initTickConfig;
     private _initLabelConfig;
     private _resolveAxisColors;
@@ -147,7 +175,9 @@ export declare class ThreeDAxes extends Group {
     private _buildLabel;
     /**
      * Convert graph coordinates to visual point coordinates (scene space).
-     * With unit_size=1, graph coordinates map directly to visual positions.
+     * Each graph coordinate is multiplied by its axis scale (length / span)
+     * before the axes' position offset is applied. With default lengths the
+     * scale is 1, so graph coordinates map directly to visual positions.
      */
     coordsToPoint(x: number, y: number, z: number): Vector3Tuple;
     /**
@@ -187,15 +217,18 @@ export declare class ThreeDAxes extends Group {
      */
     getZRange(): [number, number, number];
     /**
-     * Get the visual X length (range span)
+     * Get the visual X length in scene units. Equals the configured xLength,
+     * or the x-range span when xLength was omitted.
      */
     getXLength(): number;
     /**
-     * Get the visual Y length (range span)
+     * Get the visual Y length in scene units. Equals the configured yLength,
+     * or the y-range span when yLength was omitted.
      */
     getYLength(): number;
     /**
-     * Get the visual Z length (range span)
+     * Get the visual Z length in scene units. Equals the configured zLength,
+     * or the z-range span when zLength was omitted.
      */
     getZLength(): number;
     /**

package/dist/mobjects/three-d/ThreeDAxes.d.ts.map

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

package/dist/mobjects/three-d/threeDVmobUtils.d.ts

@@ -0,0 +1,25 @@
+import { Vector3Tuple } from '../../core/MobjectTypes';
+import { VMobject } from '../../core/VMobject';
+/**
+ * The gradient start and end points, used by the 3D camera to shade a VMobject.
+ * Port of CE `get_3d_vmob_gradient_start_and_end_points`.
+ */
+export declare function get3dVmobGradientStartAndEndPoints(vmob: VMobject): [Vector3Tuple, Vector3Tuple];
+/** Index of the start corner (always 0). Port of CE `get_3d_vmob_start_corner_index`. */
+export declare function get3dVmobStartCornerIndex(_vmob: VMobject): number;
+/** Index of the end corner. Port of CE `get_3d_vmob_end_corner_index`. */
+export declare function get3dVmobEndCornerIndex(vmob: VMobject): number;
+/** The start corner point. Port of CE `get_3d_vmob_start_corner`. */
+export declare function get3dVmobStartCorner(vmob: VMobject): Vector3Tuple;
+/** The end corner point. Port of CE `get_3d_vmob_end_corner`. */
+export declare function get3dVmobEndCorner(vmob: VMobject): Vector3Tuple;
+/**
+ * The unit normal of the VMobject's surface at the given point index.
+ * Port of CE `get_3d_vmob_unit_normal`.
+ */
+export declare function get3dVmobUnitNormal(vmob: VMobject, pointIndex: number): Vector3Tuple;
+/** The unit normal at the start corner. Port of CE `get_3d_vmob_start_corner_unit_normal`. */
+export declare function get3dVmobStartCornerUnitNormal(vmob: VMobject): Vector3Tuple;
+/** The unit normal at the end corner. Port of CE `get_3d_vmob_end_corner_unit_normal`. */
+export declare function get3dVmobEndCornerUnitNormal(vmob: VMobject): Vector3Tuple;
+//# sourceMappingURL=threeDVmobUtils.d.ts.map

package/dist/mobjects/three-d/threeDVmobUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threeDVmobUtils.d.ts","sourceRoot":"","sources":["../../../src/mobjects/three-d/threeDVmobUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAExE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAiBpD;;;GAGG;AACH,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,QAAQ,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC,CAE/F;AAED,yFAAyF;AACzF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAEjE;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAE9D;AAED,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAMjE;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAM/D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CAiBpF;AAED,8FAA8F;AAC9F,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAE3E;AAED,0FAA0F;AAC1F,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAEzE"}

package/dist/mobjects/video/VideoMobject.d.ts

@@ -0,0 +1,126 @@
+import { Vector3Tuple } from '../../core/Mobject';
+import { TexturedMobject } from '../../core/TexturedMobject';
+import * as THREE from 'three';
+/**
+ * Options for creating a VideoMobject.
+ */
+export interface VideoMobjectOptions {
+    /** Video source URL. Required. */
+    src: string;
+    /** Loop playback when it reaches the end. Default: false */
+    loop?: boolean;
+    /** Mute the audio track. Default: true (needed for browser autoplay policies) */
+    muted?: boolean;
+    /** Start playing as soon as data is available. Default: false */
+    autoplay?: boolean;
+    /** Playback speed multiplier (1 = normal). Default: 1 */
+    playbackRate?: number;
+    /** Width of the video in scene units. Default: auto from aspect ratio */
+    width?: number;
+    /** Height of the video in scene units. Default: auto from aspect ratio */
+    height?: number;
+    /** If both width and height given, fit inside the box preserving aspect. Default: true */
+    scaleToFit?: boolean;
+    /** Center position [x, y, z]. Default: [0, 0, 0] */
+    center?: Vector3Tuple;
+    /** Opacity from 0 to 1. Default: 1 */
+    opacity?: number;
+    /** Render both sides of the plane. Default: false */
+    doubleSided?: boolean;
+    /** crossOrigin attribute for the video element. Default: 'anonymous' */
+    crossOrigin?: string | null;
+}
+/**
+ * VideoMobject - display an HTML `<video>` as a movable, scalable mobject.
+ *
+ * The video is drawn onto a `THREE.PlaneGeometry` through a
+ * `THREE.VideoTexture`, mirroring how {@link ImageMobject} draws images. It
+ * therefore participates in the standard mobject transforms (shift, scale,
+ * rotate), z-index/depth, opacity, and `scene.add`.
+ *
+ * Playback follows the DOM video clock during normal play. When the Player
+ * scrubs or seeks, call {@link syncToTime} so the displayed frame follows the
+ * scene time.
+ *
+ * @example
+ * ```typescript
+ * const clip = new VideoMobject({ src: 'intro.mp4', width: 6, loop: true });
+ * scene.add(clip);
+ * await clip.waitForLoad();
+ * clip.play();
+ * ```
+ */
+export declare class VideoMobject extends TexturedMobject {
+    protected _source: string;
+    protected _loop: boolean;
+    protected _muted: boolean;
+    protected _autoplay: boolean;
+    protected _playbackRate: number;
+    protected _width: number | undefined;
+    protected _height: number | undefined;
+    protected _scaleToFit: boolean;
+    protected _centerPoint: Vector3Tuple;
+    protected _doubleSided: boolean;
+    protected _crossOrigin: string | null;
+    protected _video: HTMLVideoElement | null;
+    protected _texture: THREE.VideoTexture | null;
+    protected _videoLoaded: boolean;
+    protected _loadError: Error | null;
+    protected _naturalWidth: number;
+    protected _naturalHeight: number;
+    private _mesh;
+    private _loadPromise;
+    private _loadResolve;
+    private _loadReject;
+    constructor(options: VideoMobjectOptions);
+    /**
+     * Create the DOM video element and its VideoTexture. Node/SSR-safe: when
+     * `document` is missing, the load fails gracefully instead of throwing.
+     */
+    private _createVideo;
+    /** Record a load error and reject the ready promise once. */
+    private _failLoad;
+    /** Promise that resolves on `loadeddata` and rejects on load error. */
+    waitForLoad(): Promise<void>;
+    /** The captured load error, or null when no error occurred. */
+    getLoadError(): Error | null;
+    /** Whether the first frame of video data is available. */
+    isLoaded(): boolean;
+    /** The video source URL. */
+    getSource(): string;
+    /** Start (or resume) playback. Silently ignores autoplay rejections. */
+    play(): this;
+    /** Pause playback. */
+    pause(): this;
+    /** Seek the video to an absolute time in seconds, clamped to [0, duration]. */
+    seek(seconds: number): this;
+    /** Set the playback speed multiplier. */
+    setPlaybackRate(rate: number): this;
+    /** Duration of the video in seconds (NaN until metadata loads). */
+    get duration(): number;
+    /**
+     * Follow the Player clock: show the frame at `sceneTime`. Use this on scrub
+     * and seek so the displayed frame tracks the timeline position.
+     */
+    syncToTime(sceneTime: number): this;
+    /** Clamp a time to [0, duration]; duration may be NaN before metadata loads. */
+    private _clampTime;
+    /** Display dimensions from width/height options and the natural size. */
+    private _calculateDimensions;
+    protected _createThreeObject(): THREE.Object3D;
+    getDisplayMeshLength(): number;
+    getDisplayMeshes(): THREE.Mesh[];
+    applyTextureFrom(other: TexturedMobject): void;
+    applyVisualSize(width: number, height: number): void;
+    applyContentFrom(other: TexturedMobject): void;
+    protected _updateGeometry(): void;
+    protected _syncMaterialToThree(): void;
+    getBoundingBox(): {
+        width: number;
+        height: number;
+        depth: number;
+    };
+    copy(): VideoMobject;
+    dispose(): void;
+}
+//# sourceMappingURL=VideoMobject.d.ts.map

package/dist/mobjects/video/VideoMobject.d.ts.map

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

package/dist/mobjects/video/index.d.ts

@@ -0,0 +1,2 @@
+export { VideoMobject, type VideoMobjectOptions } from './VideoMobject';
+//# sourceMappingURL=index.d.ts.map

package/dist/mobjects/video/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mobjects/video/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}