diff --git a/docs/source/faq.md b/docs/source/faq.md index 08cba47..aff2c73 100644 --- a/docs/source/faq.md +++ b/docs/source/faq.md @@ -17,19 +17,45 @@ your own issue or discussion on GitHub! Everything related to installing Manim-Slides. Please do not forget the carefully read through -the ... page! - -### +the [installation](/installation) page! ## Rendering -## +Questions related to `manim-slides render [SCENES]...`, + +### I cannot render with ManimGL + +ManimGL support is only garanteed to work +on a very minimal set of versions, because it differs quite a lot from ManimCE, +and its development is not very active. + +The typical issues are that (1) ManimGL needs an outdated NumPy version +and (2) ManimGL **should not** be installed from the GitHub repository, +at least not from the `main` branch, but from a version released to PyPI. + +To solve the NumPy issue, you can safely downgrade NumPy to a version supported +by ManimGL, +while ignoring the possible *conflicting dependencies* messages from `pip` (or else). ### Presenting +Questions related to `manim-slides present [SCENES]...`, +or `manim-slides [SCENES]...` for short. +### Can I have interactive slides -## F.A.Q +No. Slides are pre-rendered static videos files +and cannot be modified on the fly. + +If you need new to have some kind of interactive, look +at the preview feature coupled with the OpenGL renderer +with ManimCE or ManimGL. + +### Slides go black when video finishes + +This is an issue with Qt, +which cannot be solve on all platforms and Python versions, +see [#293](https://github.com/jeertmans/manim-slides/issues/293). ### How to increase quality on Windows @@ -41,7 +67,56 @@ in [#20](https://github.com/jeertmans/manim-slides/issues/20), the problem can be addressed by changing the scaling factor to 100%:
-
+