Package limn.render3d

package limn.render3d

Render-to-texture 3D: Graphics3D is both the facade a caller uses inside a frame and the SPI the backend installs, and around it sit the neutral resources a scene is made of: MeshData and TextureData built on any thread, their uploaded twins GpuMesh and GpuTexture, Camera with its controllers, Material, Light, and the RenderPass draws are issued into. A pass renders into a RenderTarget the 2D pipeline composites like any other texture, which is why a 3D viewport is just a widget.

Related Packages

Package	Description
limn.render3d.gltf	glTF 2.0 loading: GltfLoader reads .gltf or binary .glb into a neutral GltfModel of meshes, materials and node transforms (no GPU and no third-party parser), so the reading and decoding can run on a worker (the loadAsync forms are cancellable and report progress) and the upload happens later, inside a frame.
limn.render3d.scene	A retained scene over the imperative pass: Scene3D traverses a Node tree of MeshNodes and LightNodes, composes world transforms, gathers the lights, frustum-culls and issues the same draws a caller could issue by hand.
limn.render3d.shader	A neutral, typed shader IR: a material's surface is a SurfaceOutputs built from Expr nodes, and a backend's code generator walks that DAG to emit its own shading language, so the toolkit ships no GLSL, and a new target means a new generator rather than new materials.

Class	Description
Camera	A perspective camera positioned by eye/target/up.
CameraController	Translates pointer input into camera motion.
ColorSpace	How the channel values of a color or texture are encoded.
DebugDraw	Immediate-mode debug geometry: world-space lines (AABBs, oriented boxes, axes, grids, rays) batched on the CPU and flushed into a RenderPass once per frame.
Environment	An image-based lighting environment as a procedural gradient sky: sky straight up, horizon at the equator, ground straight down, in linear color, scaled by intensity.
FlyController	A first-person "fly" camera: dragging looks around (yaw/pitch about the eye, pitch clamped near the poles) and the wheel flies forward/back along the view direction.
GpuMesh	An opaque handle to mesh geometry uploaded to the GPU (via Graphics3D.upload).
GpuTexture	An opaque handle to a texture uploaded to the GPU (see Graphics3D.uploadTexture).
Graphics3D	Facade + install-at-startup SPI for the 3D backend, the same inversion pattern as Images/Sounds: a neutral entry point here, the GL implementation installed by the backend on startup.
Graphics3D.Provider	Backend-supplied factory + renderer (installed at startup).
IrradianceSh	Order-2 (9-coefficient) spherical-harmonic irradiance baked from an Environment, the diffuse half of image-based lighting (Ramamoorthi & Hanrahan 2001).
Light	An analytic light for the PBR pass, added to a RenderPass with RenderPass.addLight(limn.render3d.Light).
Light.Directional	An infinitely distant light (sun): direction points toward the source.
Light.Point	An omnidirectional light at position with inverse-square falloff.
Light.Spot	A cone light at position aimed along direction (pointing away from the light).
Material	How a surface is shaded.
Material.NormalMap	A tangent-space normal map and how far to lean on it.
Material.Pbr	Metallic-roughness PBR (Cook-Torrance GGX), lit by every Light on the pass plus a flat ambient term.
Material.Raw	Custom GLSL.
Material.SimpleLit	Lambert diffuse from the pass's single directional light, over a base color.
Material.Surface	A surface the application builds itself, out of the same neutral shader IR the built-in materials are generated from, and lit by the same core.
Material.Surface.Texture	A named sampler.
Material.Surface.Value	A named vec4 uniform.
Material.Unlit	A flat/vertex color, unaffected by lights.
MeshData	CPU-side geometry: one float array per VertexAttribute plus a triangle index list.
MeshUsage	How often a mesh's contents change, declared at upload, because a GPU buffer's usage is fixed when it is allocated.
OrbitController	Orbits a Camera around its target: horizontal drag spins the azimuth, vertical drag tilts the elevation (clamped near the poles), the wheel dollies in/out.
Pickable	A candidate for Picker: geometry (MeshData, kept CPU-side for ray tests), its world transform, and an opaque tag the caller uses to identify the hit.
Picker	CPU ray picking.
PickResult	The nearest hit from Picker: the hit Pickable's tag, the ray distance, and the world-space intersection point.
Primitives	Procedural MeshData for common shapes, each with POSITION, NORMAL and UV0.
Render3DStats	A snapshot of the 3D subsystem's GPU footprint and last-frame workload, for diagnostics (a performance monitor).
RenderPass	The draw interface handed to a render callback (see Graphics3D.render(target, camera, body)).
RenderTarget	An offscreen render target for 3D content: a color texture plus a depth buffer, optionally multisampled (MSAA).
Sampler	How a texture is filtered and wrapped when sampled.
Sampler.Filter
Sampler.Wrap
TextureData	CPU-side pixels for a 2D texture: tightly packed 8-bit RGBA, row-major from the top-left, tagged with the ColorSpace the values are authored in.
VertexAttribute	A vertex attribute semantic and its component count.