Skip to content

armgit / manim

Public Imported from GitHub
0

A community-maintained Python framework for creating mathematical animations.

Merge branch 'master' into issue-511

Julian van Doorn299e75631cbb
diff --cc docs/source/changelog.rst
index b32c20400,8da9951c1..8c851adf5
--- a/docs/source/changelog.rst
+++ b/docs/source/changelog.rst
@@@ -33,7 -31,7 +31,8 @@@ Command lin
#. Added a :code:`--verbose` flag
#. You can save the logs to a file by using :code:`--log_to_file`
#. Add experimental javascript rendering with :code:`--use_js_renderer`
+ #. Add :code:`-q/--quality [k|h|m|l]` flag and removed :code:`-m/-l` flags.
+#. Removed :code:`--sound` flag
Config system
diff --cc docs/source/tutorials/configuration.rst
index 3f3db0daa,9cfd0822a..a6fb43f7e
--- a/docs/source/tutorials/configuration.rst
+++ b/docs/source/tutorials/configuration.rst
@@@ -46,81 -46,72 +46,71 @@@ The output looks as follows
.. testoutput::
:options: -ELLIPSIS, +NORMALIZE_WHITESPACE
- usage: manim [-h] [-o OUTPUT_FILE] [-p] [-f] [--leave_progress_bars]
- [-a] [-w] [-s] [-g] [-i] [--disable_caching] [--flush_cache]
- [--log_to_file] [-c BACKGROUND_COLOR]
- [--background_opacity BACKGROUND_OPACITY] [--media_dir MEDIA_DIR]
- [--log_dir LOG_DIR] [--tex_template TEX_TEMPLATE] [--dry_run]
- [-t] [-l] [-m] [-e] [-k] [-r RESOLUTION]
- [-n FROM_ANIMATION_NUMBER] [--config_file CONFIG_FILE]
- [--custom_folders] [-v {DEBUG,INFO,WARNING,ERROR,CRITICAL}]
- [--progress_bar True/False]
- {cfg} ... file [scene_names [scene_names ...]]
-
- Animation engine for explanatory math videos
-
- positional arguments:
- {cfg}
- file path to file holding the python code for the scene
- scene_names Name of the Scene class you want to see
-
- optional arguments:
- -h, --help show this help message and exit
- -o OUTPUT_FILE, --output_file OUTPUT_FILE
- Specify the name of the output file, if it should be
- different from the scene class name
- -p, --preview Automatically open the saved file once its done
- -f, --show_in_file_browser
- Show the output file in the File Browser
- --leave_progress_bars
- Leave progress bars displayed in terminal
- -a, --write_all Write all the scenes from a file
- -w, --write_to_movie Render the scene as a movie file (this is on by
- default)
- -s, --save_last_frame
- Save the last frame only (no movie file is generated)
- -g, --save_pngs Save each frame as a png
- -i, --save_as_gif Save the video as gif
- --disable_caching Disable caching (will generate partial-movie-files
- anyway)
- --flush_cache Remove all cached partial-movie-files
- --log_to_file Log terminal output to file
- -c BACKGROUND_COLOR, --background_color BACKGROUND_COLOR
- Specify background color
- --background_opacity BACKGROUND_OPACITY
- Specify background opacity
- --media_dir MEDIA_DIR
- Directory to store media (including video files)
- --log_dir LOG_DIR Directory to store log files
- --tex_template TEX_TEMPLATE
- Specify a custom TeX template file
- --dry_run Do a dry run (render scenes but generate no output
- files)
- -t, --transparent Render a scene with an alpha channel
- -l, --low_quality Render at low quality
- -m, --medium_quality Render at medium quality
- -e, --high_quality Render at high quality
- -k, --fourk_quality Render at 4K quality
- -r RESOLUTION, --resolution RESOLUTION
- Resolution, passed as "height,width". Overrides the
- -l, -m, -e, and -k flags, if present
- -n FROM_ANIMATION_NUMBER, --from_animation_number FROM_ANIMATION_NUMBER
- Start rendering at the specified animation index,
- instead of the first animation. If you pass in two
- comma separated values, e.g. '3,6', it will end the
- rendering at the second value
- --config_file CONFIG_FILE
- Specify the configuration file
- --custom_folders Use the folders defined in the [custom_folders]
- section of the config file to define the output folder
- structure
- -v {DEBUG,INFO,WARNING,ERROR,CRITICAL}, --verbosity {DEBUG,INFO,WARNING,ERROR,CRITICAL}
- Verbosity level. Also changes the ffmpeg log level
- unless the latter is specified in the config
- --progress_bar True/False
- Display the progress bar
-
- Made with <3 by the manim community devs
- usage: manim [-h] [-o OUTPUT_FILE] [-p] [-f] [--sound] [--leave_progress_bars] [-a] [-w] [-s] [-g] [-i] [--disable_caching] [--flush_cache] [--log_to_file] [-c BACKGROUND_COLOR]
++ usage: manim [-h] [-o OUTPUT_FILE] [-p] [-f] [--leave_progress_bars] [-a] [-w] [-s] [-g] [-i] [--disable_caching] [--flush_cache] [--log_to_file] [-c BACKGROUND_COLOR]
+ [--background_opacity BACKGROUND_OPACITY] [--media_dir MEDIA_DIR] [--log_dir LOG_DIR] [--tex_template TEX_TEMPLATE] [--dry_run] [-t] [-q {k,h,m,l}] [--low_quality] [--medium_quality]
+ [--high_quality] [--fourk_quality] [-r RESOLUTION] [-n FROM_ANIMATION_NUMBER] [--use_js_renderer] [--js_renderer_path JS_RENDERER_PATH] [--config_file CONFIG_FILE] [--custom_folders]
+ [-v {DEBUG,INFO,WARNING,ERROR,CRITICAL}] [--progress_bar True/False]
+ {cfg} ... file [scene_names [scene_names ...]]
+
+ Animation engine for explanatory math videos
+
+ positional arguments:
+ {cfg}
+ file path to file holding the python code for the scene
+ scene_names Name of the Scene class you want to see
+
+ optional arguments:
+ -h, --help show this help message and exit
+ -o OUTPUT_FILE, --output_file OUTPUT_FILE
+ Specify the name of the output file, if it should be different from the scene class name
+ -p, --preview Automatically open the saved file once its done
+ -f, --show_in_file_browser
+ Show the output file in the File Browser
- --sound Play a success/failure sound
+ --leave_progress_bars
+ Leave progress bars displayed in terminal
+ -a, --write_all Write all the scenes from a file
+ -w, --write_to_movie Render the scene as a movie file (this is on by default)
+ -s, --save_last_frame
+ Save the last frame only (no movie file is generated)
+ -g, --save_pngs Save each frame as a png
+ -i, --save_as_gif Save the video as gif
+ --disable_caching Disable caching (will generate partial-movie-files anyway)
+ --flush_cache Remove all cached partial-movie-files
+ --log_to_file Log terminal output to file
+ -c BACKGROUND_COLOR, --background_color BACKGROUND_COLOR
+ Specify background color
+ --background_opacity BACKGROUND_OPACITY
+ Specify background opacity
+ --media_dir MEDIA_DIR
+ Directory to store media (including video files)
+ --log_dir LOG_DIR Directory to store log files
+ --tex_template TEX_TEMPLATE
+ Specify a custom TeX template file
+ --dry_run Do a dry run (render scenes but generate no output files)
+ -t, --transparent Render a scene with an alpha channel
+ -q {k,h,m,l}, --quality {k,h,m,l}
+ Render at specific quality, short form of the --*_quality flags
+ --low_quality Render at low quality
+ --medium_quality Render at medium quality
+ --high_quality Render at high quality
+ --fourk_quality Render at 4K quality
+ -r RESOLUTION, --resolution RESOLUTION
+ Resolution, passed as "height,width". Overrides any quality flags, if present
+ -n FROM_ANIMATION_NUMBER, --from_animation_number FROM_ANIMATION_NUMBER
+ Start rendering at the specified animation index, instead of the first animation. If you pass in two comma separated values, e.g. '3,6', it will end the rendering at the second
+ value
+ --use_js_renderer Render animations using the javascript frontend
+ --js_renderer_path JS_RENDERER_PATH
+ Path to the javascript frontend
+ --config_file CONFIG_FILE
+ Specify the configuration file
+ --custom_folders Use the folders defined in the [custom_folders] section of the config file to define the output folder structure
+ -v {DEBUG,INFO,WARNING,ERROR,CRITICAL}, --verbosity {DEBUG,INFO,WARNING,ERROR,CRITICAL}
+ Verbosity level. Also changes the ffmpeg log level unless the latter is specified in the config
+ --progress_bar True/False
+ Display the progress bar
+
+ Made with <3 by the manim community devs
For example, to render a scene in high quality, but only output the last frame
of the scene instead of the whole video, you can execute