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

    类 Polyline

    折线,支持屏幕拉伸、平面拉伸和三维表面贴地渲染。 通过代理模式将属性和方法调用转发到内部对象,支持动态切换渲染模式。

    // 创建普通折线(屏幕空间线)
    const polyline = engine.add(new mapvthree.Polyline({
    flat: false,
    color: 0xff0000,
    lineWidth: 2
    }));

    // 创建贴地折线(跟随地形、道路或结构物表面)
    const fatLine = engine.add(new mapvthree.Polyline({
    clampToGround: true,
    color: 0x00ff00,
    lineWidth: 5
    }));

    层级

    • Group
      • Polyline
    索引

    构造函数

    访问器

    构造函数

    • 构造函数

      参数

      • parameters: {
            alphaTest?: number;
            arrow?: PolylineArrowOptions;
            clampToGround?: boolean;
            color?: string;
            dashArray?: number;
            dashed?: boolean;
            dashOffset?: number;
            dashRatio?: number;
            emissive?: string;
            flat?: boolean;
            gradient?: {};
            groundTargets?: any[];
            height?: number;
            isCurve?: boolean;
            lineWidth?: number;
            map?: string;
            opacity?: number;
            vertexColors?: boolean;
        } = {}

        配置参数

        • 可选alphaTest?: number

          透明度测试阈值,小于该值的像素将被剔除,默认为0

        • 可选arrow?: PolylineArrowOptions

          沿输入点顺序重复绘制箭头;null 关闭

        • 可选clampToGround?: boolean

          是否贴合三维实体表面

        • 可选color?: string

          线条颜色,支持十六进制颜色值或颜色名称,默认为#00ffff

        • 可选dashArray?: number

          每段虚线(实心加空心部分)的长度,默认为20

        • 可选dashed?: boolean

          是否渲染虚线,默认为false

        • 可选dashOffset?: number

          虚线起始绘制部分的偏移,默认为0

        • 可选dashRatio?: number

          实心部分占每段长度的占比,默认为0.5

        • 可选emissive?: string

          自发光颜色,支持十六进制颜色值

        • 可选flat?: boolean

          是否采用平面拉伸线宽,不控制三维表面贴地

        • 可选gradient?: {}

          每条路径按长度归一化的颜色色标,位置 0~1

        • 可选groundTargets?: any[]

          接收对象根节点;省略时自动发现,空数组表示不接收

        • 可选height?: number

          线条高度,用于3D效果

        • 可选isCurve?: boolean

          是否自动生成贝塞尔曲线数据,默认为false

        • 可选lineWidth?: number

          线条宽度,默认为4

        • 可选map?: string

          纹理贴图路径,支持图片文件路径

        • 可选opacity?: number

          透明度,取值范围0-1,默认为1

        • 可选vertexColors?: boolean

          是否使用顶点颜色,当为true时可通过数据源设置每个点的颜色

      返回 Polyline

    访问器

    • get arrow(): Readonly<Required<PolylineArrowOptions>>

      重复箭头配置,整体赋值更新,设为 null 关闭。返回对象只读。

      返回 Readonly<Required<PolylineArrowOptions>>

    • set arrow(value: PolylineArrowOptions): void

      参数

      • value: PolylineArrowOptions

      返回 void

    • get gradient(): Readonly<{}>

      每条路径的渐变色标,整体赋值更新,设为 null 恢复原颜色。返回对象只读。

      返回 Readonly<{}>

    • set gradient(value: {}): void

      参数

      • value: {}

      返回 void