---
url: /3d/api.md
---
# API 参考

`EvChart3d` 全部能力的字段与方法速查。

## Chart Props

## 事件

| 事件 | 载荷 | 触发时机 |
| --- | --- | --- |
| ready | — | 首次渲染完成 |
| click | 图元元数据 + 屏幕坐标 | 点选数据图元 |
| hover / unhover | 图元元数据 | 悬浮进入 / 离开 |
| legend-click | (名称, 是否被隐藏) | 图例点选 |
| animation-end | — | 进场动画结束 |
| data-update | 来源描述 | options 更新 |
| camera-change | `{ yaw, pitch, distance, target }` | 相机变化（拖拽结束补发终态） |

## Options 通用字段

## 按图型数据字段

## 实例方法（ref）

## Composable 与底层管线

```js
import {
  useChart3d,        // 相机快捷操作 / 实例方法收拢
  render3d,          // 无头渲染一帧（自定义宿主场景）
  projectScene,      // 场景投影（返回屏幕坐标与视深）
  pickScene,         // 屏幕坐标拾取
  createSvgRecorder, // SVG 录制器
  resolveCamera,     // 相机配置解析与钳制
  validateOptions3d, // 配置校验（返回 { ok, warnings }）
} from '@wil-works/evoke-charts/3d'
```

`validateOptions3d` 只告警不阻断，开发期组件会自动把警告打印到控制台。