from manim import *
class LabeledArrowDemo(Scene):
    """3.4 LabeledArrow 在箭头中点放一个标签。
    Manim CE 0.21 的写法与旧教程不同，务必注意：
      * 字符串 label 交给 MathTex 渲染 -> 适合公式；
      * 中文 label 必须传 Text(..., font="STLiti") 对象，
        否则 LaTeX 编译阶段就会抛 Unicode 错误；
      * 字号 / 颜色走 label_config，底框走 box_config，边框走 frame_config；
      * 旧写法 font_size=、label_color=、label_frame=、frame_fill_color=
        会被透传给 Mobject，在 0.21 直接 TypeError。
    """
    def construct(self):
        title = Text("带标签的箭头：", font="STLiti",
                     font_size=34, color=YELLOW).to_edge(UP, buff=0.45)
        rule = Line(6.4 * LEFT, 6.4 * RIGHT, color=BLUE)
        rule.next_to(title, DOWN, buff=0.25)
        self.play(Write(title), Create(rule), run_time=0.9)
        start, end = 3.2 * LEFT, 3.2 * RIGHT
        # ① 公式标签：字符串自动交给 MathTex
        a1 = LabeledArrow(label=r"y = kx + b", start=start, end=end)
        # ② 中文标签：传 Text 对象，中文字体用 STLiti（隶书）
        a2 = LabeledArrow(
            label=Text("中文说明", font="STLiti", font_size=28),
            start=start, end=end,
        )
        # ③ 红色公式 + 隐藏边框（等价于旧版 label_frame=False）
        a3 = LabeledArrow(
            label=r"z = \sqrt{x^2 + y^2}",
            label_config={"color": RED, "font_size": 32},
            start=start, end=end,
        )
        a3.label.frame.set_stroke(opacity=0)
        # ④ 绿色底框：box_config 控制标签背后的填充矩形
        a4 = LabeledArrow(
            label=Text("标签背景", font="STLiti", font_size=28),
            box_config={"color": GREEN, "fill_opacity": 0.8},
            start=start, end=end,
        )
        arrows = VGroup(a1, a2, a3, a4).arrange(DOWN, buff=0.75)
        arrows.shift(DOWN * 0.55)
        self.play(LaggedStart(*[Create(a) for a in arrows], lag_ratio=0.32),
                  run_time=2.8)
        self.wait(2.2)
