Method Overview

Method Details

createRenderer(params){Promise<RendererResult>}

Generates a Renderer that may be applied directly to a supported Layer. The renderer contains a single symbol with a color optimally chosen based on the indicated basemap.

In most cases you will provide a layer and basemap to generate this renderer. If working in a 3D SceneView, then the view and symbolType options should be used.

Parameters:

Specification:

params Object Input parameters for generating a location-based visualization. See the table below for details of each parameter. Specification: layer FeatureLayer|SceneLayer|CSVLayer|GeoJSONLayer The layer for which the visualization is generated. view View optional The view where the input layer is rendered. This method inspects the view's background (i.e. basemap, web map background, or view container) to determine optimal colors for the output renderer. This parameter should always be set in practice, but if not provided this method will assume the generated renderer will display on a light background. basemap String|Basemap Deprecated since version 4.13. Use view instead. optional Default Value: gray The named string or basemap object of the Esri basemap that will be paired with the output visualization. Determines optimal colors for the output renderer. locationScheme LocationScheme optional In authoring apps, the user may select a pre-defined location scheme. Pass the scheme object to this property to avoid getting one based on the basemap. sizeOptimizationEnabled Boolean optional Default Value: false For point and polyline layers only. Indicates whether symbol sizes should vary based on view scale. When set, a valid MapView instance must be provided in the view parameter. This option is not supported for 3D SceneViews. outlineOptimizationEnabled Boolean optional Default Value: false For polygon layers only. Indicates whether the polygon outline width should vary based on view scale. When set, a valid MapView instance must be provided in the view parameter. This option is not supported for 3D SceneViews. symbolType String optional Default Value: 2d The type of symbol to generate. This depends on the view in which you are working and the desired visualization. This parameter does not need to be specified for layers with a mesh geometry type. Possible values are described below. Value Description 2d Generates a visualization using 2D symbols such as SimpleMarkerSymbol, SimpleLineSymbol, or SimpleFillSymbol. Use this option if generating a visualization for data in a MapView. 3d-flat Generates a visualization using 3D symbols with flat symbol layers such as IconSymbol3DLayer, LineSymbol3DLayer, or FillSymbol3DLayer. Use this option if generating a 2D visualization for data in a SceneView. 3d-volumetric Generates a visualization using 3D symbols with volumetric symbol layers such as ObjectSymbol3DLayer, PathSymbol3DLayer, or ExtrudeSymbol3DLayer. Use this option if generating a 3D visualization for data in a SceneView. A SceneView instance must be provided to the view parameter if this option is used. colorMixMode String optional Default Value: replace This option only applies to generating renderers for mesh SceneLayers. Specifies how the symbol's color is applied to the geometry color/texture. See the documentation in FillSymbol3DLayer.material for more context. See the table below for possible values. Value Description tint Applies the symbol color to the unsaturated geometry/texture color. replace Removes the geometry/texture color and applies the symbol color. multiply Multiplies geometry/texture color value with the symbol color value. The result is a darker color. Multiplying with white keeps the geometry color the same.

Returns:

Type	Description
Promise<RendererResult>	Resolves to an instance of RendererResult.

Example:

var 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
var 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;
  });

Type Definitions

RendererResult

The result object of the createRenderer() method. See the table below for details of each property.

Properties:

renderer SimpleRenderer A simple renderer configured with a single color best suited to match the given basemap. Set this to a layer's renderer property to update its visualization.

locationScheme LocationScheme The location scheme used by the renderer.

basemapId String The ID of the basemap used to determine the optimal fill color of the features.

basemapTheme String Indicates whether the average color of the input view's basemap is light or dark.