# -*- coding: utf-8 -*-
# 示例 2.1：Paragraph 的行间距 line_spacing（对应视频 20240826201304000）
# 本地复现：manim -qh 20240826201304000.py LineSpacingDemo
# 知识点：Paragraph(*text) 里每个字符串就是一行；line_spacing 控制行与行的垂直距离，
#         默认 -1 由 Manim 自动取值，数值越大段落越高。它只改行距，不改字号和字形。
# 中文注意：Paragraph 基于 Text，含中文必须显式指定中文字体，否则会渲染成白色方块。
from manim import *
# STLiti = 华文隶书（C:\Windows\Fonts\STLITI.TTF）；西文等宽字体不含中文字形。
FONT = "STLiti"
# 三行故意写成不同长度，行距变化时更容易看出各行垂直位置的变化。
LINES = ("第一行：内容中等内容中等", "第二行：内容短", "第三行：内容较长内容较长内容较长")
# t2c 是 Text 的参数，Paragraph 同样支持：按子串给字符上色，三行一眼可分。
COLORS = {"第一行": RED, "第二行": BLUE, "第三行": GREEN}
class LineSpacingDemo(Scene):
    def construct(self):
        title = Text("Paragraph 行间距 line_spacing", font=FONT, font_size=44)
        title.to_edge(UP, buff=0.45)
        # 固定参考框：三档行距都在同一个框里展示，方便对比段落总高度。
        frame = Rectangle(width=10.2, height=3.6, color="#9AA0A6", stroke_width=2)
        frame.shift(DOWN * 0.45)
        self.play(FadeIn(title, shift=DOWN * 0.2), Create(frame), run_time=0.7)
        cases = [(0.5, "0.5 紧凑", "行距约 0.5 倍字高，三行贴得很近"),
                 (1.5, "1.5 适中", "行距约 1.5 倍，阅读比较舒服"),
                 (2.5, "2.5 宽松", "行距约 2.5 倍，段落明显变高")]
        for sp, label, tip in cases:
            # line_spacing 是构造参数，不能事后修改，所以每档都新建一个 Paragraph。
            para = Paragraph(*LINES, line_spacing=sp, font=FONT, font_size=32, t2c=COLORS)
            para.move_to(frame)
            badge = Text("line_spacing = " + str(sp) + "   " + label, font=FONT, font_size=30, color=YELLOW)
            badge.next_to(frame, DOWN, buff=0.28)
            note = Text(tip, font=FONT, font_size=24, color="#BDC1C6")
            note.next_to(badge, DOWN, buff=0.14)
            self.play(FadeIn(para, shift=UP * 0.12), FadeIn(badge), FadeIn(note), run_time=0.5)
            self.wait(1.0)
            # 前两档淡出，最后一档留在屏上作为完成态（封面取第 5 秒帧）。
            if sp != 2.5:
                self.play(FadeOut(para), FadeOut(badge), FadeOut(note), run_time=0.35)
        self.wait(2.2)
