From cc25699a55fc685728f7c8bfe0d4bc9140b7c2be Mon Sep 17 00:00:00 2001 From: jkjkil4 <1173374788@qq.com> Date: Mon, 27 May 2024 09:31:52 +0800 Subject: [PATCH] feat: `ApplyWave` & `WiggleOutThenIn` --- .../_static/videos/ApplyWaveExample.mp4 | Bin 0 -> 49078 bytes .../_static/videos/WiggleOutThenInExample.mp4 | Bin 0 -> 81481 bytes doc/source/autodoc.py | 1 - doc/source/janim/anims/indication.rst | 45 ++++++++- doc/source/janim/anims/modules.rst | 1 + doc/source/janim/anims/movement.rst | 8 ++ janim/anims/indication.py | 92 +++++++++++++++++- janim/anims/movement.py | 3 + 8 files changed, 141 insertions(+), 9 deletions(-) create mode 100644 doc/source/_static/videos/ApplyWaveExample.mp4 create mode 100644 doc/source/_static/videos/WiggleOutThenInExample.mp4 create mode 100644 doc/source/janim/anims/movement.rst diff --git a/doc/source/_static/videos/ApplyWaveExample.mp4 b/doc/source/_static/videos/ApplyWaveExample.mp4 new file mode 100644 index 0000000000000000000000000000000000000000..23f4f8ffea79c8b824eb144173b26bf9ee774abe GIT binary patch literal 49078 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 Mb}oK)P7aR$1Kk$jrT_o{ literal 0 HcmV?d00001 diff --git a/doc/source/_static/videos/WiggleOutThenInExample.mp4 b/doc/source/_static/videos/WiggleOutThenInExample.mp4 new file mode 100644 index 0000000000000000000000000000000000000000..33416b46f58f20c4e7eb62e9cbf50d1818da0e7c GIT binary patch literal 81481 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ƾpKuT; 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 literal 0 HcmV?d00001 diff --git a/doc/source/autodoc.py b/doc/source/autodoc.py index 8ba0605..558616b 100644 --- a/doc/source/autodoc.py +++ b/doc/source/autodoc.py @@ -68,7 +68,6 @@ def _generate_autodoc_file(module_path: str, filename: str, rst_path: str) -> st name = filename[:-3] module_name = f'{module_path}.{name}' if module_name in generate_autodoc_exclude: - print(module_name) return None rst_file_path = os.path.join(rst_path, f'{name}.rst') diff --git a/doc/source/janim/anims/indication.rst b/doc/source/janim/anims/indication.rst index 7532984..ab9bada 100644 --- a/doc/source/janim/anims/indication.rst +++ b/doc/source/janim/anims/indication.rst @@ -235,7 +235,46 @@ indication self.forward(0.3) -.. # TODO: ApplyWave -.. # TODO: WiggleOutThenIn -.. # TODO: TurnInsideOut +.. autoclass:: janim.anims.indication.ApplyWave + :show-inheritance: + +.. janim-example:: ApplyWaveExample + :media: ../../_static/videos/ApplyWaveExample.mp4 + + from janim.imports import * + + class ApplyWaveExample(Timeline): + def construct(self): + group = Group( + Square(fill_alpha=0.5), + Circle(fill_alpha=0.5), + Text('Text', font_size=48), + color=BLUE + ).show() + group.points.scale(1.5).arrange(RIGHT, buff=2) + + self.play(*map(ApplyWave, group)) + self.forward() + +.. autoclass:: janim.anims.indication.WiggleOutThenIn + :show-inheritance: + +.. janim-example:: WiggleOutThenInExample + :media: ../../_static/videos/WiggleOutThenInExample.mp4 + + from janim.imports import * + + class WiggleOutThenInExample(Timeline): + def construct(self) -> None: + group = Group( + Square(fill_alpha=0.5), + Circle(fill_alpha=0.5), + Text('Text', font_size=48), + color=BLUE + ).show() + group.points.scale(1.5).arrange(RIGHT, buff=2) + + self.play(*map(WiggleOutThenIn, group)) + self.forward() + .. # TODO: FlashyFadeIn diff --git a/doc/source/janim/anims/modules.rst b/doc/source/janim/anims/modules.rst index 11820a4..e068ced 100644 --- a/doc/source/janim/anims/modules.rst +++ b/doc/source/janim/anims/modules.rst @@ -13,6 +13,7 @@ anims fading growing indication + movement rotation timeline transform diff --git a/doc/source/janim/anims/movement.rst b/doc/source/janim/anims/movement.rst new file mode 100644 index 0000000..13e3059 --- /dev/null +++ b/doc/source/janim/anims/movement.rst @@ -0,0 +1,8 @@ +movement +======== + +.. automodule:: janim.anims.movement + :members: + :undoc-members: + :show-inheritance: + diff --git a/janim/anims/indication.py b/janim/anims/indication.py index 6e0bcad..d778a7a 100644 --- a/janim/anims/indication.py +++ b/janim/anims/indication.py @@ -1,15 +1,18 @@ from __future__ import annotations +import math + import numpy as np from janim.anims.animation import Animation from janim.anims.composition import AnimGroup, Succession from janim.anims.creation import Create, ShowPartial from janim.anims.fading import FadeOut +from janim.anims.movement import Homotopy from janim.anims.updater import DataUpdater, UpdaterParams from janim.components.rgbas import Cmpt_Rgbas from janim.constants import (C_LABEL_ANIM_ABSTRACT, C_LABEL_ANIM_INDICATION, - GREY, ORIGIN, RIGHT, TAU, YELLOW) + GREY, ORIGIN, RIGHT, TAU, UP, YELLOW) from janim.items.geometry.arc import Circle, Dot from janim.items.geometry.line import Line from janim.items.item import Item @@ -19,7 +22,7 @@ from janim.typing import JAnimColor, Vect from janim.utils.bezier import interpolate from janim.utils.config import Config -from janim.utils.rate_functions import RateFunc, smooth, there_and_back +from janim.utils.rate_functions import RateFunc, smooth, there_and_back, wiggle class FocusOn(DataUpdater[Dot]): @@ -324,7 +327,86 @@ def create_lines(self) -> Group: return lines -# TODO: ApplyWave -# TODO: WiggleOutThenIn -# TODO: TurnInsideOut +class ApplyWave(Homotopy): + label_color = C_LABEL_ANIM_INDICATION + + def __init__( + self, + item: Item, + direction: Vect = UP, + amplitude: float = 0.2, + *, + duration: float = 1.0, + root_only: bool = False, + **kwargs + ): + if root_only: + box = item(Points).points.self_box + else: + box = item(Points).points.box + + left_x = box.left[0] + right_x = box.right[0] + vect = amplitude * direction + + def homotopy(x, y, z, t): + alpha = (x - left_x) / (right_x - left_x) + power = math.exp(2.0 * (alpha - 0.5)) + nudge = there_and_back(t**power) + return np.array([x, y, z]) + nudge * vect + + super().__init__( + item, + homotopy, + duration=duration, + **kwargs + ) + + +class WiggleOutThenIn(DataUpdater): + label_color = C_LABEL_ANIM_INDICATION + + def __init__( + self, + item: Item, + *, + scale: float = 1.1, + angle: float = 0.01 * TAU, + n_wiggles: int = 6, + scale_about_point: Vect | None = None, + rotate_about_point: Vect | None = None, + duration: float = 2, + root_only: bool = False, + **kwargs + ): + if root_only: + box = item(Points).points.self_box + else: + box = item(Points).points.box + self.scale = scale + self.angle = angle + self.n_wiggles = n_wiggles + self.scale_about_point = scale_about_point or box.center + self.rotate_about_point = rotate_about_point or box.center + super().__init__( + item, + self.updater, + duration=duration, + root_only=root_only, + **kwargs + ) + + def updater(self, data: Item, p: UpdaterParams) -> None: + if not isinstance(data, Points): + return + data.points.scale( + interpolate(1, self.scale, there_and_back(p.alpha)), + about_point=self.scale_about_point + ) + data.points.rotate( + wiggle(p.alpha, self.n_wiggles) * self.angle, + about_point=self.rotate_about_point + ) + + # TODO: FlashyFadeIn diff --git a/janim/anims/movement.py b/janim/anims/movement.py index f9f5b5c..a7159f8 100644 --- a/janim/anims/movement.py +++ b/janim/anims/movement.py @@ -4,6 +4,7 @@ import numpy as np from janim.anims.updater import DataUpdater, UpdaterParams +from janim.constants import C_LABEL_ANIM_STAY from janim.items.item import Item from janim.items.points import Points from janim.items.vitem import VItem @@ -66,6 +67,8 @@ def homotopy(x, y, z, t): class MoveAlongPath(DataUpdater): + label_color = C_LABEL_ANIM_STAY + def __init__( self, item: Item,