Surface类是Manim中专为创建和操控复杂的三维表面而打造的。

在实际应用中,无论是创建数学教学中的几何模型,还是模拟物理现象中的曲面变化,甚至是构建复杂的动画场景中的三维元素,Surface类都能以其强大的功能和灵活性满足我们的需求。

通过Surface类的参数和方法,我们可以创造出既逼真又富有创意的三维动画效果。

1. 主要参数

Surface的主要参数有4个:

参数名称 类型 说明
func Callable[[float, float], np.ndarray] 一个接受两个参数(通常称为u和v)的函数,返回三维空间中的一个点(x, y, z)的z坐标
u_range [float] 参数u的取值范围,决定了表面在u方向上的延伸情况
v_range [float] 参数v的取值范围,决定了表面在v方向上的延伸情况
resolution [int] 在u和v方向上的分辨率,即表面在这两个方向上的细分程度

其中,参数func比较重要,它决定了曲面的形状。

通过这个函数来创建任何可以用参数方程表示的三维表面,例如,球面、椭球面、双曲面等。

2. 主要方法

Surface类有2个设置去曲面样式的方法。

名称 说明
set_fill_by_checkerboard 通过交替颜色填充曲面,适用于需要视觉区分曲面不同部分的情况
set_fill_by_value 根据曲面上的数值使用颜色渐变进行填充,适用于表示连续变量的变化

3. 使用示例

下面通过几个示例来用演示如何使用Surface类。

3.1. 基本曲面

这个示例展示了如何使用Manim的Surface类创建一个基本的三维曲面。

曲面由func参数定义,该函数描述了曲面在三维空间中的形状。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
from manim import *
class BasicSurface(ThreeDScene):
def construct(self):
self.set_camera_orientation(phi=68 * DEGREES, theta=-48 * DEGREES)
title = Text("Surface 基本曲面:z = u² - v²", font="STLiti", font_size=30).to_edge(UP)
self.add_fixed_in_frame_mobjects(title)
def func(u, v):
return (u, v, u**2 - v**2)
surf = Surface(func, u_range=[-1.4, 1.4], v_range=[-1.4, 1.4], resolution=(16, 16))
surf.set_fill(BLUE_D, opacity=0.85).set_stroke(BLUE_B, width=1.0)
note = Text("func 返回三维点,u_range / v_range 决定曲面的延伸范围", font="STLiti", font_size=21, color=YELLOW).to_edge(DOWN)
self.add_fixed_in_frame_mobjects(note)
self.play(FadeIn(title), run_time=0.6)
self.play(FadeIn(surf), run_time=1.6)
self.play(FadeIn(note), run_time=0.5)
self.wait(3.6)

下载 Python 脚本

3.2. 棋盘填充曲面

此示例演示了如何将曲面填充为棋盘样式。

通过使用set_fill_by_checkerboard方法,曲面被分割成多个小方格,并且这些小方格以交替的颜色(如红色和蓝色)填充,有助于区分曲面的不同部分。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
from manim import *
class CheckerSurface(ThreeDScene):
def construct(self):
self.set_camera_orientation(phi=68 * DEGREES, theta=-48 * DEGREES)
title = Text("set_fill_by_checkerboard:棋盘交替填充", font="STLiti", font_size=30).to_edge(UP)
self.add_fixed_in_frame_mobjects(title)
def func(u, v):
return (u, v, u * v)
surf = Surface(func, u_range=[-1.4, 1.4], v_range=[-1.4, 1.4], resolution=(16, 16))
surf.set_fill_by_checkerboard(RED, BLUE)
note = Text("红蓝交替的小方格便于区分曲面不同部分", font="STLiti", font_size=21, color=YELLOW).to_edge(DOWN)
self.add_fixed_in_frame_mobjects(note)
self.play(FadeIn(title), run_time=0.6)
self.play(FadeIn(surf), run_time=1.6)
self.play(FadeIn(note), run_time=0.5)
self.wait(3.6)

下载 Python 脚本

3.3. 值填充曲面

在这个示例中,曲面的填充颜色是根据曲面上的数值来确定的。

set_fill_by_value方法允许用户定义一个颜色渐变函数,该函数根据曲面上的每个点的值来返回对应的颜色。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
from manim import *
import numpy as np
class ValueSurface(ThreeDScene):
def construct(self):
self.set_camera_orientation(phi=68 * DEGREES, theta=-48 * DEGREES)
title = Text("set_fill_by_value:按曲面数值渐变着色", font="STLiti", font_size=30).to_edge(UP)
self.add_fixed_in_frame_mobjects(title)
axes = ThreeDAxes(x_range=[-3, 3, 1], y_range=[-3, 3, 1], z_range=[-2, 2, 1],
x_length=6, y_length=6, z_length=4)
def func(u, v):
return axes.c2p(u, v, np.sin(u * PI) * np.cos(v * PI))
surf = Surface(func, u_range=[-1, 1], v_range=[-1, 1], resolution=(16, 16))
surf.set_fill_by_value(axes=axes, colorscale=[(RED, -0.5), (YELLOW, 0), (GREEN, 0.5)], axis=2)
note = Text("colorscale 按 z 值映射红-黄-绿,需传入 ThreeDAxes", font="STLiti", font_size=21, color=YELLOW).to_edge(DOWN)
self.add_fixed_in_frame_mobjects(note)
self.play(FadeIn(title), run_time=0.6)
self.play(FadeIn(axes), FadeIn(surf), run_time=1.6)
self.play(FadeIn(note), run_time=0.5)
self.wait(3.6)

下载 Python 脚本

3.4. 自定义曲面样式

此示例展示了如何自定义曲面的颜色和线宽。

通过使用stroke_color和stroke_width方法,用户可以分别设置曲面分割线的颜色和线条的宽度。

下面的示例中,使用黄色,且宽度为2的线来作为曲面上的分割线。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
from manim import *
class StrokeSurface(ThreeDScene):
def construct(self):
self.set_camera_orientation(phi=68 * DEGREES, theta=-48 * DEGREES)
title = Text("自定义曲面分割线:黄色、宽度 2", font="STLiti", font_size=30).to_edge(UP)
self.add_fixed_in_frame_mobjects(title)
def func(u, v):
return (u, v, u**2 - v**2)
surf = Surface(func, u_range=[-1.4, 1.4], v_range=[-1.0, 1.0], resolution=(16, 16))
surf.set_fill(BLUE_E, opacity=0.55).set_stroke(YELLOW, width=2.0)
note = Text("stroke_color 设颜色,stroke_width 设分割线宽度", font="STLiti", font_size=21, color=YELLOW).to_edge(DOWN)
self.add_fixed_in_frame_mobjects(note)
self.play(FadeIn(title), run_time=0.6)
self.play(FadeIn(surf), run_time=1.6)
self.play(FadeIn(note), run_time=0.5)
self.wait(3.6)

下载 Python 脚本

4. 附件