type
require(["esri/renderers/smartMapping/symbology/type"], function(typeSchemes) { /* code goes here */ });
esri/renderers/smartMapping/symbology/type
Object containing helper methods for getting optimal symbol themes used to create data-driven visualizations of unique values or types. The getSchemes() method is used to generate symbol properties best suited to the given basemap.
Method Overview
Name | Return Type | Summary | Object | |
---|---|---|---|---|
TypeScheme | Clones a type scheme object. more details | more details | type | |
TypeSchemes | Returns a primary scheme and secondary schemes defining symbol properties for type-based data-driven visualizations in a Layer. more details | more details | type |
Method Details
- cloneScheme(scheme){TypeScheme}
Clones a type scheme object.
Parameter:scheme TypeSchemeThe type scheme object to clone.
Returns:Type Description TypeScheme Returns a clone of the given type scheme object. Example:// clones the primary scheme returned from the getSchemes() method var typeScheme = primaryScheme.clone();
- getSchemes(params){TypeSchemes}
Returns a primary scheme and secondary schemes defining symbol properties for type-based data-driven visualizations in a Layer. The
basemap
parameter determines the color of the graphics used to visualize each feature. ThegeometryType
determines which type of symbol to return.Parameters:params ObjectSee the table below for details of each parameter that may be passed to this function.
Specification:The basemap to pair with the visualization. This value indicates the best symbol color for visualizing features with the given basemap.
geometryType StringThe geometry type of the features to visualize.
Possible Values: point | multipoint | polyline | polygon | mesh
theme StringoptionalDefault Value: defaultDetermines whether to return a standardized unique value scheme for point cloud class renderers (i.e. when the
CLASS_CODE
field is driving the visualization in a PointCloudLayer), or to return the other default primary schemes used in other unique value renderers generated for non-point cloud layer types.Possible Values: point-cloud-class | default
worldScale BooleanoptionalIndicates if the size units of the scheme will be in meters. This should be
true
when the scheme is intended for 3D volumetric symbology. Aview
must be provided if this property is set totrue
.view SceneViewoptionalThe SceneView instance in which the scheme will be used. This property is only applicable when the scheme will be used in conjunction with 3D symbols.
Returns:Type Description TypeSchemes Returns an object containing the optimal type scheme to use for the given basemap; it also contains secondary schemes. Example:// gets the primary scheme for the features of the given geometry type and basemap var schemes = typeSchemes.getSchemes({ basemap: map.basemap, geometryType: featureLayer.geometryType }); // the best default scheme for the layer and basemap var primaryScheme = schemes.primaryScheme;
Type Definitions
Properties defining the symbology scheme used to visualize features with attribute data-driven types.
- TypeSchemeForMesh
Properties defining the symbology scheme used to visualize mesh features driven by type-based attribute data.
- TypeSchemeForPoint
Properties defining the symbology scheme used to visualize point features driven by type-based attribute data.
- Properties:
- colors Color[]
The fill colors of the point symbols comprising the theme.
noDataColor ColorThe color of the point symbol used to indicate features with no data.
outline ObjectProperties for defining the outline of the marker symbol.
size NumberThe default size of the point symbol in pixels, points, or real-world units.
opacity NumberThe opacity of the point symbol.
- TypeSchemeForPolygon
Properties defining the symbology scheme used to visualize polygon features driven by type-based attribute data.
- TypeSchemeForPolyline
Properties defining the symbology scheme used to visualize polyline features driven by type-based attribute data.
- Properties:
- colors Color[]
The colors of the line symbols comprising the theme.
noDataColor ColorThe color of the line symbol used to indicate features with no data and features that are out of range.
width NumberThe default width of the line symbol in pixels or points.
opacity NumberThe opacity of the line symbol (0 - 1).
- TypeSchemes
The return object of the getSchemes() method.
- Properties:
- primaryScheme TypeScheme
The type scheme best suited for the given basemap and geometry type.
secondarySchemes TypeScheme[]Additional type schemes that may be used to visualize data of the given geometry type overlaid on the given basemap.
basemapId StringThe ID of the basemap associated with the given schemes.