JSAPI Three API Reference
    正在准备搜索索引...

    类 Picking

    场景拾取,用于拾取场景中的物体和坐标
    需要了解有三种坐标系背景:

      1. pixel 屏幕像素坐标,左上角为原点,x轴向右,y轴向下,单位为像素
      1. ndc 归一化设备坐标系,以中心为原点,x轴向右,y轴向上,xy范围[-1, 1]
      1. readPixel 左下角为原点,x轴向右,y轴向上,单位为像素,调用 depthPicking.pickDepth 时注意转换成该坐标系
    索引

    方法

    • 拾取场景物体像素点的世界坐标,每帧缓存,同屏幕位置只计算一次

      参数

      • pixel: Vector2

        屏幕像素坐标,左上角为原点,向右向下为正方向

      返回 Vector3

      拾取坐标

    • 从归一化设备坐标(NDC)中选取世界坐标

      参数

      • ndc: Vector2

        归一化设备坐标(NDC)

      返回 Promise<Vector3>

      返回对应的世界坐标

    • 拾取海平面交点

      参数

      • pixel: Vector2

        屏幕像素坐标,左上角为原点,向右向下为正方向

      返回 Vector3

      交点坐标

    • 拾取地形交点

      参数

      • ray: Ray

        射线

      返回 Vector3

      交点坐标

    • 获取世界坐标,优先获取场景物体的世界坐标,若未找到则获取地图上的海平面交点

      参数

      • pixel: any

        屏幕像素坐标,左上角为原点,向右向下为正方向

      返回 Promise<Vector3>

      返回对应的世界坐标

    • 从归一化设备坐标(NDC)中选取世界坐标

      参数

      • ndc: Vector2

        归一化设备坐标(NDC)

      返回 Promise<Vector3>

      返回对应的世界坐标

    访问器

    • get useDepthPicking(): boolean

      获取是否使用深度拾取 使用深度图拾取世界坐标,性能表现受GPU、屏幕分辨率影响。 小分辨率,大场景的情况下性能表现较好。 注意该api是同步的,主线程发起请求后会等GPU处理完返回通信后才响应,所以性能差的时候会导致IO阻塞。

      返回 boolean

      是否使用深度拾取

    • set useDepthPicking(value: boolean): void

      参数

      • value: boolean

        是否使用深度拾取

      返回 void