manim边学边做--DecimalNumber

DecimalNumber是Mobjects分类中专门用来显示数字的一个class。
它的主要功能是提供一种展示数字的方式，包括整数和浮点数。

DecimalNumber在manim各个模块中的位置如上图中所示。

1. 主要参数

虽然只是数字的展示，但是manim也提供了丰富的参数，可以在不同的场景中用不同的展示方式。
其中重要且常用的参数有：

参数名称	类型	说明
number	float	要显示的数字
num_decimal_places	int	保留的小数位数，自动四舍五入
include_sign	bool	时候包含正负号
group_with_commas	bool	是否用逗号分隔数字，以提高可读性
show_ellipsis	bool	当一个数字被四舍五入截断时，是否用省略号表示
unit	str	数值的单位
unit_buff_per_font_unit	float	数值和单位之间的间距
include_background_rectangle	bool	是否包含背景矩形

此外，还有设置字体大小，颜色以及线条等等样式方面的参数（这些参数一般是mobjects模块中所有class通用的）。

2. 主要方法

DecimalNumber类主要用于展示数字，提供的方法不多，主要有3个：

名称	说明
get_value	获取数值
set_value	设置数值
increment_value	增加数值

使用示例：

val = DecimalNumber(10, group_with_commas=True)
print(f"原始数据：{val.get_value()}")

val.set_value(20)
print(f"设置数据：{val.get_value()}")

val.increment_value(2)
print(f"递增数据：{val.get_value()}")

运行效果：

3. 使用示例

接下来，通过示例演示主要参数的作用。

3.1. 正负号和单位

默认显示时，正数是不显示正号(+)的，显示正号通过 include_sign参数。

number = 3.1415926
val = DecimalNumber(number, include_sign=True)

数值也可以加上单位，比如下面添加一个(km/s)速度单位。

val = DecimalNumber(number, unit="(km/s)")

单位和数值之间的距离也可以调整，通过unit_buff_per_font_unit来调整。

val = DecimalNumber(number, unit="(km/s)", unit_buff_per_font_unit=0.01)

显示效果：

3.2. 小数位数

从上面的示例可以看出，DecimalNumber默认保留2位小数，通过num_decimal_places可以控制保留的小数位数，舍弃的部分会自动四舍五入。

number = 3.1415926
val = DecimalNumber(number, num_decimal_places=3)
val = DecimalNumber(number, num_decimal_places=5)

DecimalNumber还有个show_ellipsis参数，通过它，可以让我们知道显示的数值是否经过了四舍五入。
它会给经过四舍五入处理的数值加上省略号。

val = DecimalNumber(number, num_decimal_places=3, show_ellipsis=True)

显示效果：

3.3. 数值中的逗号和背景

在会计统计中，对于比较大的数值，一般会用逗号分割数值，DecimalNumber的group_with_commas参数就控制是否用逗号分割数值的参数。

number = 123456789
val = DecimalNumber(number, group_with_commas=True)

需要突出显示的数值，也可以通过include_background_rectangle参数给数值添加背景。

val = DecimalNumber(number, include_background_rectangle=True)

显示效果：

4. 附件

文中完整的代码放在网盘中了（decimal.py），
下载地址: [https://url11.ctfile.com/d/45455611-61580017-3188ea?p=6872]() (访问密码: 6872)