用python实现视频中插入各种形式的文本，包括普通文本、数学公式、项目符号列表和标题

本文链接：https://blog.csdn.net/qq_45449625/article/details/141230728

tex_mobject 模块提供了一系列可以使用 LaTeX 渲染文本的类。通过这个模块，你能够在视频中插入各种形式的文本，包括普通文本、数学公式、项目符号列表和标题等。具体类的功能如下：

BulletedList：用于创建带项目符号的列表。
MathTex：专门用于显示数学表达式的 LaTeX 字符串。
SingleStringMathTex：渲染 LaTeX 文本的基本构件。
Tex：用于普通文本的 LaTeX 渲染。

一，类别

1.BulletedList表示一个带有项目符号的列表。

BulletedList 是一个函数，用于创建一个带有项目符号的列表，通常用于动画或视频制作中，以清晰地展示要点。

函数说明

BulletedList(*items, buff=0.5, dot_scale_factor=2, tex_environment=None, **kwargs)

*items：可变参数，传入你希望在列表中展示的项目符号文本，可以是字符串，也可以是其他支持渲染的对象，如 Tex 或 MathTex。
buff：项之间的垂直间距，类型为浮点数，默认值为 0.5。这决定了列表中各项之间的间隔大小。
dot_scale_factor：项目符号的缩放因子，默认值为 2。这个参数控制项目符号点的大小，相对于默认大小的比例。
tex_environment：指定 LaTeX 环境的字符串，默认值为 None。可以用来定义项目符号文本的格式。如果设置了这个参数，项目符号文本将会在指定的 LaTeX 环境中被渲染。
**kwargs：其他关键字参数，可以传递给 Mobject 的构造函数，允许自定义额外的属性或行为。

示例使用

bulleted_list = BulletedList( "第一点", "第二点", "第三点", 
buff=0.5, dot_scale_factor=1.5 )

在这个示例中，BulletedList 将生成一个包含三项的项目符号列表，项目符号点比默认大小稍小，项之间的间距为 0.5。

总结

BulletedList 是一个方便的工具，可以在你的动画或演示中有条理地展示多个内容点，通过参数灵活控制外观和布局。

示例：

from manim import *

class BulletedListExample(Scene):
    def construct(self):
        title = Title(f"BulletedList")
        blist = BulletedList("Item 1", "Item 2", "Item 3", height=2, width=2)
        blist.set_color_by_tex("Item 1", RED)
        blist.set_color_by_tex("Item 2", GREEN)
        blist.set_color_by_tex("Item 3", BLUE)
        
        self.add(blist, title)

2.MathTex用于编译包含 LaTeX 的数学模式字符串。

MathTex 是 Manim 中用于显示 LaTeX 数学公式的类。该类允许用户将 LaTeX 代码渲染为可动画显示的数学公式。以下是对函数及其参数的详细解释：

函数和参数

MathTex(*tex_strings, arg_separator=' ', 
substrings_to_isolate=None, tex_to_color_map=None, 
tex_environment='align*', **kwargs)

参数说明：

*tex_strings：
- 这是一个可变参数，用户可以传入多个 LaTeX 字符串以构建数学公式。每个字符串将在渲染时按顺序连接在一起。
arg_separator（默认值为 ' '）：
- 这个参数定义了多个参数之间的分隔符。默认情况下，它是一个空格，意味着在渲染 LaTeX 时，会将各个部分用空格分隔开。可以根据需要更改为其他字符。
substrings_to_isolate（默认值为 None）：
- 这是一个列表，用于指定需要单独处理的子字符串。当提供这些子字符串时，Manim 会将它们单独处理并允许对其应用特殊格式或颜色。
tex_to_color_map（默认值为 None）：
- 这是一个字典，将 LaTeX 代码中的特定字符串映射到颜色。例如，{'x': RED} 会将所有的 x 字符变为红色。此参数使得在数学公式中可以灵活地设置不同部分的颜色。
tex_environment（默认值为 'align*'）：
- 这个参数指定了 LaTeX 环境的名称。在该环境中渲染数学表达式，align* 使得多个行的公式可以进行对齐。可以根据公式的特定需要选择不同的 LaTeX 环境。
**kwargs：
- 这是一个可变关键字参数，可以传递给 Mobject 的构造函数。这使得可以灵活地设置额外的属性或行为，例如位置、颜色等。

示例使用

math_expr = MathTex( r"E = mc^2", tex_to_color_map={"E": BLUE, "mc^2": GREEN}, 
substrings_to_isolate=["E"] )

在这个示例中，我们创建了一个数学公式 E = mc^2，将 E 设为蓝色，并且 mc^2 设为绿色，且E将在 LaTeX 中单独处理。

总结

MathTex 是一个强大的工具，可以帮助您在 Manim 中优雅地呈现数学表达式。通过灵活的参数设置，您可以控制公式的样式、颜色及其渲染方式，以满足各种动画和演示的需要。

示例：

class Formula(Scene):
    def construct(self):
        title = Title("MathTex",color=RED) 
        t = MathTex(r"\int_a^b f'(x) dx = f(b)- f(a)")
        #self.add(t,title)
        equation = MathTex(
            r"e^x = x^0 + x^1 + \frac{1}{2} x^2 + \frac{1}{6} x^3 + \cdots + \frac{1}{n!} x^n + \cdots",
            substrings_to_isolate="x"
        )
        equation.set_color_by_tex("x", YELLOW)
        equation.set_color_by_tex("\+", RED)
        
        a=Group(t, equation).arrange(DOWN, buff=.8)
        self.add(title,a)

3.SingleStringMathTex用于渲染 LaTeX 文本的基本构建块。

SingleStringMathTex 是 Manim 中用于显示单个字符串 (单个 LaTeX 数学公式) 的类。它类似于 MathTex，但专门用于处理单个字符串的情况。以下是对其参数的详细解释：

函数和参数

SingleStringMathTex(tex_string, stroke_width=0,
 should_center=True, height=None, organize_left_to_right=False,
 tex_environment='align*', tex_template=None, font_size=48, **kwargs)

参数说明：

tex_string：
- 这是要显示的 LaTeX 公式字符串。由于这是一个单字符串版本，因此不支持多个字符串。
stroke_width（默认值为 0）：
- 这个参数定义了公式边界的线宽。它控制公式的外观轮廓，0 表示没有边框。
should_center（默认值为 True）：
- 这个参数决定是否将公式在画布上居中。如果设置为 False，公式将以左对齐的方式显示。
height（默认值为 None）：
- 这个参数可以指定公式的高度。如果提供，公式将根据指定的高度进行缩放，以适应所需的大小。
organize_left_to_right（默认值为 False）：
- 这个参数控制文本的排列方向。如果设置为 True，文本会从左到右排列。默认情况下，LaTeX 环境任务一般会保持原有的排列方式。
tex_environment（默认值为 'align*'）：
- 该参数指定使用的 LaTeX 环境名称。默认情况下为 align*。可以根据需求选择合适的 LaTeX 环境来控制公式的渲染方式。
tex_template（默认值为 None）：
- 这个参数允许用户提供 LaTeX 模板以自定义渲染的样式。如果设置了此参数，公式将按照指定的模板进行渲染。
font_size（默认值为 48）：
- 这个参数指定了公式的字体大小，可以根据需要进行调整，以适配不同的场合或视觉效果。
**kwargs：
- 这是一个可变关键字参数，可以传递给 Mobject 的构造函数，允许使用额外的属性或行为设置，例如颜色、位置等。

示例使用

class Formula01(Scene):
    def construct(self):
        title = Title("SingleStringMathTex",color=RED) 
        math_expr = SingleStringMathTex(  
            r"f(x) = ax^2 + bx + c",  
            stroke_width=1,  
            should_center=True,  
            height=0.5,  
            font_size=0.5  
        )
        math_expr2 = SingleStringMathTex(  
            r"f(x) = ax^2 + bx + c",  
            stroke_width=1,  
            should_center=True,  
            height=1,  
            font_size=0.5  
        )
        a=Group(math_expr,math_expr2).arrange(DOWN, buff=.8)
        
        self.add(title,a)

在这个示例中，我们创建了一个数学表达式 f(x) = ax^2 + bx + c，设定了边界线宽、居中显示、高度和字体大小。

总结

SingleStringMathTex 是一种方便的方式来渲染单个 LaTeX 数学表达式。通过灵活的参数设置，您可以轻松控制字体大小、边框样式、对齐方式和环境选择，以适应各种演示和动画场景。

4.Tex用于编译普通模式下的 LaTeX 字符串。

Tex 是 Manim 中用于渲染 LaTeX 文本的类，支持多个字符串并将它们组合成一个数学表达式或普通文本的对象。以下是对其参数的详细解释：

函数和参数

Tex(*tex_strings, arg_separator='', tex_environment='center', **kwargs)

参数说明：

*tex_strings：
- 这是一个可变参数，可以接收多个字符串作为输入。所有输入的字符串将在渲染时组合成一个整体。通常用于一起显示多个 LaTeX 表达式或文本。
arg_separator（默认值为 ''）：
- 这个参数用于定义在多个字符串之间插入的分隔符。默认为空字符串（即没有分隔符），如果你希望在多个字符串之间加入特定的符号或空格，可以设置此参数。
tex_environment（默认值为 'center'）：
- 该参数定义了所使用的 LaTeX 环境。默认情况下是 'center'，它在画布上居中显示文本。你可以根据需要选择其他 LaTeX 环境，如 equation、align 等，以控制文本的布局方式。
**kwargs：
- 这是一个可变关键字参数，允许用户在创建 Tex 对象时传入额外的样式或设置。例如，文本的颜色、位置、字体大小等都可以通过这个参数传递。

示例使用

class Formula02(Scene):
    def construct(self):
        title = Title("Text",color=RED) 
        text = Tex(  
                r"f(x) = ax^2 + bx + c",   
                r"\quad \text{where } a, b, c \in \mathbb{R}",  
                arg_separator=' ',   
                tex_environment='align*',   
                color=BLUE  
            )
        
        self.add(title,text)