点与点云

除了矢量轮廓，Manim 还提供一套基于离散点集的 mobject：Dot 是日常的实心圆点，Point 是逻辑单点，PointCloudDot 则用成百上千个小点拼出圆盘。点云家族的基类 PMobject 与矢量家族 VMobject 是并列关系，能力差异很大。

Dot

Dot(point=array([0., 0., 0.]), radius=0.08, stroke_width=0, fill_opacity=1.0, color=ManimColor('#FFFFFF'), **kwargs) 官方文档 ↗

Dot 是一个半径很小的实心圆（Circle 的子类），默认无描边、完全填充，是标记位置、画散点图的第一选择。

Dot(
    point: Point3DLike = ORIGIN,
    radius: float = 0.08,
    stroke_width: float = 0,
    fill_opacity: float = 1.0,
    color: ParsableManimColor = WHITE,
    **kwargs,
)

name	type	default	desc
point	Point3DLike	ORIGIN	圆点中心位置
radius	float	0.08	半径；比 Circle 默认小得多
stroke_width	float	0	描边宽度，默认无描边
fill_opacity	float	1.0	填充不透明度，默认实心
color	ParsableManimColor	WHITE	颜色
kwargs	—	—	转发给 Circle

与 LabeledDot 的对比：

维度	Dot	LabeledDot
参数	point / radius / stroke_width / fill_opacity / color	label、radius=None、buff=0.1
标签	无	圆心处渲染一段文字
radius=None 时	—	按标签大小加 buff 自动计算

红色的普通 Dot 与蓝色的 LabeledDot(Text("A"))；后者圆点尺寸随标签自动适配。

查看源码 dots_demo.py

from manim import *


class DotsDemo(Scene):
    def construct(self):
        dot = Dot(LEFT * 2, color=RED)
        label_dot = LabeledDot(Text("A"), color=BLUE)
        label_dot.next_to(dot, RIGHT, buff=1.2)
        self.play(FadeIn(dot), FadeIn(label_dot))
        self.play(dot.animate.move_to(ORIGIN))
        self.wait(0.5)

常见错误

Dot(RED) 把 RED 当成了位置参数（第一个参数是 point）——正确写法是 Dot(color=RED) 或 Dot().set_color(RED)。同理 Dot(LEFT * 2) 是把点放到左侧 2 个单位。

LabeledDot

LabeledDot(label, radius=None, buff=0.1, **kwargs) 官方文档 ↗

LabeledDot 是带居中标签的 Dot：label 传字符串时按 MathTex 渲染（需要本机 LaTeX），也可以直接传入 Text / Tex 实例；不传 radius 时圆点半径由标签尺寸加 buff 推出。参数表与示例见上方 Dot 一节的对比与演示。

常见错误

无 LaTeX 环境下 LabeledDot("A") 会直接报错。改用 pango 文本：LabeledDot(Text("A"))。

Point

Point(location=array([0., 0., 0.]), color=ManimColor('#000000'), **kwargs) 官方文档 ↗

Point 是表示单个位置的 mobject：数据上只有一个坐标点，渲染时显示为极小的方块，默认黑色、几乎不可见。它适合做纯逻辑锚点（记录位置但不希望干扰画面）。

Point(location: Point3DLike = ORIGIN, color: ManimColor = BLACK, **kwargs)

name	type	default	desc
location	Point3DLike	ORIGIN	点的位置
color	ManimColor	BLACK	颜色，默认黑色
kwargs	—	—	转发给 PMobject，如 stroke_width

常见错误

两点需要留意：其一，Point 默认黑色，在黑背景上完全看不见，这不是 bug；其二，Point 继承自 PMobject 而非 VMobject，没有 set_fill / set_stroke / set_opacity 方法，调了要么报错要么落入 Mobject 的 set_* 兼容层只改属性不影响渲染。

PointCloudDot

PointCloudDot(center=array([0., 0., 0.]), radius=2.0, stroke_width=2, density=10, color=ManimColor('#FFFF00'), **kwargs) 官方文档 ↗

PointCloudDot 在指定半径的圆盘内随机撒出一片小点，拼出“点云圆盘”。它属于 PMobject 家族：没有矢量填充，每个点按 stroke_width 渲染为小方块。

PointCloudDot(
    center: Point3DLike = ORIGIN,
    radius: float = 2.0,
    stroke_width: int = 2,
    density: int = 10,
    color: ManimColor = PURE_YELLOW,
    **kwargs,
)

name	type	default	desc
center	Point3DLike	ORIGIN	圆盘中心
radius	float	2.0	圆盘半径
stroke_width	int	2	每个点的渲染尺寸
density	int	10	点密度，越大点越多（每单位约 density² 量级）
color	ManimColor	PURE_YELLOW	点云颜色

两片 PointCloudDot：density=15 的大云与 density=25 的小云；点的位置是随机生成的。

查看源码 point_cloud_demo.py

from manim import *


class PointCloudDemo(Scene):
    def construct(self):
        cloud = PointCloudDot(radius=1.2, density=15, color=YELLOW)
        small = PointCloudDot(radius=0.6, density=25, color=RED).shift(2.5 * RIGHT)
        self.play(FadeIn(cloud), FadeIn(small))
        self.play(cloud.animate.scale(1.3))
        self.wait(0.5)

提示

点云的随机分布每次渲染都不同。需要可复现的结果时，用 CLI --seed 或 Scene(random_seed=42) 固定随机种子。

PMobject

PMobject(stroke_width=4, **kwargs) 官方文档 ↗

点集基类：所有点成员共用一个 points 数组，无矢量填充（stroke_width=4）。四个点云基类的对比与继承链见下表。

Mobject1D

Mobject1D(density=10, **kwargs) 官方文档 ↗

一维采样基类（density=10，epsilon = 1/density），用于沿曲线等距采样点。

Mobject2D

Mobject2D(density=25, **kwargs) 官方文档 ↗

二维采样基类（density=25，epsilon = 1/density），用于在曲面上采样点。

PGroup

PGroup(*pmobs, **kwargs) 官方文档 ↗

PMobject 的组合容器（成员非 PMobject 时抛 ValueError），用于把多片点云当一个整体变换；对应 VMobject 侧的 VGroup。

点云家族四基类对比：

类	签名（默认参数）	一句话用途
PMobject	(stroke_width=4)	点集基类：所有点成员一个 points 数组，无矢量填充
Mobject1D	(density=10)	一维采样基类（曲线），epsilon = 1/density
Mobject2D	(density=25)	二维采样基类（曲面），epsilon = 1/density
PGroup	(*pmobs)	PMobject 的组合容器；成员非 PMobject 时抛 ValueError

各成员的继承链：

日常使用中，只有 PointCloudDot（现成可看的点云）和 Point 需要直接构造；PMobject / Mobject1D / Mobject2D 更多是继承与扩展的基类，PGroup 用于把多片点云当一个整体变换。

常见错误

不要把 PMobject 家族的成员塞进 VGroup——VGroup 只收 VMobject，应改用 PGroup；反过来 Dot 是 Circle 子类，属于 VMobject，不要塞进 PGroup。

自测

✏️ 练习

下面两行代码各画出了什么？Dot(LEFT * 2) 与 Dot(color=RED) 的参数分别落在了哪个形参上？

✅ 参考答案

Dot(LEFT * 2) 把位置参数 point 设为 LEFT * 2，画出一个位于左侧 2 个单位的白色（默认色）圆点；Dot(color=RED) 用关键字传入 color，画出一个位于原点的红色圆点。若误写 Dot(RED)，RED 会被当成 point 而报错。

✏️ 练习

想让画面上有一个“带字母标签的圆点”，但机器没有安装 LaTeX，应该怎样构造 LabeledDot？如果还需要第二片点云与它一起整体移动，又该用什么容器组合？

✅ 参考答案

标签用 pango 文本实例传入：LabeledDot(Text("A"))，避免字符串触发的 MathTex 渲染。第二片点云用 PointCloudDot 构造；二者类型不同（LabeledDot 是 VMobject，点云是 PMobject），不能用 VGroup 也不能用 PGroup 混装，请用不校验类型的 Group 组合后再整体 shift / scale。

下一步

到这里，二维图形的基础工具已经齐全。下一节进入“线与箭头”，看看 Line、Arrow 和带端点的曲线。