DecimalNumberMobjects分类中专门用来显示数字的一个class
它的主要功能是提供一种展示数字的方式,包括整数和浮点数。
manim边学边做–DecimalNumber-小白菜博客
DecimalNumbermanim各个模块中的位置如上图中所示。

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()}")

运行效果:
image.png

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)

显示效果:
out.gif

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)

显示效果:
out.gif

3.3. 数值中的逗号和背景

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

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

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

val = DecimalNumber(number, include_background_rectangle=True)

显示效果:
out.gif

4. 附件

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