You need to enable JavaScript to run this app. 如何从查看器的x,y,z点获取canvas坐标,实现Data Visualization扩展CustomToolTip
优惠活动
大模型
产品
解决方案
定价
更多

如何从查看器的x,y,z点获取canvas坐标,实现Data Visualization扩展CustomToolTip

Forge Data Visualization 扩展 CustomToolTip 实现方案

核心坐标转换方法

无需手动实现三维到二维的矩阵换算,直接调用Viewer内置的worldToClient方法即可获得Canvas对应的坐标:

// 入参为Sprite对应的三维世界坐标,返回值即Canvas相对定位用的x、y二维坐标
const canvasPosition = viewer.worldToClient(new THREE.Vector3(worldX, worldY, worldZ))

完整实现步骤

1. 初始化依赖&基础配置

// 加载DataVisualization扩展
const dataVizExt = await viewer.loadExtension('Autodesk.DataVisualization')
const spriteManager = new dataVizExt.SpriteManager(viewer)

// 注册Tooltip DOM(也可直接复用Viewer内置Tooltip)
const customTooltip = document.createElement('div')
Object.assign(customTooltip.style, {
  position: 'absolute',
  background: '#ffffff',
  padding: '8px 12px',
  borderRadius: '4px',
  boxShadow: '0 2px 10px rgba(0,0,0,0.2)',
  display: 'none',
  pointerEvents: 'none',
  zIndex: '100'
})
viewer.container.appendChild(customTooltip)

2. 绑定Sprite交互事件

// 鼠标移入Sprite时展示Tooltip
spriteManager.on('spriteMouseOver', (e) => {
  const targetSprite = e.sprite
  // 转换坐标
  const tipPosition = viewer.worldToClient(targetSprite.worldPosition)
  // 填充自定义内容
  customTooltip.innerHTML = `
    <div style="font-weight: bold; margin-bottom: 4px;">${targetSprite.title || '提示标题'}</div>
    <div style="font-size: 14px; color: #666;">${targetSprite.description || '提示描述内容'}</div>
  `
  // 定位Tooltip,可适当加偏移量避免盖住鼠标
  customTooltip.style.left = `${tipPosition.x + 10}px`
  customTooltip.style.top = `${tipPosition.y - 10}px`
  customTooltip.style.display = 'block'
})

// 鼠标移出Sprite时隐藏Tooltip
spriteManager.on('spriteMouseOut', () => {
  customTooltip.style.display = 'none'
})

可选:复用Viewer内置Tooltip

如果不想自己封装DOM,可直接调用Viewer自带的Tooltip组件:

const builtInTooltip = viewer.getTooltip()
// 展示
builtInTooltip.setVisible(true)
builtInTooltip.setText('<h4>自定义标题</h4><p>自定义描述内容</p>')
builtInTooltip.moveTo(canvasPosition.x, canvasPosition.y)
// 隐藏
builtInTooltip.setVisible(false)

内容的提问来源于stack exchange,提问作者NoName

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.14 20:36:03