manim-web 0.2.0

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

@@ -0,0 +1,86 @@
+import { Surface3D, Surface3DOptions } from './Surface3D';
+/**
+ * Options for creating a ParametricSurface
+ * (Alias for Surface3DOptions for compatibility)
+ */
+export type ParametricSurfaceOptions = Surface3DOptions;
+/**
+ * ParametricSurface - Alias for Surface3D
+ *
+ * This class is provided for compatibility and naming consistency
+ * with Manim's ParametricSurface class. It is functionally identical
+ * to Surface3D.
+ *
+ * @example
+ * ```typescript
+ * // Create a mobius strip
+ * const mobius = new ParametricSurface({
+ *   func: (u, v) => {
+ *     const theta = u * 2 * Math.PI;
+ *     const w = 2 * v - 1;
+ *     return [
+ *       (1 + w / 2 * Math.cos(theta / 2)) * Math.cos(theta),
+ *       (1 + w / 2 * Math.cos(theta / 2)) * Math.sin(theta),
+ *       w / 2 * Math.sin(theta / 2)
+ *     ];
+ *   },
+ *   uRange: [0, 1],
+ *   vRange: [0, 1],
+ *   uResolution: 64,
+ *   vResolution: 16
+ * });
+ *
+ * // Create a Klein bottle segment
+ * const klein = new ParametricSurface({
+ *   func: (u, v) => {
+ *     const a = 2;
+ *     const theta = u * Math.PI * 2;
+ *     const phi = v * Math.PI * 2;
+ *     const r = a * (1 - Math.cos(theta) / 2);
+ *     return [
+ *       r * Math.cos(theta),
+ *       r * Math.sin(theta),
+ *       Math.sin(phi)
+ *     ];
+ *   }
+ * });
+ * ```
+ */
+export declare class ParametricSurface extends Surface3D {
+    constructor(options: ParametricSurfaceOptions);
+    /**
+     * Create a copy of this ParametricSurface
+     */
+    protected _createCopy(): ParametricSurface;
+}
+/**
+ * Helper function to create common parametric surfaces
+ */
+export declare const SurfacePresets: {
+    /**
+     * Create a sphere surface
+     */
+    sphere(radius?: number, options?: Partial<Omit<Surface3DOptions, "func">>): ParametricSurface;
+    /**
+     * Create a torus surface
+     */
+    torus(majorRadius?: number, minorRadius?: number, options?: Partial<Omit<Surface3DOptions, "func">>): ParametricSurface;
+    /**
+     * Create a mobius strip surface
+     */
+    mobiusStrip(radius?: number, width?: number, options?: Partial<Omit<Surface3DOptions, "func">>): ParametricSurface;
+    /**
+     * Create a paraboloid surface
+     */
+    paraboloid(scale?: number, options?: Partial<Omit<Surface3DOptions, "func">>): ParametricSurface;
+    /**
+     * Create a saddle surface (hyperbolic paraboloid)
+     */
+    saddle(scale?: number, options?: Partial<Omit<Surface3DOptions, "func">>): ParametricSurface;
+    /**
+     * Create a helicoid surface
+     */
+    helicoid(radius?: number, pitch?: number, options?: Partial<Omit<Surface3DOptions, "func">>): ParametricSurface;
+};
+export default ParametricSurface;
+//# sourceMappingURL=ParametricSurface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ParametricSurface.d.ts","sourceRoot":"","sources":["../../../src/mobjects/three-d/ParametricSurface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG1D;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;gBAClC,OAAO,EAAE,wBAAwB;IAI7C;;OAEG;cACgB,WAAW,IAAI,iBAAiB;CAcpD;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;OAEG;oBACY,MAAM,YAAe,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,GAAQ,iBAAiB;IAepG;;OAEG;wBACgB,MAAM,gBAAmB,MAAM,YAAiB,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,GAAQ,iBAAiB;IAenI;;OAEG;yBACiB,MAAM,UAAa,MAAM,YAAiB,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,GAAQ,iBAAiB;IAiB9H;;OAEG;uBACe,MAAM,YAAe,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,GAAQ,iBAAiB;IAWvG;;OAEG;mBACW,MAAM,YAAe,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,GAAQ,iBAAiB;IAWnG;;OAEG;sBACc,MAAM,UAAa,MAAM,YAAiB,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,GAAQ,iBAAiB;CAgB5H,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

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

@@ -0,0 +1,271 @@
+import { Mobject, Vector3Tuple } from '../../core/Mobject';
+import * as THREE from 'three';
+/**
+ * Base options for all polyhedra
+ */
+export interface PolyhedronOptions {
+    /** Side length of the polyhedron. Default: 1 */
+    sideLength?: number;
+    /** Center position [x, y, z]. Default: [0, 0, 0] */
+    center?: Vector3Tuple;
+    /** Color as CSS color string. Default: '#ffffff' */
+    color?: string;
+    /** Opacity from 0 to 1. Default: 1 */
+    opacity?: number;
+    /** Whether to render as wireframe. Default: false */
+    wireframe?: boolean;
+    /** Level of detail (subdivision level). Default: 0 */
+    detail?: number;
+}
+/**
+ * Polyhedron - Base class for all platonic solids
+ *
+ * Provides common functionality for polyhedra including side length,
+ * wireframe mode, and material properties.
+ *
+ * @example
+ * ```typescript
+ * // Subclasses should be used directly:
+ * const tetra = new Tetrahedron({ sideLength: 2, color: '#ff0000' });
+ * ```
+ */
+export declare abstract class Polyhedron extends Mobject {
+    protected _sideLength: number;
+    protected _wireframe: boolean;
+    protected _centerPoint: Vector3Tuple;
+    protected _detail: number;
+    constructor(options?: PolyhedronOptions);
+    /**
+     * Get the radius for Three.js geometry based on side length.
+     * Subclasses override this to provide correct conversion.
+     */
+    protected abstract _getRadiusFromSideLength(): number;
+    /**
+     * Create the Three.js geometry for this polyhedron.
+     * Subclasses must implement this.
+     */
+    protected abstract _createGeometry(): THREE.BufferGeometry;
+    /**
+     * Create the Three.js mesh
+     */
+    protected _createThreeObject(): THREE.Object3D;
+    /**
+     * Sync material properties to Three.js object
+     */
+    protected _syncMaterialToThree(): void;
+    /**
+     * Update the geometry with current dimensions
+     */
+    protected _updateGeometry(): void;
+    /**
+     * Get the side length
+     */
+    getSideLength(): number;
+    /**
+     * Set the side length
+     */
+    setSideLength(value: number): this;
+    /**
+     * Get whether wireframe mode is enabled
+     */
+    isWireframe(): boolean;
+    /**
+     * Set wireframe mode
+     */
+    setWireframe(value: boolean): this;
+    /**
+     * Get the detail level
+     */
+    getDetail(): number;
+    /**
+     * Set the detail level (subdivision)
+     */
+    setDetail(value: number): this;
+    /**
+     * Get the number of faces for this polyhedron
+     */
+    abstract getFaceCount(): number;
+    /**
+     * Get the number of vertices for this polyhedron
+     */
+    abstract getVertexCount(): number;
+    /**
+     * Get the number of edges for this polyhedron
+     */
+    abstract getEdgeCount(): number;
+}
+/**
+ * Options for creating a Tetrahedron
+ */
+export interface TetrahedronOptions extends PolyhedronOptions {
+}
+/**
+ * Tetrahedron - A 4-faced triangular pyramid (platonic solid)
+ *
+ * Creates a tetrahedron using Three.js TetrahedronGeometry with configurable
+ * size and material properties.
+ *
+ * @example
+ * ```typescript
+ * // Create a unit tetrahedron
+ * const tetra = new Tetrahedron();
+ *
+ * // Create a red tetrahedron with side length 2
+ * const redTetra = new Tetrahedron({ sideLength: 2, color: '#ff0000' });
+ *
+ * // Create a wireframe tetrahedron
+ * const wireframe = new Tetrahedron({ sideLength: 1.5, wireframe: true });
+ * ```
+ */
+export declare class Tetrahedron extends Polyhedron {
+    /**
+     * Convert side length to circumradius for Three.js TetrahedronGeometry.
+     * For a tetrahedron: circumradius = sideLength * sqrt(6) / 4
+     */
+    protected _getRadiusFromSideLength(): number;
+    protected _createGeometry(): THREE.BufferGeometry;
+    getFaceCount(): number;
+    getVertexCount(): number;
+    getEdgeCount(): number;
+    /**
+     * Get the surface area of the tetrahedron
+     */
+    getSurfaceArea(): number;
+    /**
+     * Get the volume of the tetrahedron
+     */
+    getVolume(): number;
+    protected _createCopy(): Tetrahedron;
+}
+/**
+ * Options for creating an Octahedron
+ */
+export interface OctahedronOptions extends PolyhedronOptions {
+}
+/**
+ * Octahedron - An 8-faced polyhedron (platonic solid)
+ *
+ * Creates an octahedron using Three.js OctahedronGeometry with configurable
+ * size and material properties. Essentially two square pyramids base-to-base.
+ *
+ * @example
+ * ```typescript
+ * // Create a unit octahedron
+ * const octa = new Octahedron();
+ *
+ * // Create a blue octahedron with side length 2
+ * const blueOcta = new Octahedron({ sideLength: 2, color: '#0000ff' });
+ *
+ * // Create a semi-transparent octahedron
+ * const transparent = new Octahedron({ sideLength: 1.5, opacity: 0.5 });
+ * ```
+ */
+export declare class Octahedron extends Polyhedron {
+    /**
+     * Convert side length to circumradius for Three.js OctahedronGeometry.
+     * For an octahedron: circumradius = sideLength / sqrt(2)
+     */
+    protected _getRadiusFromSideLength(): number;
+    protected _createGeometry(): THREE.BufferGeometry;
+    getFaceCount(): number;
+    getVertexCount(): number;
+    getEdgeCount(): number;
+    /**
+     * Get the surface area of the octahedron
+     */
+    getSurfaceArea(): number;
+    /**
+     * Get the volume of the octahedron
+     */
+    getVolume(): number;
+    protected _createCopy(): Octahedron;
+}
+/**
+ * Options for creating an Icosahedron
+ */
+export interface IcosahedronOptions extends PolyhedronOptions {
+}
+/**
+ * Icosahedron - A 20-faced polyhedron (platonic solid)
+ *
+ * Creates an icosahedron using Three.js IcosahedronGeometry with configurable
+ * size and material properties. All faces are equilateral triangles.
+ *
+ * @example
+ * ```typescript
+ * // Create a unit icosahedron
+ * const icosa = new Icosahedron();
+ *
+ * // Create a green icosahedron with side length 2
+ * const greenIcosa = new Icosahedron({ sideLength: 2, color: '#00ff00' });
+ *
+ * // Create a subdivided icosahedron (closer to a sphere)
+ * const smooth = new Icosahedron({ sideLength: 1, detail: 2 });
+ * ```
+ */
+export declare class Icosahedron extends Polyhedron {
+    /**
+     * Convert side length to circumradius for Three.js IcosahedronGeometry.
+     * For an icosahedron: circumradius = sideLength * sqrt(10 + 2*sqrt(5)) / 4
+     */
+    protected _getRadiusFromSideLength(): number;
+    protected _createGeometry(): THREE.BufferGeometry;
+    getFaceCount(): number;
+    getVertexCount(): number;
+    getEdgeCount(): number;
+    /**
+     * Get the surface area of the icosahedron
+     */
+    getSurfaceArea(): number;
+    /**
+     * Get the volume of the icosahedron
+     */
+    getVolume(): number;
+    protected _createCopy(): Icosahedron;
+}
+/**
+ * Options for creating a Dodecahedron
+ */
+export interface DodecahedronOptions extends PolyhedronOptions {
+}
+/**
+ * Dodecahedron - A 12-faced polyhedron (platonic solid)
+ *
+ * Creates a dodecahedron using Three.js DodecahedronGeometry with configurable
+ * size and material properties. All faces are regular pentagons.
+ *
+ * @example
+ * ```typescript
+ * // Create a unit dodecahedron
+ * const dodeca = new Dodecahedron();
+ *
+ * // Create a purple dodecahedron with side length 2
+ * const purpleDodeca = new Dodecahedron({ sideLength: 2, color: '#800080' });
+ *
+ * // Create a wireframe dodecahedron
+ * const wireframe = new Dodecahedron({ sideLength: 1.5, wireframe: true });
+ * ```
+ */
+export declare class Dodecahedron extends Polyhedron {
+    /**
+     * Convert side length to circumradius for Three.js DodecahedronGeometry.
+     * For a dodecahedron: circumradius = sideLength * phi * sqrt(3) / 2
+     * where phi = (1 + sqrt(5)) / 2 (golden ratio)
+     */
+    protected _getRadiusFromSideLength(): number;
+    protected _createGeometry(): THREE.BufferGeometry;
+    getFaceCount(): number;
+    getVertexCount(): number;
+    getEdgeCount(): number;
+    /**
+     * Get the surface area of the dodecahedron
+     */
+    getSurfaceArea(): number;
+    /**
+     * Get the volume of the dodecahedron
+     */
+    getVolume(): number;
+    protected _createCopy(): Dodecahedron;
+}
+export default Polyhedron;
+//# sourceMappingURL=Polyhedra.d.ts.map

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

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

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

@@ -0,0 +1,100 @@
+import { Mobject, Vector3Tuple } from '../../core/Mobject';
+import * as THREE from 'three';
+/**
+ * Options for creating a Sphere
+ */
+export interface SphereOptions {
+    /** Radius of the sphere. Default: 1 */
+    radius?: number;
+    /** Center position [x, y, z]. Default: [0, 0, 0] */
+    center?: Vector3Tuple;
+    /** Color as CSS color string. Default: '#ffffff' */
+    color?: string;
+    /** Opacity from 0 to 1. Default: 1 */
+    opacity?: number;
+    /** Number of segments for sphere geometry. Default: 32 */
+    resolution?: number;
+    /** Whether to render as wireframe. Default: false */
+    wireframe?: boolean;
+}
+/**
+ * Sphere - A 3D spherical mesh
+ *
+ * Creates a sphere using Three.js SphereGeometry with configurable
+ * radius, resolution, and material properties.
+ *
+ * @example
+ * ```typescript
+ * // Create a unit sphere
+ * const sphere = new Sphere();
+ *
+ * // Create a red sphere with radius 2
+ * const redSphere = new Sphere({ radius: 2, color: '#ff0000' });
+ *
+ * // Create a semi-transparent wireframe sphere
+ * const wireframe = new Sphere({
+ *   radius: 1.5,
+ *   wireframe: true,
+ *   opacity: 0.7
+ * });
+ * ```
+ */
+export declare class Sphere extends Mobject {
+    private _radius;
+    private _resolution;
+    private _wireframe;
+    private _centerPoint;
+    constructor(options?: SphereOptions);
+    /**
+     * Create the Three.js sphere mesh
+     */
+    protected _createThreeObject(): THREE.Object3D;
+    /**
+     * Sync material properties to Three.js object
+     */
+    protected _syncMaterialToThree(): void;
+    /**
+     * Get the radius
+     */
+    getRadius(): number;
+    /**
+     * Set the radius
+     */
+    setRadius(value: number): this;
+    /**
+     * Get the resolution (number of segments)
+     */
+    getResolution(): number;
+    /**
+     * Set the resolution
+     */
+    setResolution(value: number): this;
+    /**
+     * Get whether wireframe mode is enabled
+     */
+    isWireframe(): boolean;
+    /**
+     * Set wireframe mode
+     */
+    setWireframe(value: boolean): this;
+    /**
+     * Get the surface area of the sphere
+     */
+    getSurfaceArea(): number;
+    /**
+     * Get the volume of the sphere
+     */
+    getVolume(): number;
+    /**
+     * Get a point on the sphere at given spherical coordinates
+     * @param theta Azimuthal angle (0 to 2*PI)
+     * @param phi Polar angle (0 to PI)
+     */
+    pointAtAngles(theta: number, phi: number): Vector3Tuple;
+    /**
+     * Create a copy of this Sphere
+     */
+    protected _createCopy(): Sphere;
+}
+export default Sphere;
+//# sourceMappingURL=Sphere.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Sphere.d.ts","sourceRoot":"","sources":["../../../src/mobjects/three-d/Sphere.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,MAAO,SAAQ,OAAO;IACjC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,YAAY,CAAe;gBAEvB,OAAO,GAAE,aAAkB;IAyBvC;;OAEG;IACH,SAAS,CAAC,kBAAkB,IAAI,KAAK,CAAC,QAAQ;IAmB9C;;OAEG;cACgB,oBAAoB,IAAI,IAAI;IAa/C;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAe9B;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAclC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAMlC;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY;IAWvD;;OAEG;cACgB,WAAW,IAAI,MAAM;CAUzC;AAED,eAAe,MAAM,CAAC"}

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

@@ -0,0 +1,156 @@
+import { Mobject, Vector3Tuple } from '../../core/Mobject';
+import * as THREE from 'three';
+/**
+ * Options for creating a Surface3D
+ */
+export interface Surface3DOptions {
+    /** Parametric function (u, v) => [x, y, z] */
+    func: (u: number, v: number) => Vector3Tuple;
+    /** U parameter range [min, max]. Default: [0, 1] */
+    uRange?: [number, number];
+    /** V parameter range [min, max]. Default: [0, 1] */
+    vRange?: [number, number];
+    /** Number of segments in U direction. Default: 32 */
+    uResolution?: number;
+    /** Number of segments in V direction. Default: 32 */
+    vResolution?: number;
+    /** Center position [x, y, z]. Default: [0, 0, 0] */
+    center?: Vector3Tuple;
+    /** Color as CSS color string. Default: '#ffffff' */
+    color?: string;
+    /** Opacity from 0 to 1. Default: 1 */
+    opacity?: number;
+    /** Whether to render as wireframe. Default: false */
+    wireframe?: boolean;
+    /** Whether to render both sides. Default: true */
+    doubleSided?: boolean;
+    /** Two alternating colors for a checkerboard pattern on the surface, e.g. ['#E65A4C', '#CF5044']. */
+    checkerboardColors?: [string, string];
+}
+/**
+ * Surface3D - A parametric 3D surface
+ *
+ * Creates a parametric surface using Three.js ParametricGeometry.
+ * The surface is defined by a function that maps (u, v) parameters
+ * to 3D points.
+ *
+ * @example
+ * ```typescript
+ * // Create a paraboloid
+ * const paraboloid = new Surface3D({
+ *   func: (u, v) => {
+ *     const x = u * 2 - 1;
+ *     const y = v * 2 - 1;
+ *     const z = x * x + y * y;
+ *     return [x, y, z];
+ *   },
+ *   uRange: [0, 1],
+ *   vRange: [0, 1]
+ * });
+ *
+ * // Create a sphere using parametric equations
+ * const sphere = new Surface3D({
+ *   func: (u, v) => {
+ *     const theta = u * Math.PI * 2;
+ *     const phi = v * Math.PI;
+ *     return [
+ *       Math.sin(phi) * Math.cos(theta),
+ *       Math.sin(phi) * Math.sin(theta),
+ *       Math.cos(phi)
+ *     ];
+ *   }
+ * });
+ * ```
+ */
+export declare class Surface3D extends Mobject {
+    protected _func: (u: number, v: number) => Vector3Tuple;
+    protected _uRange: [number, number];
+    protected _vRange: [number, number];
+    protected _uResolution: number;
+    protected _vResolution: number;
+    protected _wireframe: boolean;
+    protected _doubleSided: boolean;
+    protected _centerPoint: Vector3Tuple;
+    protected _checkerboardColors?: [string, string];
+    constructor(options: Surface3DOptions);
+    /**
+     * Create the Three.js parametric surface mesh
+     */
+    protected _createThreeObject(): THREE.Object3D;
+    /**
+     * Sync material properties to Three.js object
+     */
+    protected _syncMaterialToThree(): void;
+    /**
+     * Update the geometry with current function and parameters
+     */
+    protected _updateGeometry(): void;
+    /**
+     * Get the parametric function
+     */
+    getFunc(): (u: number, v: number) => Vector3Tuple;
+    /**
+     * Set the parametric function
+     */
+    setFunc(func: (u: number, v: number) => Vector3Tuple): this;
+    /**
+     * Get the U parameter range
+     */
+    getURange(): [number, number];
+    /**
+     * Set the U parameter range
+     */
+    setURange(range: [number, number]): this;
+    /**
+     * Get the V parameter range
+     */
+    getVRange(): [number, number];
+    /**
+     * Set the V parameter range
+     */
+    setVRange(range: [number, number]): this;
+    /**
+     * Get the U resolution
+     */
+    getUResolution(): number;
+    /**
+     * Set the U resolution
+     */
+    setUResolution(value: number): this;
+    /**
+     * Get the V resolution
+     */
+    getVResolution(): number;
+    /**
+     * Set the V resolution
+     */
+    setVResolution(value: number): this;
+    /**
+     * Get whether wireframe mode is enabled
+     */
+    isWireframe(): boolean;
+    /**
+     * Set wireframe mode
+     */
+    setWireframe(value: boolean): this;
+    /**
+     * Get whether double-sided rendering is enabled
+     */
+    isDoubleSided(): boolean;
+    /**
+     * Set double-sided rendering
+     */
+    setDoubleSided(value: boolean): this;
+    /**
+     * Evaluate the surface at given parameters
+     * @param u U parameter
+     * @param v V parameter
+     */
+    evaluate(u: number, v: number): Vector3Tuple;
+    /**
+     * Create a copy of this Surface3D
+     */
+    protected _createCopy(): Surface3D;
+}
+export default Surface3D;
+//# sourceMappingURL=Surface3D.d.ts.map

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

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