PathSymbol3DLayer

// create a PathSymbol3DLayer with a strip style
let stripPath = {
  type: "line-3d",  // 转换成 new LineSymbol3D()
  symbolLayers: [{
    type: "path",  // 转换成 new PathSymbol3DLayer()
    profile: "quad",  // creates a rectangular shape
    width: 20,  // path width in meters
    height: 5,  // path height in meters
    material: { color: "#ff7380" },
    cap: "square",
    profileRotation: "heading"
  }]
};

// create a PathSymbol3DLayer with a pipe style
let pipePath = {
  type: "line-3d",  // 转换成 new LineSymbol3D()
  symbolLayers: [{
    type: "path",  // 转换成 new PathSymbol3DLayer()
    profile: "circle",  // creates a rectangular shape
    width: 20,  // path width will also set the height to the same value
    material: { color: "#ff7380" },
    cap: "round"
  }]
};

属性列表

属性详细说明

anchor String

起始版本: GeoScene API for JavaScript 4.22

定义路径横截面相对于 Polyline 几何的偏移量。

可选值	示例
center
bottom
top

可选值:"center"|"bottom"|"top"

默认值:"center"

cap String

起始版本: GeoScene API for JavaScript 4.22

控制路径起点和终点处的形状。 none 不会渲染关闭路径的面。有关可能的值，请参阅下表。

可选值	示例
butt
round
square
none

可选值:"none"|"butt"|"square"|"round"

默认值:"butt"

castShadows Boolean

起始版本: GeoScene API for JavaScript 4.22

表示符号图层几何是否在场景中投射阴影。将此属性设置为 false 将禁用符号图层的阴影，即使在 SceneView.environment 中启用了直接阴影也是如此。

默认值:true

示例代码:

// disables shadow casting
symbolLayer.castShadows = false;

declaredClass Stringreadonly inherited

起始版本: GeoScene API for JavaScript 4.22

类名。类的名称声明格式为 geoscene.folder.className。

height Number

起始版本: GeoScene API for JavaScript 4.22

路径横截面的垂直尺寸（以米为单位）。如果仅设置了 width ，则高度将设置为与宽度相同的值。如果未设置宽度或高度，则不显示路径。

示例代码:

// create a path with a wall style
let wallPath = {
  type: "line-3d",  // 转换成 new LineSymbol3D()
  symbolLayers: [{
    type: "path",  // 转换成 new PathSymbol3DLayer()
    profile: "quad",  // creates a rectangular shape
    width: 1,  // path width in meters
    height: 20,  // path height in meters
    material: { color: "#a382cc" }
  }]
};

// create a path with a pipe style
let wallPath = {
  type: "line-3d",  // 转换成 new LineSymbol3D()
  symbolLayers: [{
    type: "path",  // 转换成 new PathSymbol3DLayer()
    profile: "circle",
    height: 20,  // path width in meters this also sets the width to 20 meters
    material: { color: "##a382cc" }
  }]
};

join String

起始版本: GeoScene API for JavaScript 4.22

控制路径的两段之间的连接形状。有关可能的值，请参阅下表。

可选值	示例
bevel
miter
round

可选值:"miter"|"bevel"|"round"

默认值:"miter"

material Objectautocast

用于遮蔽路径的材料。此属性定义路径的颜色。

属性:

color Color optional 默认值:white 自动转换自 Object|Number[]|String 路径的颜色。这可以是使用 rgb（a） 值数组、命名字符串、十六进制字符串或 hsl（a） 字符串、具有 r, g, b, 和a 属性的对象或 Color 对象自动转换的。

示例代码:

// CSS color string
symbolLayer.material = {
  color: "dodgerblue"
};

// HEX string
symbolLayer.material = {
  color: "#33cc33";
}

// array of RGBA values
symbolLayer.material = {
  color: [51, 204, 51, 0.3];
}

// object with rgba properties
symbolLayer.material = {
  color: {
    r: 51,
    g: 51,
    b: 204,
    a: 0.7
  }
};

profile String

起始版本: GeoScene API for JavaScript 4.22

路径几何图形的横截面轮廓。将其设置为circle 创建具有管道形状的路径，并将其设置为 quad 使路径为矩形。

可选值:"circle"|"quad"

默认值:"circle"

profileRotation String

起始版本: GeoScene API for JavaScript 4.22

定义 profile 沿 Polyline 几何拉伸时如何旋转轮廓。可以限制旋转轴（航向、倾斜、滚动）以约束场景中轮廓的方向。 设置profileRotation 为 all 最小化沿线的扭曲，并确保生成的可视化效果的直径与 width 和 height 相对应。设置 profileRotation 为 "heading" 确保型材保持直立（无倾斜或扭曲）。

通常， all 用于配置 circle 文件， heading 用于配置 quad 文件.

例如，在具有quad 截面梁的路径上进行设置 heading 时，路径的方向是直立的:

profileRotation 设置为 all 的相同路径将在三个自由度下旋转：

可选值:"heading"|"all"

默认值:"all"

type Stringreadonly

符号类型。

对于PathSymbol3DLayer ，类型始终为"path"。

width Number

起始版本: GeoScene API for JavaScript 4.22

径横截面的水平尺寸（以米为单位）。如果仅设置了 height ，则宽度将设置为与高度相同的值。如果未设置宽度或高度，则不显示路径。

示例代码:

// create a path with a strip style
let wallPath = {
  type: "line-3d",  // 转换成 new LineSymbol3D()
  symbolLayers: [{
    type: "path",  // 转换成 new PathSymbol3DLayer()
    profile: "quad",  // creates a rectangular shape
    width: 20,  // path width in meters
    height: 1,  // path height in meters
    material: { color: "#a382cc" }
  }]
};

// create a path with a square style
let wallPath = {
  type: "line-3d",  // 转换成 new LineSymbol3D()
  symbolLayers: [{
    type: "path",  // 转换成 new PathSymbol3DLayer()
    profile: "quad",  // creates a rectangular shape
    width: 20,  // this property also sets the height to 20 meters
    material: { color: "#a382cc" }
  }]
};

方法列表

方法详细说明

clone(){PathSymbol3DLayer}

创建符号层的深层克隆。

返回值:

类型	描述
PathSymbol3DLayer	返回调用此方法对象的深拷贝。

示例代码:

// Creates a deep clone of the graphic's first symbol layer
let symLyr = graphic.symbol.symbolLayers.getItemAt(0).clone();

fromJSON(json){*}static

创建此类的新实例，并使用从 GeoScene 产品生成的 JSON 对象的值对其进行初始化。传递给输入 json 参数的对象通常来自对 REST API 中的查询操作的响应，或者来自另一个 GeoScene产品的 toJSON() 方法。有关何时以及如何使用此函数的详细信息和示例，请参阅指南中的 使用 fromJSON() 主题。

参数:

json Object 实例的 json 表达式，以geoscene 格式显示。

返回值:

类型	描述
*	返回一个该类的新实例。

toJSON(){Object}inherited

将此类的实例转换为 GeoScene portal JSON 格式。 有关更多信息，请参阅 使用 fromJSON() 指南。

返回值:

类型	描述
Object	此类实例的 GeoScene portal JSON 格式。