PlatonicSpherePointsSource

Distributes points very evenly over a sphere by subdividing a platonic solid — the way to scatter copies of an object across a ball with near-uniform spacing (no clustering at the poles).

Declarative element: <sk-platonic-sphere-points-source>

Not on the sk.* global — construct via the declarative element or a module import.

Remarks

This is a procedural member of the points-source family (see ShaderFunctionPointsSource): a points-source defines the set of positions at which a sk-cloner places copies of its content, so it lives as a child of a <sk-cloner> and the cloner's other child is the template cloned at each point. The points come from subdividing a platonic solid and projecting the result onto the sphere, so the coverage stays far more uniform than a latitude/longitude sk-uv-sphere-points-source — and, being generated in the shader, a densely subdivided sphere costs the same few parameters as a coarse one.

Key attributes. solid-type picks the seed polyhedron — tetrahedron (4 base points), octahedron (6), hexahedron (cube, 8), or icosahedron (12) — with icosahedron giving the most uniform triangle distribution and being the usual choice. subdivisions refines the seed: each step splits every triangle into four, so the point count grows sharply (leave at 0 for just the solid's own vertices; 2–3 gives a dense, smooth sphere). radius sets the sphere size and center its position.

Related. For a sphere addressed by rings and segments instead of even coverage, see sk-uv-sphere-points-source and the general sk-sphere-points-source; other procedural shapes include sk-grid-points-source, sk-disc-points-source, and sk-torus-points-source. For positions taken from data or another object rather than a formula, see sk-mesh-vertex-points-source, sk-mesh-surface-points-source, sk-buffer-points-source, and sk-cloner-points-source. Its host is always a sk-cloner.

Constructor

constructor(config?: { type?: PlatonicSolidType; subdivisions?: number; radius?: number; center?: [number, number, number] })

Inherited from: ShaderFunctionPointsSource, SkenraAnimatable — see those pages for inherited members.

Properties

Config Properties

Other Properties

Methods

Example

// Create points on an icosphere with 2 subdivisions
const icoSource = new PlatonicSpherePointsSource({
    type: 'icosahedron',
    subdivisions: 2,
    radius: 1.0
});

const cloner = new Cloner({ id: 'ico-cloner',
    pointsSource: icoSource,
    alignToNormal: true
});

↑ Documentation home · ← All classes