---
url: /3d/surface3d.md
---
# 三维曲面图 surface3d

z = f(x, y) 的高度场：矩阵进、波面出。颜色按高度走连续色带，线框给出网格密度参照；
面片双面可见，转到下方看不会消失。

## 何时使用

* 有规则网格采样的二元函数或物理场（地形、温度场、概率密度）；
* 想同时表达「形状」与「数值」（色带）；
* 无序散点想看趋势面时，先做插值再进曲面。

## 示例

经典 sinc 波面，默认线框与色带：

纯填充形态（关线框、半透明，突出色带层次）：

## 配置要点

* `surfaceData`：`{ x, y, z }`，`z` 为数值矩阵（行对应 y、列对应 x）；行列不必等长；
* `surface.wireframe`（默认开）：白色细线框，旋转到暗色主题自动换深色；
* `surface.opacity`：面片透明度，需要透视下层时降到 0.6 左右；
* `surface.ramp`：色带 id（classic / aurora / sunset / viridis / heat / mono），缺省随 `palette`；
* 矩阵过大时自动按 48×48 面片上限抽稀，首末行列保留。

## 相关

* 色带体系：[主题接入](/3d/theme)
* 散点形态：[三维散点图](/3d/scatter3d)
* 字段细节：[API 参考](/3d/api)