logo

G

  • 教程
  • API
  • 示例
  • 插件
  • 所有产品antv logo arrow
  • 6.1.26
  • 画布
    • 简介
    • 初始化参数
    • 场景图能力与生命周期
    • 内置对象
    • 坐标系
    • 画布事件
    • OffscreenCanvas 和服务端渲染
    • CustomElementRegistry
    • 常见问题
  • 渲染器
    • 简介
    • Canvas 渲染器
    • Canvaskit 渲染器
    • SVG 渲染器
    • WebGL 渲染器
    • WebGPU 渲染器
    • 自定义渲染器
  • 相机
    • 简介
    • 相机参数
    • 相机动作
    • 相机动画
  • 事件
    • 简介
    • 事件对象
    • 手势和拖放
    • 常见问题
  • 动画
    • Web Animations API
    • Lottie 动画
  • 基础图形
    • 基础概念
    • DisplayObject
    • Group 图形分组
    • Text 文本
    • Circle 圆形
    • Ellipse 椭圆
    • Rect 矩形
    • Image 图片
    • Line 直线
    • Polygon 多边形
    • Polyline 折线
    • Path 路径
    • HTML 内容
  • 样式系统
    • 简介
    • 继承机制
    • CSS Typed OM
    • CSS Properties & Values API
    • CSS Layout API
    • Pattern
    • Gradient
  • 三维世界
    • 材质
    • 几何
    • 光源
    • Mesh
    • 雾
    • 交互
  • 内置对象
    • EventTarget
    • Node
    • Element
    • Document
    • MutationObserver
    • 工具方法
  • GPGPU
    • 简介
    • 编程模型
    • Kernel API
    • 经典 GPGPU 的实现原理
    • webgpu-graph
  • 声明式用法
    • 使用 Web Components
  • 开发调试工具
    • G 开发者工具
    • 内置的渲染统计信息
    • 第三方开发调试工具

Mesh

上一篇
光源
下一篇
雾

资源

Ant Design
Galacea Effects
Umi-React 应用开发框架
Dumi-组件/文档研发工具
ahooks-React Hooks 库

社区

体验科技专栏
seeconfSEE Conf-蚂蚁体验科技大会

帮助

GitHub
StackOverflow

more products更多产品

Ant DesignAnt Design-企业级 UI 设计语言
yuque语雀-知识创作与分享工具
EggEgg-企业级 Node 开发框架
kitchenKitchen-Sketch 工具集
GalaceanGalacean-互动图形解决方案
xtech蚂蚁体验科技
© Copyright 2025 Ant Group Co., Ltd..备案号:京ICP备15032932号-38

Loading...

在 3D 场景中 Mesh 的描述能力是最强大的,需要配合 Geometry 和 Material 使用。

import {
MeshPhongMaterial,
SphereGeometry,
DirectionalLight,
Mesh,
Plugin as Plugin3D,
} from '@antv/g-plugin-3d';
const sphereGeometry = new SphereGeometry(device, {
radius: 200,
});
const material = new MeshPhongMaterial(device, {
map: 'https://gw.alipayobjects.com/mdn/rms_6ae20b/afts/img/A*npAsSLPX4A4AAAAAAAAAAAAAARQnAQ',
// 省略其他参数,
});
// 创建一个 Mesh
const sphere = new Mesh({
style: {
x: 300, // 设置局部坐标系下的位置
y: 250,
z: 0, // z 轴坐标
fill: '#1890FF',
opacity: 1,
geometry: sphereGeometry,
material,
},
});
// 添加到画布
canvas.appendChild(sphere);

基础样式属性

我们复用 2D 图形的部分样式属性名。

fill

填充色

opacity

透明度

z

局部坐标系下 Z 轴坐标

变换操作

和 2D 图形一样,简单推广到 3D 即可。例如平移、缩放、旋转:

mesh.translate(0, 0, 0);
mesh.setPosition(0, 0, 0);
mesh.translateLocal(0, 0, 0);
mesh.setLocalPosition(0, 0, 0);
mesh.scale(1, 1, 1);
mesh.scaleLocal(1, 1, 1);
mesh.setLocalScale(1, 1, 1);
// 绕 Y 轴逆时针方向旋转
mesh.rotate(0, 0.1, 0);

包围盒

轴对齐包围盒也从 2D 的矩形推广到 3D 中的立方体:

const bounds = mesh.getBounds();
// { center: [0, 0, 0], halfExtents: [100, 100, 100] }