追踪与边界¶

"拖尾轨迹"和"流动边框"是讲解演示中最常用的两类装饰效果：TracedPath 记录一个点的运动轨迹，AnimatedBoundary 给图形加上不断流动的彩色描边。

TracedPath¶

TracedPath(traced_point_func, stroke_width=2, stroke_color=ManimColor('#FFFFFF'), dissipating_time=None, **kwargs) 官方文档 ↗

TracedPath(traced_point_func) 是一条特殊的 VMobject：内部维护一个 updater，每帧取当前点追加到自身点列，从而把"某个点的运动路径"画出来。

TracedPath(
    traced_point_func: Callable,
    stroke_width: float = 2,
    stroke_color: ParsableManimColor | None = WHITE,
    dissipating_time: float | None = None,
    **kwargs,
)

name	type	default	desc
`traced_point_func`	Callable	—	返回一个点坐标的函数；通常传方法引用如 `dot.get_center`（不要加括号）
`stroke_width`	float	2	轨迹线宽
`stroke_color`	color \| None	WHITE	轨迹颜色；None 表示不描边
`dissipating_time`	float \| None	None	消散时长：超过该时间的轨迹段逐渐消失；None 表示永久保留

AnimatedBoundary¶

AnimatedBoundary(vmobject, colors=[ManimColor('#29ABCA'…, max_stroke_width=3, cycle_rate=0.5, back_and_forth=True, draw_rate_func=<function smooth at 0…, fade_rate_func=<function smooth at 0…, **kwargs) 官方文档 ↗

AnimatedBoundary(vmobject) 给目标图形生成一圈流动的彩色描边：多层颜色不同的描边依次显现、消失，形成"边界在流动"的视觉效果。它本身是一个 VGroup，由若干描边副本组成。

AnimatedBoundary(
    vmobject: VMobject,
    colors: Sequence[color] = [#29ABCA, #9CDCEB, #236B8E, #736357],
    max_stroke_width: float = 3,
    cycle_rate: float = 0.5,
    back_and_forth: bool = True,
    draw_rate_func: RateFunction = smooth,
    fade_rate_func: RateFunction = smooth,
    **kwargs,
)

name	type	default	desc
`colors`	Sequence[color]	四种蓝灰色	参与流动的描边颜色
`max_stroke_width`	float	3	描边最大线宽
`cycle_rate`	float	0.5	每层颜色完成一次显现/消失的速率
`back_and_forth`	bool	True	线宽是否来回脉动

TracedPath 让黄点绕圆一周的轨迹留下 2 秒渐散的拖尾；AnimatedBoundary 给右侧正方形加上流动的蓝灰描边。

查看源码 tracing.py

"""TracingAndBoundary: TracedPath 拖尾轨迹，AnimatedBoundary 流动边界。"""

from manim import *


class TracingAndBoundary(Scene):
    def construct(self):
        dot = Dot(LEFT * 2)
        self.add(dot)
        self.add(
            TracedPath(
                dot.get_center,
                stroke_color=YELLOW,
                stroke_width=4,
                dissipating_time=2,  # 2 秒前的轨迹逐渐消散
            )
        )
        self.play(MoveAlongPath(dot, Circle(radius=2)), run_time=2.5)

        square = Square().shift(RIGHT * 3.2)
        self.add(square, AnimatedBoundary(square))
        self.wait(1.5)

常见错误

TracedPath 必须先 self.add(...) 进场景，否则它的 updater 不会执行，画面里只有运动、没有轨迹。另外传点函数时写成 dot.get_center（方法引用）而不是 dot.get_center()（调用结果）——后者只记录了添加那一刻的位置，轨迹变成一条死线。

提示

TracedPath 常与 MoveAlongPath、Rotating 或 updater 驱动的点搭配：先创建会动的点，再让轨迹跟随它。dissipating_time 适合表现"最近路径"，设为 None 则适合保留完整轨迹（如几何作图）。

自测¶

下一步¶

轨迹让"走过的路"可见，下一节让物体沿任意路径运动、或被任意形变：MoveAlongPath 与 Homotopy 家族。