Manim v0.21.0

[behackl]

See our rendered changelog.

What's Changed

Breaking Changes 🚨

• Delegate color handling in Code to Pygments and document custom styles by @Helbronner in Delegate color handling in Code to pygments and add instructions for creating custom styles #4816

  Code no longer honors foreground color overrides passed through
  paragraph_config={"color": ...} or Code.default_paragraph_config["color"];
  syntax and line-number colors now come from the selected Pygments
  formatter_style. To customize them, pass a custom Pygments Style subclass
  through formatter_style and configure its token styles and
  line_number_color. Background colors can still be overridden with
  background_config={"fill_color": ...}; otherwise, the selected Pygments
  style provides the background. See the note in the documentation of Code
  for an explicit example.

• Speed up Cairo renderer by 2.2x on animation-heavy scenes by @HamdiBarkous in Speed up Cairo renderer by 2.2x on animation-heavy scenes #4695

  Cairo path construction now uses vectorized subpath splitting, and pixel-array
  handling avoids redundant copies while producing pixel-identical output. This
  changes Camera.convert_pixel_array(): the convert_from_floats argument has
  been removed, and the method now always converts floats to the camera's pixel
  format. Omit the argument if it was previously True; use
  np.array(pixel_array) instead if relying on the old default copying behavior.

Highlights 🌟

• Introduce first-class support for rendering text and markup via Typst (optional dependency) by @behackl in Introduce first-class support for rendering text and markup via Typst (optional dependency) #4681

  The new Typst and TypstMath mobjects compile Typst markup
  and mathematical expressions directly to SVG without requiring a TeX
  installation. They support label-based subgroup selection, {{ ... }}
  expression grouping, and integration with existing label APIs. Install the
  optional dependency with pip install "manim[typst]".

• Hash NumPy arrays without JSON expansion by @dexhunter in perf(cache): hash NumPy arrays without JSON expansion #4883

  NumPy arrays in scene cache keys are now represented by deterministic hashes
  of their complete logical contents instead of sampled JSON data. This
  prevents stale cache hits when visible image data changes and reduces hashing
  CPU time by roughly 94–98% in representative benchmarks.

• Add support for encoding partial movie files in parallel by @pjfo in Add support for encoding partial movie files in parallel #4899

  The new max_inflight_encoders configuration option allows partial movie
  encoding to overlap with rendering while bounding the number of encoder
  workers. Try it with
  manim render --max-inflight-encoders 4 --encoder-queue-size 8 scene.py Scene;
  --encoder-queue-size limits the pending frame buffers held by each encoder.
  The default of one in-flight encoder preserves serial behavior; higher values
  reduced an encoding-heavy benchmark by 56% and larger real-world renders by
  roughly 8–11%.

New Features ✨

• Allow inner lines to be omitted from Table by @leqo-c in Allow excluding inner lines of Table #4731
• Support multiple compiler passes in TexTemplate by @Sazzzzzz in feat: support multiple TeX compilers in TexTemplate #4810
• Add a dot_buff parameter to BulletedList by @GniLudio in Add dot_buff parameter to BulletedList #4892

Enhancements 🚀

• Support tuple-based edge lookup in GenericGraph.__getitem__() by @HairlessVillager in Support edge lookup via tuple in GenericGraph.__getitem__() #3799
• Raise a clear error when rendered glyphs do not match input characters by @SupernovaIa in fix(text): raise a clear error instead of IndexError on glyph/char mismatch #4868
• Avoid copying Mobject.submobjects in sequence methods by @nikolajmunk in perf: Mobject's Sequence methods no longer copy self.submobjects on every call #4915
• Make additional mobject methods chainable by @GniLudio in Add missing mobject method chaining #4913

Bug Fixes 🐛

• Fix OpenGL crashes in arrange_in_grid() and get_location() by @Croustit in Fix OpenGL crashes in arrange_in_grid() and get_location() #4622
• Prevent get_nth_subpath() from raising IndexError and ensure it returns a NumPy array by @MqCreaple in Fix IndexError in get_nth_subpath() and ensure it always returns a NumPy array #4630
• Preserve closed curves in put_start_and_end_on() by @GoThrones in Preserve closed curves in put_start_and_end_on() #4658
• Fix inconsistent stroke-width scaling for text in compound objects by @vihdutta in Fixed inconsistent stroke width scaling for text in compound objects #4694
• Accept a single Group or VGroup in CyclicReplace and Swap by @irvanalhaq9 in Allow CyclicReplace and Swap to accept single Group or VGroup and add example #4211
• Prevent empty submobjects from distorting parent dimensions by @gvauvert in Fix empty submobjects distorting width/height of parent Mobject #4088
• Honor language when constructing Code from code_file by @GniLudio in Use language parameter to format Code even when passing code_file #4706
• Fix ThreeDScene.set_to_default_angled_camera_orientation() raising AttributeError by @siddhu-pikachu in Fix set_to_default_angled_camera_orientation() raising AttributeError #4704
• Fix reversed default resolution in manim init project --default by @aoxiangtianyu-go in fix(init): reverse default resolution when using manim init project --default #4839
• Prevent memoizer collisions between object hashes and IDs by @pjfo in Prevent memoizer collisions between object hashes and IDs #4901
• Prevent round_corners() failures for collinear vertices by @MeiSiristhebest in Prevent round_corners() failures for collinear vertices #4906
• Fix checkhealth false positives for uv launcher shims by @srinu2003 in fix(cli): resolve checkhealth false positive for uv launcher shims #4889
• Fix OpenGL triangulation errors at ring boundaries by @Theelx in Fix OpenGL triangulation errors at ring boundaries #4819
• Fix Angle crashes for parallel or collinear lines by @MeiSiristhebest in Fix Angle crash on parallel/collinear lines (#1930) #4907
• Stabilize cache hashes for transient objects by @pjfo in Improve hashing stability for transient objects #4896
• Ignore SVG shape elements without points by @behackl in fix(svg): ignore point-less shape elements #4917
• Normalize Code baseline alignment in Paragraph by @Croustit in fix: normalize Code baseline alignment in Paragraph #4692
• Preserve z-index ordering in animation groups by @behackl in Preserve z-index ordering in animation groups #4918
• Let MathTex handle multiline strings by @henrikmidtiby in Let MathTex handle multiline strings #4634
• Ensure that glyphs at end of Code lines are no longer deleted when disable_ligatures is False by @nikolajmunk in Glyphs at end of Code lines no longer deleted when disable_ligatures is False #4926

Documentation 📚

• Correct SquareToCircle terminology in the quickstart guide by @xuruidong in Fix incorrect terminology in quickstart docs #4631
• Correct angle ranges in Sphere documentation and add examples by @Jackyuanx in Fix wrong angle ranges in Sphere documentation and add more examples #3973
• Document edge lookup in GenericGraph.__getitem__() by @mayank-dev-15 in Add docstring to GenericGraph.__getitem__() #4761
• Correct the FadeOut example name by @GniLudio in Fix name of FadeOut example #4832
• Document whitespace-stripped indexing in Text by @SupernovaIa in docs(text): document whitespace-stripped indexing in Text #4866
• Preserve line color in the MovingDots example by @shenao010415 in Preserve line color in MovingDots example #4895
• Correct the font-directory lookup documented for register_font() by @ExploreMaths in docs: fix register_font docstring #4880
• Correct angle ordering in the cartesian_to_spherical() and spherical_to_cartesian() docstrings by @changsheng0804-blip in Fix misleading docstring in cartesian_to_spherical #4764
• Clarify frame terminology in the MovingCameraScene example by @nikolajmunk in docs: Rename "scene" in MovingCameraScene example #4910

Testing 🧪

• Add unit tests for color helper functions by @THE-RAF in Add unit tests for module-level color helpers in manim/utils/color/core.py #4749
• Add regression tests for four recent VMobject fixes by @THE-RAF in Add regression tests for four recent fixes in vectorized_mobject.py #4750
• Add tests for edge lookup in GenericGraph.__getitem__() by @sridhar-3009 in Add tests for edge lookup in GenericGraph.__getitem__() #4753
• Add a regression test for text stroke-width scaling in compound objects by @vihdutta in Added regression test for inconsistent stroke width scaling for text in compound objects #4703

Infrastructure & Build 🔨

• Update TinyTeX installation on Windows and macOS to fix CI failures by @chopan050 in Update TinyTeX Windows/macOS installation in ci.yml to fix failing pipelines #4679
• Update CI workflow dependencies by @behackl in Update CI workflow dependencies #4677
• Switch package builds from Hatchling to uv-build by @JasonGrace2282 in Use uv-build instead of hatchling for package building #4619

Code Quality & Refactoring 🧹

• Update the project metadata link to X (formerly Twitter) by @henrikmidtiby in Update link in pyproject.toml to X / Twitter #4642
• Replace a bare except in rate_functions.py by @koteshyelamati in Fix bare except clause in manim/utils/rate_functions.py #4891
• Simplify the Code syntax-coloring implementation by @GniLudio in Simplify Code syntax-coloring implementation #4894
• Update pre-commit hooks by @behackl in Update pre-commit hooks #4920
• Rename TypstMath to MathTypst to match existing Tex / MathTex coupling by @behackl in Rename TypstMath to MathTypst to match existing Tex / MathTex coupling #4925

Type Hints 📝

• Add type annotations to mobject.py by @henrikmidtiby in Add type annotations to mobject.py #4388
• Use npt.NDArray[np.float64] for VMobject._bezier_t_values by @GoThrones in Change VMobject._bezier_t_values typehint to npt.NDArray[np.float64] #4675
• Improve Callable annotations for mobject updater utilities by @treszkai in More specific Callable type annotations in mobject_update_utils #4728
• Add type annotations to transform_matching_parts.py by @henrikmidtiby in Add type annotations to transform_matching_parts.py #4400
• Fix the _on_finish annotation in Animation.__init__ by @GniLudio in Fix type annotation of _on_finish in Animation.__init__ #4812
• Add type annotations to table.py by @henrikmidtiby in Add type annotations to table.py #4641

Other Changes

• Prepare new release: v0.21.0 by @behackl in Prepare new release: v0.21.0 #4919

New Contributors

• @Croustit made their first contribution in Fix OpenGL crashes in arrange_in_grid() and get_location() #4622
• @xuruidong made their first contribution in Fix incorrect terminology in quickstart docs #4631
• @MqCreaple made their first contribution in Fix IndexError in get_nth_subpath() and ensure it always returns a NumPy array #4630
• @vihdutta made their first contribution in Fixed inconsistent stroke width scaling for text in compound objects #4694
• @THE-RAF made their first contribution in Add unit tests for module-level color helpers in manim/utils/color/core.py #4749
• @leqo-c made their first contribution in Allow excluding inner lines of Table #4731
• @treszkai made their first contribution in More specific Callable type annotations in mobject_update_utils #4728
• @gvauvert made their first contribution in Fix empty submobjects distorting width/height of parent Mobject #4088
• @sridhar-3009 made their first contribution in Add tests for edge lookup in GenericGraph.__getitem__() #4753
• @GniLudio made their first contribution in Use language parameter to format Code even when passing code_file #4706
• @mayank-dev-15 made their first contribution in Add docstring to GenericGraph.__getitem__() #4761
• @siddhu-pikachu made their first contribution in Fix set_to_default_angled_camera_orientation() raising AttributeError #4704
• @Sazzzzzz made their first contribution in feat: support multiple TeX compilers in TexTemplate #4810
• @aoxiangtianyu-go made their first contribution in fix(init): reverse default resolution when using manim init project --default #4839
• @SupernovaIa made their first contribution in docs(text): document whitespace-stripped indexing in Text #4866
• @koteshyelamati made their first contribution in Fix bare except clause in manim/utils/rate_functions.py #4891
• @pjfo made their first contribution in Prevent memoizer collisions between object hashes and IDs #4901
• @MeiSiristhebest made their first contribution in Prevent round_corners() failures for collinear vertices #4906
• @shenao010415 made their first contribution in Preserve line color in MovingDots example #4895
• @ExploreMaths made their first contribution in docs: fix register_font docstring #4880
• @srinu2003 made their first contribution in fix(cli): resolve checkhealth false positive for uv launcher shims #4889
• @changsheng0804-blip made their first contribution in Fix misleading docstring in cartesian_to_spherical #4764
• @Theelx made their first contribution in Fix OpenGL triangulation errors at ring boundaries #4819
• @dexhunter made their first contribution in perf(cache): hash NumPy arrays without JSON expansion #4883
• @nikolajmunk made their first contribution in docs: Rename "scene" in MovingCameraScene example #4910
• @Helbronner made their first contribution in Delegate color handling in Code to pygments and add instructions for creating custom styles #4816
• @HamdiBarkous made their first contribution in Speed up Cairo renderer by 2.2x on animation-heavy scenes #4695

Full Changelog: Compare view

---

This discussion was created from the release Manim v0.21.0.