ActDim.Three 1.0.10

ActDim.Three

ActDim.Three is a high-performance 3D graphics math, geometry, scene graph, and serialization library for .NET inspired by standard three.js data structures and workflows.

Features

• Linear Algebra & 3D Math Primitives: High-performance 3D math types (Vector3, Matrix4, Euler, Quaternion, Color).
• Scene Graph Hierarchy: Scene, Element, BufferGeometry, Camera (PerspectiveCamera, OrthographicCamera), and Lights (AmbientLight, DirectionalLight, PointLight, SpotLight, HemisphereLight, RectAreaLight).
• Standard Materials: MeshBasicMaterial, MeshStandardMaterial, MeshPhongMaterial, MeshLambertMaterial, LineBasicMaterial, PointsMaterial.
• High-Performance Typed Arrays: Direct primitive buffer abstractions (Float32Array, Float64Array, Int32Array, Uint8Array, Uint8ClampedArray).
• Native System.Text.Json Serialization: Native high-speed ThreeSerializer utilizing System.Text.Json (STJ) and zero-allocation UTF-8 byte stream / string operations with typed primitive arrays for maximum throughput.
• Decoupled Architecture: Core library has zero external dependencies on legacy serialization engines.

Feature Support & Roadmap Status

The table below outlines current component support in ActDim.Three and planned features on our roadmap for Three.js JSON Object/Scene Format v4 compatibility:

Performance & System.Text.Json

ActDim.Three uses System.Text.Json natively for scene and geometry serialization.

• Typed Array Optimization: Numeric vertex, normal, and UV buffer data (Float32Array, Uint32Array, etc.) are written directly to/from UTF-8 byte streams without per-element object boxing (object[]) or intermediate string conversions.
• High Throughput: System.Text.Json provides significantly higher serialization and deserialization speeds compared to traditional reflections-heavy wrappers.

Installation

Install via the .NET CLI:

dotnet add package ActDim.Three

Or via Package Manager Console:

Install-Package ActDim.Three

Quick Start Examples

1. Scene & Camera Setup

using ActDim.Three.Cameras;
using ActDim.Three.Core;
using ActDim.Three.Geometries;
using ActDim.Three.Lights;
using ActDim.Three.Materials;
using ActDim.Three.Math;
using ActDim.Three.Scenes;

// Create 3D scene
var scene = new Scene();

// Add ambient light and directional light
var ambientLight = new AmbientLight(new Color(0x404040));
scene.Add(ambientLight);

var dirLight = new DirectionalLight(new Color(0xffffff), 1.0f);
dirLight.Position.Set(5, 10, 7.5f);
scene.Add(dirLight);

// Create perspective camera
var camera = new PerspectiveCamera(75.0f, 16.0f / 9.0f, 0.1f, 1000.0f);
camera.Position.Set(0, 0, 5);

2. Scene Graph Serialization (System.Text.Json)

using ActDim.Three;
using ActDim.Three.Scenes;

var scene = new Scene();
// ... configure scene geometry & materials ...

// Serialize 3D scene document to JSON string using native STJ engine
string jsonString = ThreeSerializer.ToJson(scene.ToSceneDocument());

// Deserialize 3D scene document from JSON string
SceneDocument doc = ThreeSerializer.FromJson<SceneDocument>(jsonString);

Testing & Quality

• Test Suite: ActDim.Three.Tests
• Total Tests: 39 passed (100% success rate, 0 failed, 0 skipped)
• Target Framework: .NET 10.0

dotnet test Tests/Three.Tests/ActDim.Three.Tests.csproj

License

This project is licensed under the MIT License.