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. 附件
主观感受,仅供参考。本文采用 本文采用 CC BY-NC-SA 4.0 许可 协议,
完整转载请注明来自
数学动画引擎。