Cone

Draws a cone or frustum — a shape with a base tapering to a point or a smaller top — for spires, funnels, and spotlight volumes.

Declarative element: <sk-cone>

Global: available as sk.Cone inside a scene <script>.

Remarks

This is a member of the AbstractMeshNode geometry-primitive family: a solid, renderable shape you position, paint, and animate like any scene node. It is the shape to reach for whenever you need a pointed spire, a truncated funnel, or a spotlight-cone volume.

Key attributes. A cone is defined by two radii — bottom-radius at the base and top-radius at the top — both animatable, so the shape can morph live. top-radius="0" gives a classic pointed cone; a non-zero top-radius truncates it into a frustum (funnel); equal radii would be a plain tube (use sk-cylinder for that). height (also animatable) is the length along the orientation axis (+x, -x, +y, -y, +z, -z), which picks base-to-tip direction. rotation-segments (minimum 3) sets how many facets go around the circumference — raise it for a smooth cone; height-segments subdivides along the length.

Related. Give it appearance with a sk-surface-paint (fills the faces) or an sk-edge-paint (draws the wireframe), each naming a sk-plain-material. It is closely kin to sk-cylinder (a cone with equal radii) and sk-sphere, and, like every mesh, can supply clone positions to a sk-cloner.

Constructor

constructor(config?: { topRadius?: number; bottomRadius?: number; height?: number; heightSegments?: number; rotationSegments?: number; orientation?: AxisOrientation; cullMode?: CullMode; overlay?: boolean; overlayOccludedOpacity?: number; id?: string; x?: number; y?: number; z?: number; h?: number; p?: number; b?: number; quaternion?: Quaternion; sx?: number; sy?: number; sz?: number; s?: number; class?: string; style?: string })

Inherited from: AbstractMeshNode, RenderableNode, SceneNode, SkenraAnimatable — see those pages for inherited members.

Properties

Config Properties

Other Properties

Methods

Example

// Create a standard pointed cone (default)
const cone = new Cone({ id: 'my-cone' });

// Create a frustum (truncated cone) for spotlight visualization
const frustum = new Cone({ id: 'spotlight-frustum',
    topRadius: 0.5,
    bottomRadius: 2,
    height: 5,
    rotationSegments: 16
});

// Create a tall spire with many segments
const spire = new Cone({ id: 'spire',
    topRadius: 0,
    bottomRadius: 1,
    height: 10,
    heightSegments: 20,
    rotationSegments: 12
});

// Create a horizontal cone along negative X-axis
const horizontalCone = new Cone({ id: 'horizontal',
    topRadius: 0,
    bottomRadius: 1,
    height: 2,
    orientation: '-x'
});

// Modify cone properties after construction
cone.topRadius = 0.5;  // Convert to frustum
cone.height = 3;       // Make taller
cone.rotationSegments = 32; // Increase smoothness

↑ Documentation home · ← All classes