Manim — это движок для точных программных анимаций, предназначенный для создания обучающих видео по математике.

Существует две версии manim. Этот репозиторий начинался как личный проект автора 3Blue1Brown с целью анимации этих видео, код для видео доступен здесь. В 2020 году группа разработчиков создала его форк, который теперь является версией сообщества с целью обеспечения большей стабильности, лучшего тестирования, более быстрой реакции на вклад сообщества и более дружественного начала работы. Подробнее см. на этой странице.

Установка

ВНИМАНИЕ: Эти инструкции предназначены только для ManimGL. Попытка использовать эти инструкции для установки [ManimCommunity/manim] или инструкции оттуда для установки этой версии вызовет проблемы. Сначала решите, какую версию вы хотите установить, а затем следуйте инструкциям для желаемой версии.

Примечание: Чтобы установить manim напрямую через pip, обратите внимание на название установленного пакета. Это репозиторий ManimGL от 3b1b. Имя пакета — manimgl, а не manim или manimlib. Пожалуйста, используйте pip install manimgl для установки версии из этого репозитория.

Manim работает на Python 3.7 или выше.

Системные требования: FFmpeg, OpenGL и LaTeX (необязательно, если вы хотите использовать LaTeX). Для Linux требуются Pango вместе с его заголовочными файлами разработки. См. инструкцию здесь.

Непосредственно

# Установить manimgl
pip install manimgl

# Протестировать
manimgl

Для получения дополнительных опций ознакомьтесь с разделами «Использование manim» ниже.

Если вы хотите взломать сам manimlib, клонируйте этот репозиторий и в этом каталоге выполните:

# Установить manimgl
pip install -e .

# Протестировать
manimgl example_scenes.py OpeningManimExample
или
manim-render example_scenes.py OpeningManimExample

Непосредственно (Windows)

1. Установите FFmpeg.
2. Установите дистрибутив LaTeX. Рекомендуется MiKTeX.
3. Установите остальные пакеты Python.

   git clone https://github.com/3b1b/manim.git
   cd manim
   pip install -e .
   manimgl example_scenes.py OpeningManimExample

Mac OSX

1. Установите FFmpeg и LaTeX в терминале с помощью homebrew.

   brew install ffmpeg mactex

2. Установите последнюю версию manim с помощью этой команды.

   git clone https://github.com/3b1b/manim.git
   cd manim
   pip install -e .
   manimgl example_scenes.py OpeningManimExample

Anaconda Install

1. Установите LaTeX, как описано выше.
2. Создайте среду conda с помощью conda create -n manim python=3.8.
3. Активируйте среду с помощью conda activate manim.
4. Установите manimgl с помощью pip install -e .

Использование manim

Попробуйте запустить следующее:

manimgl example_scenes.py OpeningManimExample

Это должно открыть окно с простой сценой. Флаги включают:

• -w для записи сцены в файл;
• -o для записи сцены в файл и открытия результата;
• -s для перехода к концу и просто показа финального кадра.
  • -so сохранит финальный кадр в виде изображения и покажет его;
• -n <число> для перехода вперёд к n-ой анимации сцены;
• -f для перевода окна воспроизведения в полноэкранный режим.

Обратите внимание на custom_config.yml для дальнейшей настройки. Чтобы добавить свою настройку, вы можете либо отредактировать этот файл, либо добавить другой файл с тем же именем «custom_config.yml» в любой каталог, из которого вы запускаете manim. Например, этот для видео 3blue1brown. Там вы можете указать, куда должны выводиться видео, где manim должен искать файлы изображений и звуков, которые вы хотите прочитать, и другие значения по умолчанию, касающиеся стиля и качества видео.

Просмотрите примеры сцен, чтобы понять, как это используется, и не стесняйтесь просматривать код, стоящий за видео 3blue1brown, для гораздо большего набора примеров. Обратите внимание, однако, что в библиотеку часто вносятся изменения без учёта обратной совместимости со старыми видео. Чтобы запустить старый проект с гарантией того, что он будет работать, вам придётся вернуться к коммиту, который завершил этот проект.

Документация

Документация находится в разработке на 3b1b.github.io/manim. Также существует китайская версия, поддерживаемая @manim-kindergarten: docs.manim.org.cn (на китайском языке).

manim-kindergarten написал и собрал несколько полезных дополнительных классов и кодов видео в репозитории manim_sandbox.

Вклад

Всегда приветствуется. Как упоминалось выше, у community edition наиболее активная экосистема для вкладов, с тестированием и непрерывной интеграцией, но запросы на вытягивание также приветствуются здесь. Пожалуйста, объясните мотивацию для данного изменения и примеры его эффекта.

Лицензия

Этот проект подпадает под действие лицензии MIT.