errors

Public exception and warning taxonomy for Algan.

The renderer and authoring APIs raise these types when a user-facing configuration or lifecycle contract is violated. Keeping the taxonomy small lets applications catch actionable Algan failures without depending on implementation-specific exceptions from Torch, Taichi, MoviePy, or FFmpeg.

Exceptions

AlganConfigurationError	Raised when a supplied setting or render configuration is invalid.
AlganError	Base class for user-facing Algan exceptions.
AlganWarning	Base class for user-facing Algan warnings.
ApproximationWarning	Warns that an API uses an explicitly documented approximation.
AudioTranscriptMismatchError	Raised when audio runtime and transcript mismatch during alignment.
ContextReuseError	Raised when an animation context object is entered more than once.
DespawnedMobWarning	Warns that an operation on a despawned Mob cannot bring it back.
HierarchyChangedDuringUpdaterWarning	Warns that a hierarchy change reaches back over a live updater's frames.
HierarchyError	Raised when a Mob hierarchy mutation would create an invalid graph.
InvalidColorError	Raised when an invalid color string or value is passed.
LegacySceneDiscoveryWarning	Warns that render_all_funcs fell back to implicit function scanning.
ModifiedProtectedAttributeError	Raised when a shader/material is (re)assigned after the mob has spawned.
NeverSpawnedMobWarning	Warns that Mobs were authored but never spawned, so they do not appear.
UnsupportedFeatureError	Raised when the selected renderer cannot honor requested features.
UnsupportedFeatureWarning	Warns that a renderer cannot honor one or more requested features.