Cube

Qualified name: algan.mobs.shapes\_3d.Cube

class Cube(size=2, fill_opacity=0.75, fill_color=None, stroke_width=0, **kwargs)[source]

Bases: Prism

A cube – a Prism with three equal sides.

Like every Polyhedron its faces are flat, so it is not tessellated per frame the way the curved shapes are.

Parameters:
  • size – Length of each edge, in world units. Defaults to 2.

  • fill_opacity – Opacity of the faces, from 0 (invisible) to 1 (opaque). Defaults to 0.75, Manim’s value – a cube is slightly see-through unless you say otherwise.

  • fill_color – Color of the faces: an Algan Color, a named constant such as BLUE, or anything Color() accepts. Defaults to None, meaning BLUE.

  • stroke_width – Width of the outline drawn around each face, in world units. Defaults to 0 (no outline).

  • **kwargs – Passed to Prism and on to Polyhedron.

Examples

An opaque cube, turned so three faces are visible:

Example: Example1Cube

../_images/Example1Cube-1.png
from algan import *

cube = Cube(size=1.2, fill_color=BLUE, fill_opacity=1).spawn()
cube.rotate(35, UP)

Scene.save_video()

Methods

Attributes

animation_manager

This mob's scene-owned animation manager.

basis

The Mob's orientation and scale, as a flattened 3x3 matrix of shape (*, 9).

casts_shadows

Whether this Mob's geometry blocks light on its way from a light source to another surface -- whether it casts a shadow.

children

The Mobs attached below this one, in attachment order.

closed_shell

Whether this Mob's triangles form a CLOSED shell -- every camera ray that enters the geometry crosses a second time on its way out.

draws_descendants

get_render_primitives below hands the renderer every face under one _mesh_key, and nothing else -- so the faces are this Mob's internals rather than Mobs of their own, and the vertex Dot3D``s and edge Mobs under ``self.graph (kept for Manim parity, where graph_config styles them) are geometry it owns but never puts on screen.

forward

Get the direction the Mob is facing.

lifespan

This mob's [spawn, despawn) interval on its Scene timeline (a Lifespan).

location

The Mob's position in world space, shape (*, 3).

normalized_basis

The Mob's orientation with scale divided out, shape (*, 9).

parents

The Mobs this one is attached to, in attachment order.

receives_shadows

Whether this Mob's surfaces are darkened by shadows cast onto them.

right

Get the Mob's own rightward direction.

scale_coefficient

The Mob's scale along its own right, up and forward axes, shape (*, 3).

two_sided

Whether this Mob's geometry should be lit from whichever side the ray arrives on.

up

Get the Mob's own upward direction.

x

The Mob's x coordinate in world units, shape (*, 1).

xy

The Mob's x and y coordinates in world units, shape (*, 2).

y

The Mob's y coordinate in world units, shape (*, 1).

z

The Mob's z coordinate in world units, shape (*, 1).