Class LoadSettings


  • public final class LoadSettings
    extends Object
    Contains properties that set the rendering behavior for a map or scene as it loads. It allows you to specify preferences, or "hints", concerning how the map/scene should treat feature layers.

    There are two alternative work flows for using LoadSettings. The first is useful for setting the same settings on more that one map or scene, for example:

     LoadSettings loadSettings = new LoadSettings();
     loadSettings.setPreferredPointFeatureRenderingMode(FeatureLayer.RenderingMode.DYNAMIC);
     loadSettings.setPreferredPolylineFeatureRenderingMode(FeatureLayer.RenderingMode.DYNAMIC);
     loadSettings.setPreferredPolygonFeatureRenderingMode(FeatureLayer.RenderingMode.DYNAMIC);
     ArcGISMap map1 = new ArcGISMap();
     ArcGISMap map2 = new ArcGISMap();
     map1.setLoadSettings(loadSettings);
     map2.setLoadSettings(loadSettings);
     
    The second is useful for modifying the default settings on one map or scene, for example:
     ArcGISScene scene = new ArcGISScene();
     scene.getLoadSettings().setPreferredPointFeatureRenderingMode(FeatureLayer.RenderingMode.DYNAMIC);
     
    Since:
    100.2.0
    • Constructor Detail

      • LoadSettings

        public LoadSettings()
        Creates a new load settings instance with default values.
        Since:
        100.2.0
    • Method Detail

      • setPreferredPointFeatureRenderingMode

        public void setPreferredPointFeatureRenderingMode​(FeatureLayer.RenderingMode renderingMode)
        Sets the preferred rendering mode for point and multi-point based feature layers. The layer will attempt to render in the specified mode if this is supported. If for example DYNAMIC is not supported by a layer's renderer then it will fall back to rendering in STATIC mode.
        Parameters:
        renderingMode - the preferred rendering mode
        Throws:
        IllegalArgumentException - if renderingMode is null
        Since:
        100.2.0
      • getPreferredPointFeatureRenderingMode

        public FeatureLayer.RenderingMode getPreferredPointFeatureRenderingMode()
        Gets the preferred rendering mode for point and multi-point based feature layers. The default value is AUTOMATIC.
        Returns:
        the preferred rendering mode for point and multi-point based feature layers
        Since:
        100.2.0
      • setPreferredPolylineFeatureRenderingMode

        public void setPreferredPolylineFeatureRenderingMode​(FeatureLayer.RenderingMode renderingMode)
        Sets the preferred rendering mode for polyline based feature layers. The layer will attempt to render in the specified mode if this is supported. If, for example, DYNAMIC is not supported by a layer's renderer then it will fall back to rendering in STATIC mode.
        Parameters:
        renderingMode - the preferred rendering mode
        Throws:
        IllegalArgumentException - if renderingMode is null
        Since:
        100.2.0
      • getPreferredPolylineFeatureRenderingMode

        public FeatureLayer.RenderingMode getPreferredPolylineFeatureRenderingMode()
        Gets the preferred rendering mode for polyline based feature layers. The default value is AUTOMATIC.
        Returns:
        the preferred rendering mode for polyline based feature layers
        Since:
        100.2.0
      • setPreferredPolygonFeatureRenderingMode

        public void setPreferredPolygonFeatureRenderingMode​(FeatureLayer.RenderingMode renderingMode)
        Sets the preferred rendering mode for polygon based feature layers. The layer will attempt to render in the specified mode if this is supported. If for example DYNAMIC is not supported by a layer's renderer then it will fall back to rendering in STATIC mode.
        Parameters:
        renderingMode - the preferred rendering mode
        Throws:
        IllegalArgumentException - if renderingMode is null
        Since:
        100.2.0
      • getPreferredPolygonFeatureRenderingMode

        public FeatureLayer.RenderingMode getPreferredPolygonFeatureRenderingMode()
        Gets the preferred rendering mode for polygon based feature layers. The default value is AUTOMATIC.
        Returns:
        the preferred rendering mode for polygon based feature layers
        Since:
        100.2.0
      • isUseAdvancedSymbology

        public boolean isUseAdvancedSymbology()
        Gets whether service feature tables will use advanced symbology.
        Returns:
        true if the tables will use advanced symbology, false otherwise
        Since:
        100.2.0
      • setUseAdvancedSymbology

        public void setUseAdvancedSymbology​(boolean useAdvancedSymbology)
        Sets whether service feature tables will use advanced symbology. If the tables are already loaded this setting will have no effect. The default is true.
        Parameters:
        useAdvancedSymbology - true for tables to use advanced symbology, false for simple symbology
        Since:
        100.2.0
      • setFeatureServiceSessionType

        public void setFeatureServiceSessionType​(FeatureServiceSessionType featureServiceSessionType)
        Sets the session type to use for branch-versioned ServiceGeodatabase objects.
        Parameters:
        featureServiceSessionType - the session type to use for branch-versioned geodatabases
        Throws:
        IllegalArgumentException - if featureServiceSessionType is null
        Since:
        100.10.0
      • getFeatureTilingMode

        public FeatureTilingMode getFeatureTilingMode()
        Gets the feature tiling mode of each feature layer that is loaded. Default is FeatureTilingMode.ENABLED_WHEN_SUPPORTED.

        Changes how feature tiling is handled by each feature layer. Individual feature layers can override these settings.

        Returns:
        determines whether or not feature tiling is used to render layers that support its use.
        Since:
        100.10.0
        See Also:
        FeatureTilingMode
      • setFeatureTilingMode

        public void setFeatureTilingMode​(FeatureTilingMode featureTilingMode)
        Sets the feature tiling mode of each feature layer that is loaded.
        Parameters:
        featureTilingMode - the feature tiling mode to use when rendering layers that support its use
        Throws:
        IllegalArgumentException - if featureTilingMode is null
        Since:
        100.10.0