VDict

合格名称：manim.mobject.types.vectorized\_mobject.VDict

Python
class VDict(mapping_or_iterable={}, show_keys=False, **kwargs)

Bases: VMobject

类似 VGroup 的类，还提供通过键访问子对象的功能，如 python 字典

参数

mapping_or_iterable ( Mapping [ Hashable , VMobject ] | Iterable [ tuple [ Hashable , VMobject ] ] ) – 指定键和 mobject 的键值映射的参数。
show_keys ( bool ) – 是否还显示与 mobject 关联的键。这在调试时可能很有用，特别是当 VDict. 默认为 False。
kwargs – 要传递给 Mobject 的其他参数。

show_keys

是否还显示与 mobject 关联的键。这在调试时可能很有用，特别是当 VDict. 显示时，关键点位于对象的左侧。默认为 False。

类型

bool

submob_dict

是用于将键绑定到 mobject 的实际 Python 字典。

类型

dict

例子

示例：ShapesWithVDict

Python
from manim import *

class ShapesWithVDict(Scene):
    def construct(self):
        square = Square().set_color(RED)
        circle = Circle().set_color(YELLOW).next_to(square, UP)

        # create dict from list of tuples each having key-mobject pair
        pairs = [("s", square), ("c", circle)]
        my_dict = VDict(pairs, show_keys=True)

        # display it just like a VGroup
        self.play(Create(my_dict))
        self.wait()

        text = Tex("Some text").set_color(GREEN).next_to(square, DOWN)

        # add a key-value pair by wrapping it in a single-element list of tuple
        # after attrs branch is merged, it will be easier like `.add(t=text)`
        my_dict.add([("t", text)])
        self.wait()

        rect = Rectangle().next_to(text, DOWN)
        # can also do key assignment like a python dict
        my_dict["r"] = rect

        # access submobjects like a python dict
        my_dict["t"].set_color(PURPLE)
        self.play(my_dict["t"].animate.scale(3))
        self.wait()

        # also supports python dict styled reassignment
        my_dict["t"] = Tex("Some other text").set_color(BLUE)
        self.wait()

        # remove submobject by key
        my_dict.remove("t")
        self.wait()

        self.play(Uncreate(my_dict["s"]))
        self.wait()

        self.play(FadeOut(my_dict["c"]))
        self.wait()

        self.play(FadeOut(my_dict["r"], shift=DOWN))
        self.wait()

        # you can also make a VDict from an existing dict of mobjects
        plain_dict = {
            1: Integer(1).shift(DOWN),
            2: Integer(2).shift(2 * DOWN),
            3: Integer(3).shift(3 * DOWN),
        }

        vdict_from_plain_dict = VDict(plain_dict)
        vdict_from_plain_dict.shift(1.5 * (UP + LEFT))
        self.play(Create(vdict_from_plain_dict))

        # you can even use zip
        vdict_using_zip = VDict(zip(["s", "c", "r"], [Square(), Circle(), Rectangle()]))
        vdict_using_zip.shift(1.5 * RIGHT)
        self.play(Create(vdict_using_zip))
        self.wait()

方法


`add`	将键值对添加到`VDict`对象。
`add_key_value_pair`	`add()`用于将键值对添加到的实用程序函数`submob_dict`。
`get_all_submobjects`	获取与特定`VDict`对象关联的所有子对象
`remove`	`VDict`从具有 key key 的对象中删除 mobject

属性


`animate`	用于对的任何方法的应用程序进行动画处理`self`。
`animation_overrides`
`color`
`depth`	对象的深度。
`fill_color`	如果有多种颜色（对于渐变），则返回第一个颜色
`height`	mobject 的高度。
`n_points_per_curve`
`sheen_factor`
`stroke_color`
`width`	mobject 的宽度。

add(mapping_or_iterable)

将键值对添加到VDict对象。

此外，它在内部将值添加到的子对象中，该子对象负责实际的屏幕显示。listMobject

参数

mapping_or_iterable ( Mapping [ Hashable , VMobject ] | Iterable [ tuple [ Hashable , VMobject ] ] ) – 指定键和 mobject 的键值映射的参数。

返回

返回VDict调用此方法的对象。

返回类型

VDict

例子

正常使用：

Python
square_obj = Square()
my_dict.add([('s', square_obj)])

add_key_value_pair(key, value)

add()用于将键值对添加到的实用程序函数submob_dict。并不是真正要在外部使用。

参数

key ( Hashable ) – 要添加的子对象的键。
value ( VMobject ) – 与键关联的 mobject

返回类型

None

提高

TypeError – 如果值不是 VMobject 的实例

例子

正常使用：

Python
square_obj = Square()
self.add_key_value_pair('s', square_obj)

get_all_submobjects()

获取与特定VDict对象关联的所有子对象

返回

VDict与该对象关联的所有子对象

返回类型

dict_values

例子

正常使用：

Python
for submob in my_dict.get_all_submobjects():
    self.play(Create(submob))

remove(key)

VDict从具有 key key 的对象中删除 mobject

此外，它在内部从的子对象中删除该对象（负责将其从屏幕上删除）listMobject

参数

key ( Hashable ) – 要删除的子对象的键。

返回

返回VDict调用此方法的对象。

返回类型

VDict

例子

正常使用：

Python
my_dict.remove('square')