l j! d Z ddlmZ ddlZddlZddlmZ ddlmZ ddlm Z ddl
m Z m Z m
Z
ddlmZ dd lmZ d
d lmZ d gZ dd
lmZ ddlmZ ddlmZmZm Z m Z ddl m Z m Z m!Z! e G d d e Z"n # e#$ r Y nw xY wddZ$dS )zIUtilities for using Manim with IPython (in particular: Jupyter notebooks) ) annotationsN)datetime)Path)Any)configlogger
tempconfig)main)shader_program_cache ) RendererType
ManimMagic) get_ipython)InteractiveShell)Magicsline_cell_magic magics_classneeds_local_scope)ImageVideodisplayc V e Zd Zd fd Zee ddd
ZddZ xZS )r shellr returnNonec X t | i | _ d S )N)super__init__rendered_files)selfr __class__s T/home/agentuser/manim-venv/lib/python3.11/site-packages/manim/utils/ipython_magic.pyr zManimMagic.__init__# s) GG U # # #46D Nlinestrcell
str | Nonelocal_nsdict[str, Any] | Nonec |rt || | }t | r d|v sd|v sd|v rt |dd dS | | }t |dd }t |t sJ t | di 5 t j
| d}t j t j
k rd d
lm} | } |t d d } || } | t# j | |j |j n<# t# j |!|j |j w w w xY wt d
"t+ j d ddd dS t/ t d
t/ j }
t/ t d dz t5 |
j z } |
| j v r | j |
| | j |
< | j dd tA j! |
| tE j# t d
d } t | tH sJ t d }
|
s dtI tK v }
| & d r tO t d
}n!tQ | dt d d|
}tS | ddd dS # 1 swxY w Y dS )a Render Manim scenes contained in IPython cells.
Works as a line or cell magic.
.. hint::
This line and cell magic works best when used in a JupyterLab
environment: while all of the functionality is available for
classic Jupyter notebooks as well, it is possible that videos
sometimes don't update on repeated execution of the same cell
if the scene name stays the same.
This problem does not occur when using JupyterLab.
Please refer to ``_ for more information about JupyterLab
and Jupyter notebooks.
Usage in line mode::
%manim [CLI options] MyAwesomeScene
Usage in cell mode::
%%manim [CLI options] MyAwesomeScene
class MyAweseomeScene(Scene):
def construct(self):
...
Run ``%manim --help`` and ``%manim render --help`` for possible command line interface options.
.. note::
The maximal width of the rendered videos that are displayed in the notebook can be
configured via the ``media_width`` configuration option. The default is set to ``25vw``,
which is 25% of your current viewport width. To allow the output to become as large
as possible, set ``config.media_width = "100%"``.
The ``media_embed`` option will embed the image/video output in the notebook. This is
generally undesirable as it makes the notebooks very large, but is required on some
platforms (notably Google's CoLab, where it is automatically enabled unless suppressed
by ``config.embed = False``) and needed in cases when the notebook (or converted HTML
file) will be moved relative to the video locations. Use-cases include building
documentation with Sphinx and JupyterBook. See also the :mod:`manim directive for Sphinx
`.
Examples
--------
First make sure to put ``import manim``, or even ``from manim import *``
in a cell and evaluate it. Then, a typical Jupyter notebook cell for Manim
could look as follows::
%%manim -v WARNING --disable_caching -qm BannerExample
config.media_width = "75%"
config.media_embed = True
class BannerExample(Scene):
def construct(self):
self.camera.background_color = "#ece6e2"
banner_large = ManimBanner(dark_theme=False).scale(0.7)
self.play(banner_large.create())
self.play(banner_large.expand())
Evaluating this cell will render and display the ``BannerExample`` scene defined in the body of the cell.
.. note::
In case you want to hide the red box containing the output progress bar, the ``progress_bar`` config
option should be set to ``None``. This can also be done by passing ``--progress_bar None`` as a
CLI flag.
z-hz--helpz --versionFmanim)standalone_mode prog_nameNr r )OpenGLRenderer scene_names)renderer output_filezNo output file produced media_dirjupyterT)parentsexist_ok media_embedz google.colabimage)filenamez)controls autoplay loop style="max-width: media_widthz;")html_attributesembed)*execsplitlenr
add_additional_args
isinstancedictr getr digest_argsr0 r
OPENGL manim.renderer.opengl_rendererr. renderr clearwindowcloser infor relative_tocwd_generate_file_namesuffixr unlinkparentmkdirshutilcopy mimetypes
guess_typer% r
startswithr r r )r r$ r& r( args
modified_argsr0 r.
SceneClassscene
local_pathtmpfile file_typer; results r" r+ zManimMagic.manim' s b
%T8$$$::<r| s O O " " " " " "
, , , , , , , , , , 6 6 6 6 6 6 $ $ $ $ $ $ .pC######>>>>>> 6555555555
aC aC aC aC aCV aC aC \aC aC D R s "A< <BB