manim

Manim é um mecanismo para animações programáticas precisas, projetadas para criar vídeos de matemática explicativos.

Observe que existem duas versões de Manim. Esse repositório começou como um projeto pessoal do autor do 3Blue1Brown com o objetivo de animar esses vídeos, com código específico de vídeo disponível aqui. Em 2020, um grupo de desenvolvedores o empurrou para o que agora é a edição da comunidade, com o objetivo de ser mais estável, melhor testado, mais rápido em responder às contribuições da comunidade e com mais amigas para começar. Veja esta página para obter mais detalhes.

Instalação

AVISO: Essas instruções são apenas para Manimgl. Tentar usar essas instruções para instalar o ManimCommunity/Manim ou as instruções para instalar esta versão causará problemas. Você deve primeiro decidir qual versão deseja instalar e siga apenas as instruções para a versão desejada.

Nota : Para instalar o Manim diretamente através do PIP, preste atenção ao nome do pacote instalado. Este repositório é Manimgl de 3b1b. O nome do pacote é manimgl em vez de manim ou manimlib . Por favor, use pip install manimgl para instalar a versão neste repositório.

Manim corre no Python 3.7 ou superior.

Os requisitos do sistema são FFMPEG, OpenGL e LATEX (opcional, se você deseja usar o LATEX). Para Linux, são necessários Pango, juntamente com seus cabeçalhos de desenvolvimento. Veja a instrução aqui.

Diretamente

 # Install manimgl
pip install manimgl

# Try it out
manimgl

Para obter mais opções, consulte as seções de uso do Manim mais adiante.

Se você deseja invadir o próprio Manimlib, clone este repositório e nesse diretório execute:

 # Install manimgl
pip install -e .

# Try it out
manimgl example_scenes.py OpeningManimExample
# or
manim-render example_scenes.py OpeningManimExample

Diretamente (Windows)

1. Instale o ffmpeg.
2. Instale uma distribuição de látex. Miktex é recomendado.
3. Instale os pacotes Python restantes.

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

Mac OSX

1. Instale o FFMPEG, látex no terminal usando homebrew.

   brew install ffmpeg mactex

2. Instale a versão mais recente do manim usando estes comando.

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

ANACONDA instalação

1. Instale o látex como acima.
2. Create a conda environment using conda create -n manim python=3.8 .
3. Ative o ambiente usando conda activate manim .
4. Instale o manimgl usando pip install -e . .

Usando manim

Tente executar o seguinte:

manimgl example_scenes.py OpeningManimExample

Isso deve aparecer uma janela tocando uma cena simples.

Veja as cenas de exemplo para ver exemplos da sintaxe, tipos de animação e tipos de objetos da biblioteca. No repositório 3B1B/Videos, você pode ver todo o código para vídeos 3Blue1Brown, embora o código de vídeos mais antigos possa não ser compatível com a versão mais recente do Manim. O ReadMe desse repo também descreve alguns detalhes sobre como configurar um fluxo de trabalho mais interativo, como mostrado neste vídeo de demonstração de Manim, por exemplo.

Ao executar na CLI, algumas bandeiras úteis incluem:

• -w para escrever a cena em um arquivo
• -o para escrever a cena em um arquivo e abrir o resultado
• -s para pular até o final e apenas mostre o quadro final.
  • -so salvará o quadro final em uma imagem e mostrará
• -n <number> para pular para n animação de uma cena.
• -f para fazer a janela de reprodução de tela cheia

Dê uma olhada no custom_config.yml para uma configuração adicional. Para adicionar sua personalização, você pode editar este arquivo ou adicionar outro arquivo com o mesmo nome "Custom_config.yml" a qualquer diretório da qual você esteja executando Manim. Por exemplo, este é o para os vídeos 3Blue1Brown. Lá você pode especificar para onde os vídeos devem ser exibidos, onde o Manim deve procurar arquivos de imagem e sons que você deseja ler e outros padrões sobre a qualidade do estilo e do vídeo.

Documentação

A documentação está em andamento em 3b1b.github.io/manim. E também há uma versão chinesa mantida por @manim-kindergarten : docs.manim.org.cn (em chinês).

Manim-Kindergarten escreveu e coletou algumas classes extras úteis e alguns códigos de vídeos no repo Manim_sandbox.

Contribuindo

É sempre bem -vindo. Como mencionado acima, a edição comunitária possui o ecossistema mais ativo para contribuições, com testes e integração contínua, mas as solicitações de tração também são bem -vindas aqui. Explique a motivação para uma determinada mudança e exemplos de seu efeito.

Licença

Este projeto se enquadra na licença do MIT.