Skip to main content

Class: Icosahedron

Defined in: mobjects/three-d/Polyhedra.ts:359

Icosahedron - A 20-faced polyhedron (platonic solid)

Creates an icosahedron using Three.js IcosahedronGeometry with configurable size and material properties. All faces are equilateral triangles.

Example

// Create a unit icosahedron
const icosa = new Icosahedron();

// Create a green icosahedron with side length 2
const greenIcosa = new Icosahedron({ sideLength: 2, color: '#00ff00' });

// Create a subdivided icosahedron (closer to a sphere)
const smooth = new Icosahedron({ sideLength: 1, detail: 2 });

Extends

Constructors

Constructor

new Icosahedron(options): Icosahedron

Defined in: mobjects/three-d/Polyhedra.ts:40

Parameters

options

PolyhedronOptions = {}

Returns

Icosahedron

Inherited from

Polyhedron.constructor

Properties

__savedMobjectState

__savedMobjectState: unknown = null

Defined in: core/Mobject.ts:95

JSON-serializable saved state (used by restoreState()).

Inherited from

Polyhedron.__savedMobjectState


_centerPoint

protected _centerPoint: Vector3Tuple

Defined in: mobjects/three-d/Polyhedra.ts:37

Inherited from

Polyhedron._centerPoint


_color

protected _color: string = '#ffffff'

Defined in: core/Mobject.ts:70

Inherited from

Polyhedron._color


_detail

protected _detail: number

Defined in: mobjects/three-d/Polyhedra.ts:38

Inherited from

Polyhedron._detail


_dirty

_dirty: boolean = true

Defined in: core/Mobject.ts:88

Inherited from

Polyhedron._dirty


_disableChildZLayering

protected _disableChildZLayering: boolean = false

Defined in: core/Mobject.ts:85

When true, children skip the 2D z-layering offset in _syncToThree.

Inherited from

Polyhedron._disableChildZLayering


_opacity

protected _opacity: number = 1

Defined in: core/Mobject.ts:81

Inherited from

Polyhedron._opacity


_sideLength

protected _sideLength: number

Defined in: mobjects/three-d/Polyhedra.ts:35

Inherited from

Polyhedron._sideLength


_style

protected _style: MobjectStyle

Defined in: core/Mobject.ts:86

Inherited from

Polyhedron._style


_threeObject

_threeObject: Object3D<Object3DEventMap> = null

Defined in: core/Mobject.ts:87

Inherited from

Polyhedron._threeObject


_wireframe

protected _wireframe: boolean

Defined in: mobjects/three-d/Polyhedra.ts:36

Inherited from

Polyhedron._wireframe


children

children: Mobject[] = []

Defined in: core/Mobject.ts:65

Inherited from

Polyhedron.children


createdAtBeginning

createdAtBeginning: boolean = false

Defined in: core/Mobject.ts:69

Inherited from

Polyhedron.createdAtBeginning


fillOpacity

fillOpacity: number = 0

Defined in: core/Mobject.ts:83

Inherited from

Polyhedron.fillOpacity


id

readonly id: string

Defined in: core/Mobject.ts:63

Inherited from

Polyhedron.id


parent

parent: Mobject = null

Defined in: core/Mobject.ts:64

Inherited from

Polyhedron.parent


position

position: Vector3

Defined in: core/Mobject.ts:66

Inherited from

Polyhedron.position


rotation

rotation: Euler

Defined in: core/Mobject.ts:67

Inherited from

Polyhedron.rotation


savedState

savedState: Mobject = null

Defined in: core/Mobject.ts:91

Saved mobject copy (used by Restore animation). Set by saveState().

Inherited from

Polyhedron.savedState


scaleVector

scaleVector: Vector3

Defined in: core/Mobject.ts:68

Inherited from

Polyhedron.scaleVector


strokeWidth

strokeWidth: number = 4

Defined in: core/Mobject.ts:82

Inherited from

Polyhedron.strokeWidth


targetCopy

targetCopy: Mobject = null

Defined in: core/Mobject.ts:93

Target copy used by generateTarget() / MoveToTarget animation.

Inherited from

Polyhedron.targetCopy

Accessors

animate

Get Signature

get animate(): any

Defined in: core/Mobject.ts:497

Returns an AnimateProxy that records method calls. Pass the proxy to scene.play() to animate from the current state to the state after all recorded calls are applied.

Example
scene.play(circle.animate.shift([2, 0, 0]));
scene.play(circle.animate.setColor('#ff0000').scale(2));
Returns

any

Inherited from

Polyhedron.animate


color

Get Signature

get color(): string

Defined in: core/Mobject.ts:71

Returns

string

Set Signature

set color(value): void

Defined in: core/Mobject.ts:74

Parameters
value

string

Returns

void

Inherited from

Polyhedron.color


fillColor

Get Signature

get fillColor(): string

Defined in: core/Mobject.ts:184

Returns

string

Set Signature

set fillColor(color): void

Defined in: core/Mobject.ts:188

Parameters
color

string

Returns

void

Inherited from

Polyhedron.fillColor


isDirty

Get Signature

get isDirty(): boolean

Defined in: core/Mobject.ts:551

Returns

boolean

Inherited from

Polyhedron.isDirty


opacity

Get Signature

get opacity(): number

Defined in: core/Mobject.ts:114

Returns

number

Set Signature

set opacity(value): void

Defined in: core/Mobject.ts:118

Parameters
value

number

Returns

void

Inherited from

Polyhedron.opacity


strokeColor

Get Signature

get strokeColor(): string

Defined in: core/Mobject.ts:195

Returns

string

Set Signature

set strokeColor(color): void

Defined in: core/Mobject.ts:199

Parameters
color

string

Returns

void

Inherited from

Polyhedron.strokeColor


style

Get Signature

get style(): MobjectStyle

Defined in: core/Mobject.ts:122

Returns

MobjectStyle

Inherited from

Polyhedron.style


submobjects

Get Signature

get submobjects(): Mobject[]

Defined in: core/Mobject.ts:136

Returns

Mobject[]

Inherited from

Polyhedron.submobjects

Methods

_createCopy()

protected _createCopy(): Icosahedron

Defined in: mobjects/three-d/Polyhedra.ts:399

Returns

Icosahedron

Overrides

Polyhedron._createCopy


_createGeometry()

protected _createGeometry(): BufferGeometry

Defined in: mobjects/three-d/Polyhedra.ts:368

Create the Three.js geometry for this polyhedron. Subclasses must implement this.

Returns

BufferGeometry

Overrides

Polyhedron._createGeometry


_createThreeObject()

protected _createThreeObject(): Object3D

Defined in: mobjects/three-d/Polyhedra.ts:80

Create the Three.js mesh

Returns

Object3D

Inherited from

Polyhedron._createThreeObject


_getBoundingBox()

_getBoundingBox(): object

Defined in: core/Mobject.ts:449

Returns

object

depth

depth: number

height

height: number

width

width: number

Deprecated

Use getBoundingBox() instead.

Inherited from

Polyhedron._getBoundingBox


_getEdgeInDirection()

_getEdgeInDirection(direction): Vector3Tuple

Defined in: core/Mobject.ts:442

Parameters

direction

Vector3Tuple

Returns

Vector3Tuple

Inherited from

Polyhedron._getEdgeInDirection


_getRadiusFromSideLength()

protected _getRadiusFromSideLength(): number

Defined in: mobjects/three-d/Polyhedra.ts:364

Convert side length to circumradius for Three.js IcosahedronGeometry. For an icosahedron: circumradius = sideLength * sqrt(10 + 2*sqrt(5)) / 4

Returns

number

Overrides

Polyhedron._getRadiusFromSideLength


_markDirty()

_markDirty(): void

Defined in: core/Mobject.ts:541

Returns

void

Inherited from

Polyhedron._markDirty


_markDirtyUpward()

_markDirtyUpward(): void

Defined in: core/Mobject.ts:545

Returns

void

Inherited from

Polyhedron._markDirtyUpward


_syncMaterialToThree()

protected _syncMaterialToThree(): void

Defined in: mobjects/three-d/Polyhedra.ts:98

Sync material properties to Three.js object

Returns

void

Inherited from

Polyhedron._syncMaterialToThree


_syncToThree()

_syncToThree(): void

Defined in: core/Mobject.ts:519

Returns

void

Inherited from

Polyhedron._syncToThree


_updateGeometry()

protected _updateGeometry(): void

Defined in: mobjects/three-d/Polyhedra.ts:114

Update the geometry with current dimensions

Returns

void

Inherited from

Polyhedron._updateGeometry


add()

add(...mobjects): this

Defined in: core/Mobject.ts:329

Parameters

mobjects

...Mobject[]

Returns

this

Inherited from

Polyhedron.add


addUpdater()

addUpdater(updater, callOnAdd): this

Defined in: core/Mobject.ts:589

Parameters

updater

UpdaterFunction

callOnAdd

boolean = false

Returns

this

Inherited from

Polyhedron.addUpdater


alignTo()

alignTo(target, direction): this

Defined in: core/Mobject.ts:427

Parameters

target

Mobject | Vector3Tuple

direction

Vector3Tuple

Returns

this

Inherited from

Polyhedron.alignTo


applyFunction()

applyFunction(fn, options?): this

Defined in: core/Mobject.ts:619

Parameters

fn

(point) => number[]

options?
aboutEdge?

Vector3Tuple

aboutPoint?

Vector3Tuple

Returns

this

Inherited from

Polyhedron.applyFunction


applyMatrix()

applyMatrix(matrix, options?): this

Defined in: core/Mobject.ts:627

Parameters

matrix

number[][]

options?
aboutEdge?

Vector3Tuple

aboutPoint?

Vector3Tuple

Returns

this

Inherited from

Polyhedron.applyMatrix


applyToFamily()

applyToFamily(func): this

Defined in: core/Mobject.ts:577

Parameters

func

(mobject) => void

Returns

this

Inherited from

Polyhedron.applyToFamily


become()

become(other): this

Defined in: core/Mobject.ts:376

Parameters

other

Mobject

Returns

this

Inherited from

Polyhedron.become


center()

center(): this

Defined in: core/Mobject.ts:479

Returns

this

Inherited from

Polyhedron.center


clearUpdaters()

clearUpdaters(): this

Defined in: core/Mobject.ts:601

Returns

this

Inherited from

Polyhedron.clearUpdaters


copy()

copy(): Mobject

Defined in: core/Mobject.ts:358

Returns

Mobject

Inherited from

Polyhedron.copy


dispose()

dispose(): void

Defined in: core/Mobject.ts:658

Returns

void

Inherited from

Polyhedron.dispose


flip()

flip(axis, options?): this

Defined in: core/Mobject.ts:257

Parameters

axis

Vector3Tuple = ...

options?
aboutEdge?

Vector3Tuple

aboutPoint?

Vector3Tuple

Returns

this

Inherited from

Polyhedron.flip


generateTarget()

generateTarget(): Mobject

Defined in: core/Mobject.ts:642

Returns

Mobject

Inherited from

Polyhedron.generateTarget


getBottom()

getBottom(): Vector3Tuple

Defined in: core/Mobject.ts:458

Returns

Vector3Tuple

Inherited from

Polyhedron.getBottom


getBoundingBox()

getBoundingBox(): object

Defined in: core/Mobject.ts:445

Returns

object

depth

depth: number

height

height: number

width

width: number

Inherited from

Polyhedron.getBoundingBox


getBounds()

getBounds(): object

Defined in: core/Mobject.ts:392

Returns

object

max

max: object

max.x

x: number

max.y

y: number

max.z

z: number

min

min: object

min.x

x: number

min.y

y: number

min.z

z: number

Inherited from

Polyhedron.getBounds


getCenter()

getCenter(): Vector3Tuple

Defined in: core/Mobject.ts:388

Returns

Vector3Tuple

Inherited from

Polyhedron.getCenter


getDetail()

getDetail(): number

Defined in: mobjects/three-d/Polyhedra.ts:157

Get the detail level

Returns

number

Inherited from

Polyhedron.getDetail


getDisplayMeshes()

getDisplayMeshes(): Mesh<BufferGeometry<NormalBufferAttributes, BufferGeometryEventMap>, Material<MaterialEventMap> | Material<MaterialEventMap>[], Object3DEventMap>[]

Defined in: core/Mobject.ts:569

Returns

Mesh<BufferGeometry<NormalBufferAttributes, BufferGeometryEventMap>, Material<MaterialEventMap> | Material<MaterialEventMap>[], Object3DEventMap>[]

Inherited from

Polyhedron.getDisplayMeshes


getDisplayMeshLength()

getDisplayMeshLength(): number

Defined in: core/Mobject.ts:565

Number of visible display meshes this mobject contributes when rendered. Used for Transform eligibility checks without forcing Three.js object creation.

Returns

number

Inherited from

Polyhedron.getDisplayMeshLength


getEdge()

getEdge(direction): Vector3Tuple

Defined in: core/Mobject.ts:452

Parameters

direction

Vector3Tuple

Returns

Vector3Tuple

Inherited from

Polyhedron.getEdge


getEdgeCount()

getEdgeCount(): number

Defined in: mobjects/three-d/Polyhedra.ts:381

Get the number of edges for this polyhedron

Returns

number

Overrides

Polyhedron.getEdgeCount


getFaceCount()

getFaceCount(): number

Defined in: mobjects/three-d/Polyhedra.ts:373

Get the number of faces for this polyhedron

Returns

number

Overrides

Polyhedron.getFaceCount


getFamily()

getFamily(): Mobject[]

Defined in: core/Mobject.ts:583

Returns

Mobject[]

Inherited from

Polyhedron.getFamily


getLeft()

getLeft(): Vector3Tuple

Defined in: core/Mobject.ts:461

Returns

Vector3Tuple

Inherited from

Polyhedron.getLeft


getRight()

getRight(): Vector3Tuple

Defined in: core/Mobject.ts:464

Returns

Vector3Tuple

Inherited from

Polyhedron.getRight


getSideLength()

getSideLength(): number

Defined in: mobjects/three-d/Polyhedra.ts:125

Get the side length

Returns

number

Inherited from

Polyhedron.getSideLength


getSurfaceArea()

getSurfaceArea(): number

Defined in: mobjects/three-d/Polyhedra.ts:388

Get the surface area of the icosahedron

Returns

number


getThreeObject()

getThreeObject(): Object3D

Defined in: core/Mobject.ts:555

Returns

Object3D

Inherited from

Polyhedron.getThreeObject


getTop()

getTop(): Vector3Tuple

Defined in: core/Mobject.ts:455

Returns

Vector3Tuple

Inherited from

Polyhedron.getTop


getUpdaters()

getUpdaters(): UpdaterFunction[]

Defined in: core/Mobject.ts:608

Returns

UpdaterFunction[]

Inherited from

Polyhedron.getUpdaters


getVertexCount()

getVertexCount(): number

Defined in: mobjects/three-d/Polyhedra.ts:377

Get the number of vertices for this polyhedron

Returns

number

Overrides

Polyhedron.getVertexCount


getVolume()

getVolume(): number

Defined in: mobjects/three-d/Polyhedra.ts:395

Get the volume of the icosahedron

Returns

number


hasUpdaters()

hasUpdaters(): boolean

Defined in: core/Mobject.ts:605

Returns

boolean

Inherited from

Polyhedron.hasUpdaters


isWireframe()

isWireframe(): boolean

Defined in: mobjects/three-d/Polyhedra.ts:141

Get whether wireframe mode is enabled

Returns

boolean

Inherited from

Polyhedron.isWireframe


moveTo()

moveTo(target, alignedEdge?): this

Defined in: core/Mobject.ts:216

Parameters

target

Mobject | Vector3Tuple

alignedEdge?

Vector3Tuple

Returns

this

Inherited from

Polyhedron.moveTo


moveToAligned()

moveToAligned(target, alignedEdge?): this

Defined in: core/Mobject.ts:437

Parameters

target

Mobject | Vector3Tuple

alignedEdge?

Vector3Tuple

Returns

this

Inherited from

Polyhedron.moveToAligned


nextTo()

nextTo(target, direction, buff): this

Defined in: core/Mobject.ts:410

Parameters

target

Mobject | Vector3Tuple

direction

Vector3Tuple = RIGHT

buff

number = 0.25

Returns

this

Inherited from

Polyhedron.nextTo


prepareForNonlinearTransform()

prepareForNonlinearTransform(numPieces): this

Defined in: core/Mobject.ts:635

Parameters

numPieces

number = 50

Returns

this

Inherited from

Polyhedron.prepareForNonlinearTransform


remove()

remove(...mobjects): this

Defined in: core/Mobject.ts:342

Parameters

mobjects

...Mobject[]

Returns

this

Inherited from

Polyhedron.remove


removeUpdater()

removeUpdater(updater): this

Defined in: core/Mobject.ts:595

Parameters

updater

UpdaterFunction

Returns

this

Inherited from

Polyhedron.removeUpdater


replace()

replace(target, stretch): this

Defined in: core/Mobject.ts:381

Parameters

target

Mobject

stretch

boolean = false

Returns

this

Inherited from

Polyhedron.replace


restoreState()

restoreState(): boolean

Defined in: core/Mobject.ts:652

Returns

boolean

Inherited from

Polyhedron.restoreState


rotate()

rotate(angle, axisOrOptions?): this

Defined in: core/Mobject.ts:237

Rotate the mobject by angle around an axis. Accepts aboutPoint or aboutEdge to specify the rotation center.

Parameters

angle

number

axisOrOptions?

Vector3Tuple | { aboutEdge?: Vector3Tuple; aboutPoint?: Vector3Tuple; axis?: Vector3Tuple; }

Returns

this

Inherited from

Polyhedron.rotate


rotateAboutOrigin()

rotateAboutOrigin(angle, axis): this

Defined in: core/Mobject.ts:253

Parameters

angle

number

axis

Vector3Tuple = ...

Returns

this

Inherited from

Polyhedron.rotateAboutOrigin


saveState()

saveState(): this

Defined in: core/Mobject.ts:647

Returns

this

Inherited from

Polyhedron.saveState


scale()

scale(factor, options?): this

Defined in: core/Mobject.ts:283

Parameters

factor

number | Vector3Tuple

options?
aboutEdge?

Vector3Tuple

aboutPoint?

Vector3Tuple

Returns

this

Inherited from

Polyhedron.scale


setColor()

setColor(color): this

Defined in: core/Mobject.ts:140

Parameters

color

string

Returns

this

Inherited from

Polyhedron.setColor


setDetail()

setDetail(value): this

Defined in: mobjects/three-d/Polyhedra.ts:164

Set the detail level (subdivision)

Parameters

value

number

Returns

this

Inherited from

Polyhedron.setDetail


setFill()

setFill(color?, opacity?): this

Defined in: core/Mobject.ts:178

Parameters

color?

string

opacity?

number

Returns

this

Inherited from

Polyhedron.setFill


setFillOpacity()

setFillOpacity(opacity): this

Defined in: core/Mobject.ts:168

Parameters

opacity

number

Returns

this

Inherited from

Polyhedron.setFillOpacity


setSideLength()

setSideLength(value): this

Defined in: mobjects/three-d/Polyhedra.ts:132

Set the side length

Parameters

value

number

Returns

this

Inherited from

Polyhedron.setSideLength


setStrokeOpacity()

setStrokeOpacity(opacity): this

Defined in: core/Mobject.ts:148

Parameters

opacity

number

Returns

this

Inherited from

Polyhedron.setStrokeOpacity


setStrokeWidth()

setStrokeWidth(width): this

Defined in: core/Mobject.ts:158

Parameters

width

number

Returns

this

Inherited from

Polyhedron.setStrokeWidth


setStyle()

setStyle(style): this

Defined in: core/Mobject.ts:126

Parameters

style

Partial<MobjectStyle>

Returns

this

Inherited from

Polyhedron.setStyle


setWireframe()

setWireframe(value): this

Defined in: mobjects/three-d/Polyhedra.ts:148

Set wireframe mode

Parameters

value

boolean

Returns

this

Inherited from

Polyhedron.setWireframe


setX()

setX(x): this

Defined in: core/Mobject.ts:467

Parameters

x

number

Returns

this

Inherited from

Polyhedron.setX


setY()

setY(y): this

Defined in: core/Mobject.ts:471

Parameters

y

number

Returns

this

Inherited from

Polyhedron.setY


setZ()

setZ(z): this

Defined in: core/Mobject.ts:475

Parameters

z

number

Returns

this

Inherited from

Polyhedron.setZ


shift()

shift(delta): this

Defined in: core/Mobject.ts:208

Parameters

delta

Vector3Tuple

Returns

this

Inherited from

Polyhedron.shift


stretch()

stretch(factor, dim, options?): this

Defined in: core/Mobject.ts:310

Parameters

factor

number

dim

number

options?
aboutEdge?

Vector3Tuple

aboutPoint?

Vector3Tuple

Returns

this

Inherited from

Polyhedron.stretch


toCorner()

toCorner(direction, buff, frameDimensions?): this

Defined in: core/Mobject.ts:509

Parameters

direction

Vector3Tuple = ...

buff

number = 0.5

frameDimensions?

[number, number]

Returns

this

Inherited from

Polyhedron.toCorner


toEdge()

toEdge(direction, buff, frameDimensions?): this

Defined in: core/Mobject.ts:504

Parameters

direction

Vector3Tuple

buff

number = 0.5

frameDimensions?

[number, number]

Returns

this

Inherited from

Polyhedron.toEdge


update()

update(dt): void

Defined in: core/Mobject.ts:612

Parameters

dt

number

Returns

void

Inherited from

Polyhedron.update