位置

方法概述

方法详情

createRenderer(params){Promise<RendererResult>}

生成渲染器可直接应用到受支持的图层。渲染器包含基于视图背景的颜色优化选择的单一符号。

通常将提供 图层 和视图 来生成这个渲染器。如果在 3D SceneView 中工作，则应使用symbolType 选项。

参数:

规范:

params Object 用于生成基于位置的可视化的输入参数。 有关每个参数的详细信息，请参见下表。 详述： layer FeatureLayer|SceneLayer|CSVLayer|GeoJSONLayer|WFSLayer|OGCFeatureLayer 生成可视化的图层。 view View optional 渲染输入图层的视图。 此方法检查视图的背景（即底图、Web 地图背景或视图容器）以确定输出渲染器的最佳颜色。 在实践中应始终设置此参数，但如果未提供，此方法将假定生成的渲染器将显示在浅色背景上。 locationScheme LocationScheme optional 在创作应用程序中，用户可以选择预定义的位置方案。 将方案对象传递给此属性以避免根据视图的背景获取一个。 sizeOptimizationEnabled Boolean optional 默认值: false 仅适用于点和折线图层。 表示符号大小是否应根据视图比例而变化。 设置后，必须在 view 参数中提供有效的 MapView 实例。 3D SceneViews 不支持此选项。 outlineOptimizationEnabled Boolean optional 默认值: false 仅适用于多边形图层。 表示多边形轮廓宽度是否应根据视图比例而变化。 设置后，必须在 view 参数中提供有效的 MapView 实例。 3D SceneViews 不支持此选项。 symbolType String optional 默认值: 2d 要生成的符号类型。 这取决于您正在使用的视图和所需的可视化。 不需要为具有网格几何类型的图层指定此参数。 可能的值如下所述。 值 描述 2d 使用 2D 符号（如 SimpleMarkerSymbol ， SimpleLineSymbol 或  SimpleFillSymbol）生成可视化。如果在 MapView 中生成数据的可视化，请使用此选项。 3d-flat 使用具有平面符号图层（如 IconSymbol3DLayer, LineSymbol3DLayer 或 FillSymbol3DLayer）的 3D 符号生成可视化。 如果为 SceneView 中的数据生成 2D 可视化，请使用此选项。 3d-volumetric 使用具有体积符号图层（例如 ObjectSymbol3DLayer, PathSymbol3DLayer 或 ExtrudeSymbol3DLayer）的 3D 符号生成可视化。 如果为  SceneView 中的数据生成 3D 可视化，请使用此选项。 如果使用此选项，则必须将 SceneView 实例提供给 view 参数。 3d-volumetric-uniform 使用具有体积符号图层的统一大小的 3D 符号生成可视化。 如果为 SceneView 中的数据生成 3D 可视化，并且符号的大小应统一（例如球体），请使用此选项。 如果使用此选项，则必须将 SceneView 实例提供给 view 参数。 可能值:"2d"|"3d-flat"|"3d-volumetric"|"3d-volumetric-uniform" colorMixMode String optional 默认值: replace 此选项仅适用于为网格 SceneLayers 生成渲染器。指定符号颜色如何应用于几何颜色/纹理。 有关更多上下文，请参阅 FillSymbol3DLayer.material 中的文档。 有关可能的值，请参见下表。 值 描述 tint 将符号颜色 应用于不饱和几何/纹理颜色。 replace 移除几何/纹理颜色并应用符号颜色。 multiply 将几何/纹理颜色值与符号颜色值相乘。 结果是颜色较深。 与白色相乘可保持几何颜色相同。 signal AbortSignal optional 允许取消请求。如果被取消，promise 将被拒绝，并返回 AbortError的错误并显示 AbortController。

返回：

类型	描述
Promise<RendererResult>	解析为 RendererResult 的一个实例。

例如：

let layer = new FeatureLayer({
  url: "https://services.arcgis.com/V6ZHFr6zdgNZuVG0/arcgis/rest/services/counties_politics_poverty/FeatureServer/0"
});

// simple visualization to indicate features with a single symbol
let params = {
  layer: layer,
  view: view
};

// when the promise resolves, apply the renderer to the layer
locationRendererCreator.createRenderer(params)
  .then(function(response){
    layer.renderer = response.renderer;
  });

类型定义

RendererResult

 createRenderer() 方法的结果对象。有关每个属性的详细信息，请参见下表。

属性：

renderer SimpleRenderer 配置了最适合与视图背景匹配的单一颜色的简单渲染器。设置这个图层的renderer 属性来更新它的可视化。

locationScheme LocationScheme 渲染器使用的位置方案。

basemapId String 用于确定要素的最佳填充颜色的底图的 ID。

basemapTheme String 表示输入视图底图的平均颜色是浅色还是深色。