数字与变量¶

DecimalNumber、Integer、Variable 把“数值”封装成 Mobject：数值变化时对象自动重排字符，配合 ValueTracker 就能做出滚动的计数器、实时更新的坐标等效果。

版本说明

本节示例的默认数字外观由 MathTex 排版，依赖 LaTeX，示例由 CI 渲染。ValueTracker 本身只是数值容器，其机制在「动画进阶」板块的数值动画一节详细讲解，本节只用到 tracker.get_value() 与 tracker.animate.set_value(...)。

DecimalNumber¶

DecimalNumber(number=0, num_decimal_places=2, mob_class=<class 'manim.mobject…, include_sign=False, group_with_commas=True, digit_buff_per_font_unit=0.001, show_ellipsis=False, unit=None, unit_buff_per_font_unit=0, include_background_rectangle=False, edge_to_fix=array([-1., 0., 0.]), font_size=48, stroke_width=0, fill_opacity=1.0, **kwargs) 官方文档 ↗

DecimalNumber 渲染一个浮点数，值改变时自动增删字符并保持对齐，是计数器动画的核心。

DecimalNumber(
    number: float = 0,
    num_decimal_places: int = 2,
    mob_class: type[SingleStringMathTex] = MathTex,
    include_sign: bool = False,
    group_with_commas: bool = True,
    digit_buff_per_font_unit: float = 0.001,
    show_ellipsis: bool = False,
    unit: str | None = None,
    unit_buff_per_font_unit: float = 0,
    include_background_rectangle: bool = False,
    edge_to_fix: Vector3DLike = LEFT,
    font_size: float = 48,
    stroke_width: float = 0,
    fill_opacity: float = 1.0,
)

name	type	default	desc
`number`	float	0	初始数值
`num_decimal_places`	int	2	小数位数
`mob_class`	type[SingleStringMathTex]	MathTex	单个数字/字符的排版类
`include_sign`	bool	False	始终显示正负号
`group_with_commas`	bool	True	整数部分加千分位逗号
`show_ellipsis`	bool	False	末尾显示省略号（暗示截断）
`unit`	str \| None	None	追加的单位（如 `"m/s"`），与数字同字号
`include_background_rectangle`	bool	False	给整个数字加背景矩形
`edge_to_fix`	Vector3DLike	LEFT	数值增长时固定不动的边缘

核心用法：set_value(x) 更新数值（ instantly ），配合 ValueTracker + updater 或 .animate.set_value 实现平滑滚动：

ValueTracker 从 0 动画到 1，updater 每帧把 PI * tracker 写入 DecimalNumber——省略号来自 show_ellipsis=True。本示例由 CI 渲染。

查看源码 decimal_number_demo.py

"""DecimalNumberDemo: 用 ValueTracker 驱动小数滚动。（需要 LaTeX，由 CI 渲染）"""

from manim import *


class DecimalNumberDemo(Scene):
    def construct(self):
        tracker = ValueTracker(0)
        num = DecimalNumber(
            0,
            num_decimal_places=3,
            show_ellipsis=True,
        )
        num.add_updater(lambda m: m.set_value(PI * tracker.get_value()))

        self.add(num)
        self.play(tracker.animate.set_value(1), run_time=2)
        self.wait(0.5)

提示

edge_to_fix=LEFT 是默认值：数字向右增长时左侧对齐，适合左对齐的计数器。做居中计分板时传入 ORIGIN 保持整体居中。

Integer¶

Integer(number=0, num_decimal_places=0, **kwargs) 官方文档 ↗

Integer 是 DecimalNumber 的子类，固定 num_decimal_places=0 的整数版本，参数其余相同。

Integer(number: float = 0, num_decimal_places: int = 0, **kwargs)

典型场景：帧计数、得分、粒子数。配合 ValueTracker 的写法和 DecimalNumber 完全一致。

Variable¶

Variable(var, label, var_type=<class 'manim.mobject…, num_decimal_places=2, **kwargs) 官方文档 ↗

Variable 把“标签 + 数值”组合显示，自带一个 tracker（ValueTracker 实例），常用于展示“变量名 = 当前值”。

Variable(
    var: float,
    label: str | Tex | MathTex | Text | SingleStringMathTex,
    var_type: type[DecimalNumber | Integer] = DecimalNumber,
    num_decimal_places: int = 2,
    **kwargs,
)

name	type	default	desc
`var`	float	—	初始值
`label`	str \| Tex \| MathTex \| Text \| SingleStringMathTex	—	变量名，字符串按 `var_type` 同引擎排版，也可直接传文本对象
`var_type`	type	DecimalNumber	数值部分用的类（`DecimalNumber` 或 `Integer`）
`num_decimal_places`	int	2	小数位数（透传给数值类）

成员：v.tracker 是内部 ValueTracker；v.label 是变量名部分；v.value 显示数值。改值用 v.set_value(x) 或直接动 v.tracker：

x 与 x^2 两个 Variable 并排，x^2 注册 updater 依赖 x.tracker——动画只驱动 x，另一个自动跟随。本示例由 CI 渲染。

查看源码 variable_demo.py

"""VariableDemo: Variable 显示变量及其依赖更新。（需要 LaTeX，由 CI 渲染）"""

from manim import *


class VariableDemo(Scene):
    def construct(self):
        x = Variable(0, "x", var_type=DecimalNumber, num_decimal_places=1)
        y = Variable(0, "x^2", var_type=DecimalNumber, num_decimal_places=1)
        y.next_to(x, RIGHT, buff=1.5)
        y.add_updater(lambda m: m.set_value(x.tracker.get_value() ** 2))

        self.add(x, y)
        self.play(x.tracker.animate.set_value(3), run_time=2)
        self.wait(0.5)

	DecimalNumber	Integer	Variable
小数	支持	不支持	由 `var_type` 决定
自带标签	无	无	有（`label`）
自带 tracker	无	无	有（`.tracker`）
适用	测量值、进度	计数、得分	展示“变量 = 值”

常见错误

DecimalNumber 的子对象是按当前位数重建的：set_value 前后位数若变化，num[3] 这类硬编码索引会指到别的字符。要对特定位做动画，先确认位数固定，或改用 unit、include_sign 等参数稳定结构。

自测¶

下一步¶

有了文本和数字，还需要组织内容的结构——下一节看 BulletedList 与 Title。