Merge remote-tracking branch 'origin/main' into color_fix

Author: behackl

.pre-commit-config.yaml

@@ -35,7 +35,7 @@ repos:
       - id: python-check-blanket-noqa
         name: Precision flake ignores
   - repo: https://github.com/psf/black
-    rev: 23.1.0
+    rev: 23.3.0
     hooks:
       - id: black
   - repo: https://github.com/asottile/blacken-docs
@@ -58,7 +58,7 @@ repos:
             flake8-simplify==0.14.1,
           ]
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.1.1
+    rev: v1.2.0
     hooks:
       - id: mypy
         additional_dependencies:

CITATION.cff

@@ -4,10 +4,10 @@ authors:
   -
     name: "The Manim Community Developers"
 cff-version: "1.2.0"
-date-released: 2022-12-26
+date-released: 2023-04-06
 license: MIT
 message: "We acknowledge the importance of good software to support research, and we note that research becomes more valuable when it is communicated effectively. To demonstrate the value of Manim, we ask that you cite Manim in your work."
 title: Manim – Mathematical Animation Framework
 url: "https://www.manim.community/"
-version: "v0.17.2"
+version: "v0.17.3"
 ...

docs/source/_static/logo.png

@@ -5,6 +5,7 @@ Changelog
 
 .. toctree::
 
+    changelog/0.17.3-changelog
     changelog/0.17.2-changelog
     changelog/0.17.1-changelog
     changelog/0.17.0-changelog

docs/source/changelog.rst

@@ -0,0 +1,207 @@
+*******
+v0.17.3
+*******
+
+:Date: April 06, 2023
+
+Contributors
+============
+
+A total of 35 people contributed to this
+release. People with a '+' by their names authored a patch for the first
+time.
+
+* Alex Lembcke
+* Benjamin Hackl
+* DegrangeM +
+* Elyanah Aco +
+* Francisco Manríquez Novoa
+* Fredrik Lundström +
+* Frédéric Crozatier
+* Ikko Eltociear Ashimine +
+* ItIsJoeyG +
+* JinchuLi2002 +
+* Kevin Lubick
+* KingAndCross +
+* M. A. Ali +
+* Matthew Lee +
+* Max Coplan +
+* Naveen M K
+* NotWearingPants
+* Oscar Rangel +
+* Papierkorb2292 +
+* Phoenix2157 +
+* Tristan Schulz
+* ciobaca +
+* coreyp1 +
+* davidot +
+* icedcoffeeee
+* karpfediem +
+* vahndi
+
+
+The patches included in this release have been reviewed by
+the following contributors.
+
+* Benjamin Hackl
+* Fredrik Lundström
+* Frédéric Crozatier
+* Hugues Devimeux
+* Kevin Lubick
+* KingAndCross
+* Matthew Lee
+* Naveen M K
+* Tristan Schulz
+* coreyp1
+* davidot
+* strager
+
+Pull requests merged
+====================
+
+A total of 42 pull requests were merged for this release.
+
+Deprecated classes and functions
+--------------------------------
+
+* :pr:`3103`: Removed deprecated function ``OpenGLSurface.set_fill_by_value``
+
+
+New features
+------------
+
+* :pr:`2974`: Added :class:`.DiGraph`, a mobject representing directed graphs
+
+
+* :pr:`3042`: Added :meth:`.Scene.replace` and use in :class:`.ReplacementTransform`
+
+* :pr:`3155`: Added support for individualized radius values in :meth:`.Polygram.round_corners`
+
+
+* :pr:`3159`: Added :meth:`.set_opacity_by_tex` method for setting the opacity of parts of Tex mobjects
+
+
+* :pr:`3201`: New tip shape :class:`.StealthTip`, allow specifying tip shape of :class:`.NumberLine`
+
+
+Enhancements
+------------
+
+* :pr:`3046`: Add warning if font is not found for Text, Code, and MarkupText
+
+
+* :pr:`3083`: Minor performance improvement in :mod:`.bezier` with preallocating array
+
+
+* :pr:`3092`: Improved :meth:`.Mobject.add` performance by checking for redundancy only once
+
+
+* :pr:`3134`: Performance: Store color data of ``OpenGLSurface`` to prevent OpenGL embed lag
+
+
+* :pr:`3180`: Performance: Speed up width/height/depth calculations by reducing copying
+
+
+* :pr:`3181`: Improved creation time for large :class:`.Text` mobjects
+
+
+* :pr:`3182`: Reduce memory allocations when building :class:`.SVGMobject`
+
+
+* :pr:`3191`: Fixed OpenGL rendering in named threads
+
+
+Fixed bugs
+----------
+
+* :pr:`3015`: Fixed bug with ``label_constructor`` in :meth:`.NumberLine.add_labels`
+
+
+* :pr:`3095`: Fixed ``get_axis_labels`` for :class:`.Axes` and :class:`.ThreeDAxes`
+
+
+* :pr:`3106`: Fixed ignored ``depth_test`` argument for ``OpenGLVMobjects``
+
+
+* :pr:`3149`: Allow to use ``call_updater=True`` in :meth:`.Mobject.add_updater` with non-timebased updaters too
+
+
+* :pr:`3152`: Fixed behavior of :class:`.Wait` and :meth:`.Scene.wait` with specified ``stop_condition``
+
+
+* :pr:`3163`: Fixed :class:`.BraceLabel` not passing additional keyword arguments to :class:`.Brace`
+
+
+* :pr:`3195`: Fixed :class:`.Axes` scaling for :meth:`.plot_implicit_curve`
+
+
+Documentation-related changes
+-----------------------------
+
+* :pr:`3105`: Converted types specified in docstrings to proper type hints in :mod:`.three_dimensions`
+
+
+* :pr:`3108`: Clarified documentation for ``--resolution`` command line flag
+
+
+* :pr:`3109`: Clean-up, type-hints and documentation for :mod:`.three_dimensions`
+
+
+* :pr:`3124`: Fixed docstring of :meth:`.ThreeDCamera.get_value_trackers`
+
+
+* :pr:`3126`: Fixed dead links to troubleshooting page
+
+
+* :pr:`3137`: Fixed example using ``reverse=True`` with :class:`.Write`
+
+
+* :pr:`3160`: Fixed a typo
+
+
+* :pr:`3189`: Corrected the hinted return type for :func:`angle_between_vectors`
+
+
+* :pr:`3199`: Updated ``winget`` command for installing MiKTeX in documentation
+
+
+* :pr:`3204`: Fixed docstring formatting of :meth:`.Scene.replace` and improved its error handling
+
+
+Code quality improvements and similar refactors
+-----------------------------------------------
+
+* :pr:`3144`: Fixed typo in ``stripUntranslatable.awk``
+
+
+* :pr:`3154`: Bump ipython from 8.7.0 to 8.10.0
+
+
+* :pr:`3156`: CI: Remove actions using self-hosted runners
+
+
+* :pr:`3164`: Bump markdown-it-py from 2.1.0 to 2.2.0
+
+
+* :pr:`3165`: Removed deprecated keyword argument in :meth:`.Mobject.align_to`
+
+
+* :pr:`3166`: Made :class:`.ArrowTriangleTip`, :class:`.ArrowTriangleFilledTip` available to module namespace
+
+
+* :pr:`3179`: Fixed deprecation warning in :class:`.ParametricFunction` with ``use_vectorized=True``
+
+
+* :pr:`3186`: Updated extlinks to work with latest version of Sphinx
+
+
+* :pr:`3196`: CI: updated PATH for recent changed in TinyTex
+
+
+* :pr:`3200`: Made import from ``moderngl`` compatible with more recent versions
+
+
+New releases
+------------
+
+* :pr:`3198`: Prepare new release: v0.17.3

docs/source/changelog/0.17.3-changelog.rst

@@ -144,9 +144,11 @@
 }
 
 # opengraph settings
-ogp_image = "https://www.manim.community/logo.png"
 ogp_site_name = "Manim Community | Documentation"
 ogp_site_url = "https://docs.manim.community/"
+ogp_social_cards = {
+    "image": "_static/logo.png",
+}
 
 
 # inheritance_graph settings

docs/source/conf.py

@@ -385,7 +385,7 @@ describing the control points in between ("handles").
 .. hint::
   To learn more about Bézier curves, take a look at the excellent
   online textbook `A Primer on Bézier curves <https://pomax.github.io/bezierinfo/>`__
-  by `Pomax <https://twitter.com/TheRealPomax>`__ -- there is an playground representing
+  by `Pomax <https://twitter.com/TheRealPomax>`__ -- there is a playground representing
   cubic Bézier curves `in §1 <https://pomax.github.io/bezierinfo/#introduction>`__,
   the red and yellow points are "anchors", and the green and blue
   points are "handles".

docs/source/guides/deep_dive.rst

@@ -137,7 +137,7 @@ For Windows, the recommended LaTeX distribution is
 `MiKTeX <https://miktex.org/download>`__. You can install it by using the
 installer from the linked MiKTeX site, or by using the package manager
 of your choice (Chocolatey: ``choco install miktex.install``,
-Scoop: ``scoop install latex``, Winget: ``winget install ChristianSchenk.MiKTeX``).
+Scoop: ``scoop install latex``, Winget: ``winget install MiKTeX.MiKTeX``).
 
 If you are concerned about disk space, there are some alternative,
 smaller distributions of LaTeX.

docs/source/installation/windows.rst

@@ -8,6 +8,9 @@
     "ArrowCircleTip",
     "ArrowSquareTip",
     "ArrowSquareFilledTip",
+    "ArrowTriangleTip",
+    "ArrowTriangleFilledTip",
+    "StealthTip",
 ]
 
 import numpy as np
@@ -30,6 +33,7 @@ class ArrowTip(VMobject, metaclass=ConvertToOpenGL):
         :class:`ArrowCircleFilledTip`
         :class:`ArrowSquareTip`
         :class:`ArrowSquareFilledTip`
+        :class:`StealthTip`
 
     Examples
     --------
@@ -177,6 +181,47 @@ def length(self):
         return np.linalg.norm(self.vector)
 
 
+class StealthTip(ArrowTip):
+    r"""'Stealth' fighter / kite arrow shape.
+
+    Naming is inspired by the corresponding
+    `TikZ arrow shape <https://tikz.dev/tikz-arrows#sec-16.3>`__.
+    """
+
+    def __init__(
+        self,
+        fill_opacity=1,
+        stroke_width=3,
+        length=DEFAULT_ARROW_TIP_LENGTH / 2,
+        start_angle=PI,
+        **kwargs,
+    ):
+        self.start_angle = start_angle
+        VMobject.__init__(
+            self, fill_opacity=fill_opacity, stroke_width=stroke_width, **kwargs
+        )
+        self.set_points_as_corners(
+            [
+                [2, 0, 0],  # tip
+                [-1.2, 1.6, 0],
+                [0, 0, 0],  # base
+                [-1.2, -1.6, 0],
+                [2, 0, 0],  # close path, back to tip
+            ]
+        )
+        self.scale(length / self.length)
+
+    @property
+    def length(self):
+        """The length of the arrow tip.
+
+        In this case, the length is computed as the height of
+        the triangle encompassing the stealth tip (otherwise,
+        the tip is scaled too large).
+        """
+        return np.linalg.norm(self.vector) * 1.6
+
+
 class ArrowTriangleTip(ArrowTip, Triangle):
     r"""Triangular arrow tip."""