@3driseai/3drise-core 1.0.1

package/dist/utils/pathUtils.js

@@ -0,0 +1,73 @@
+import * as THREE from 'three';
+export const createCurves = (paths, pointsPaths) => {
+    const curves = [];
+    if (paths && paths.length > 0) {
+        paths.forEach((path) => {
+            const points = [];
+            for (let i = 0; i < path.length; i += 3) {
+                points.push(new THREE.Vector3(path[i], path[i + 1], path[i + 2]));
+            }
+            curves.push(new THREE.CatmullRomCurve3(points));
+        });
+    }
+    else if (pointsPaths && pointsPaths.length > 0) {
+        pointsPaths.forEach((points) => {
+            curves.push(new THREE.CatmullRomCurve3(points));
+        });
+    }
+    return curves;
+};
+export const randomRange = (min, max) => Math.random() * (max - min) + min;
+/**
+ * Smooths corners by adding interpolated points around each corner using quadratic bezier curves.
+ * smoothness 0-100: 0 = sharp corners, 100 = maximum rounding
+ */
+export const smoothPathCorners = (points, smoothness) => {
+    if (points.length < 3 || smoothness <= 0)
+        return points;
+    const result = [];
+    const cutRatio = (smoothness / 100) * 0.4;
+    result.push(points[0]);
+    for (let i = 1; i < points.length - 1; i++) {
+        const prev = new THREE.Vector3(...points[i - 1]);
+        const curr = new THREE.Vector3(...points[i]);
+        const next = new THREE.Vector3(...points[i + 1]);
+        const distPrev = curr.distanceTo(prev);
+        const distNext = curr.distanceTo(next);
+        const cut = Math.min(distPrev * cutRatio, distNext * cutRatio);
+        const dirToPrev = new THREE.Vector3().subVectors(prev, curr).normalize();
+        const dirToNext = new THREE.Vector3().subVectors(next, curr).normalize();
+        const beforeCorner = new THREE.Vector3().copy(curr).addScaledVector(dirToPrev, cut);
+        const afterCorner = new THREE.Vector3().copy(curr).addScaledVector(dirToNext, cut);
+        const numArcPoints = Math.max(3, Math.floor(smoothness / 10));
+        for (let j = 0; j <= numArcPoints; j++) {
+            const t = j / numArcPoints;
+            const u = 1 - t;
+            result.push([
+                u * u * beforeCorner.x + 2 * u * t * curr.x + t * t * afterCorner.x,
+                u * u * beforeCorner.y + 2 * u * t * curr.y + t * t * afterCorner.y,
+                u * u * beforeCorner.z + 2 * u * t * curr.z + t * t * afterCorner.z,
+            ]);
+        }
+    }
+    result.push(points[points.length - 1]);
+    return result;
+};
+/**
+ * Creates a CatmullRomCurve3 spline from points.
+ * curve 1-100: 1 = sharp/tight, 100 = smoothest
+ */
+export const createPathSpline = (points, curve) => {
+    if (points.length < 2)
+        return null;
+    const threePoints = points.map(p => new THREE.Vector3(p[0], p[1], p[2]));
+    const tension = curve > 1 ? 0.5 - ((curve - 1) / 99) * 0.5 : 0.5;
+    return new THREE.CatmullRomCurve3(threePoints, false, 'catmullrom', tension);
+};
+/**
+ * Samples evenly-spaced points along a spline for rendering.
+ */
+export const sampleSplinePoints = (spline, numPoints) => {
+    const divisions = Math.max(numPoints * 10, 50);
+    return spline.getPoints(divisions).map(p => [p.x, p.y, p.z]);
+};

package/dist/utils/positionsCreatorUtils.d.ts

@@ -0,0 +1,97 @@
+import type { ShapeConfig, ShapeParams } from "../types/particles";
+import type { Vector3Array } from "../types/scene3d";
+type PointWriter = ReturnType<typeof createPointWriter>;
+/** Write a single xyz point into a flat [x,y,z, x,y,z, ...] buffer. */
+export declare function setPoint(data: Float32Array, particleIndex: number, x: number, y: number, z: number): void;
+/**
+ * Sequential writer into a flat position buffer. Tracks the running particle
+ * index and silently ignores writes past `total`, so generators can emit
+ * "up to N" points without repeating bounds checks everywhere.
+ */
+export declare function createPointWriter(data: Float32Array, total: number): {
+    add(x: number, y: number, z: number): void;
+    /** Sample `count` evenly-spaced points along the segment A->B (inclusive). */
+    addSegment(ax: number, ay: number, az: number, bx: number, by: number, bz: number, count: number, skipFirst?: boolean): void;
+    readonly count: number;
+    readonly done: boolean;
+};
+/**
+ * Golden-angle ("Fibonacci sphere") point for an even distribution of `count`
+ * points over a sphere surface of the given radius. Shared by the sphere
+ * surface and the sphere-shell volume fill.
+ */
+export declare function fibonacciSpherePoint(i: number, count: number, radius: number): [number, number, number];
+/**
+ * Center a set of paths on the origin and uniformly scale them so their
+ * longest axis equals `targetSize` (default 1 → unit cube, coords in
+ * -0.5..0.5), preserving aspect ratio. Used to normalize the static
+ * coordinate arrays (brain/dna/helix3d/circles) that have no scale param.
+ */
+export declare function centerPathsToUnit(paths: number[][], targetSize?: number): number[][];
+/**
+ * Fill a disk of the given radius with concentric rings, writing up to the
+ * writer's remaining capacity. `place(x, y)` maps a 2D ring coordinate onto
+ * the target plane (XY for a circle, XZ at a fixed height for a cylinder layer).
+ */
+export declare function fillRings(writer: PointWriter, radius: number, ringBudget: number, place: (x: number, y: number) => [number, number, number]): void;
+/**
+ * Generate positions for a square shape - evenly scattered on x and y axis.
+ * Defaults (width = height = 1) span -0.5..0.5.
+ * @param width - Width of the square (x-axis)
+ * @param height - Height of the square (y-axis)
+ * @param length - Number of particles to generate
+ * @param outlines - If true, positions particles only on the outer edges
+ * @returns Float32Array with particle positions (x, y, z format, 3 values per particle)
+ */
+export declare function generateSquarePositions(width: number, height: number, length: number, outlines: boolean): Float32Array;
+/**
+ * Generate positions for a box shape - evenly distributed in 3D space
+ * Following the pattern from generateLinePositions for correct position distribution
+ * @param meshSize - Size of the box [width, height, depth]
+ * @param length - Number of particles to generate
+ * @param outlines - If true, positions particles only on the edges; if false, fills the volume
+ * @returns Float32Array with particle positions (x, y, z format, 3 values per particle)
+ */
+export declare function generateBoxPositions(meshSize: Vector3Array, length: number, outlines: boolean): Float32Array;
+export declare function generateLinePositions(start: [number, number, number], end: [number, number, number], length: number): Float32Array;
+/**
+ * Generate positions for a triangle shape - evenly distributed
+ * Following the pattern from generateLinePositions for correct position distribution
+ * @param size - Size of the triangle (distance from center to vortex)
+ * @param length - Number of particles to generate
+ * @param outlines - If true, positions particles only on the edges; if false, fills the triangle
+ * @returns Float32Array with particle positions (x, y, z format, 3 values per particle)
+ */
+export declare function generateTrianglePositions(size: number, length: number, outlines: boolean): Float32Array;
+/**
+ * Generate positions for a circle shape - evenly distributed
+ * Following the pattern from generateLinePositions for correct position distribution
+ * @param radius - Radius of the circle
+ * @param length - Number of particles to generate
+ * @param outlines - If true, positions particles only on the circle perimeter; if false, fills the circle
+ * @returns Float32Array with particle positions (x, y, z format, 3 values per particle)
+ */
+export declare function generateCirclePositions(radius: number, length: number, outlines: boolean): Float32Array;
+/**
+ * Generate positions for a sphere shape - evenly distributed
+ * Following the pattern from generateLinePositions for correct position distribution
+ * @param radius - Radius of the sphere
+ * @param length - Number of particles to generate
+ * @param outlines - If true, positions particles only on the sphere surface; if false, fills the volume
+ * @returns Float32Array with particle positions (x, y, z format, 3 values per particle)
+ */
+export declare function generateSpherePositions(radius: number, length: number, outlines: boolean): Float32Array;
+/**
+ * Generate positions for a cylinder shape - evenly distributed
+ * Following the pattern from generateLinePositions for correct position distribution
+ * @param radius - Radius of the cylinder
+ * @param height - Height of the cylinder
+ * @param length - Number of particles to generate
+ * @param outlines - If true, positions particles only on the edges (top/bottom circles and vertical edges); if false, fills the volume
+ * @returns Float32Array with particle positions (x, y, z format, 3 values per particle)
+ */
+export declare function generateCylinderPositions(radius: number, height: number, length: number, outlines: boolean): Float32Array;
+export declare const calculateCirclePositions: (count: number, sep: number) => Float32Array<ArrayBuffer>;
+export declare function generateTextPositions(shapeParams: ShapeParams, config: ShapeConfig['text']): Float32Array;
+export {};
+//# sourceMappingURL=positionsCreatorUtils.d.ts.map

package/dist/utils/positionsCreatorUtils.d.ts.map

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