Merge pull request #206 from Esri/tschie/symbolize-shapefile

Implementation of symbolize shapefile sample

Author: john0005

src/main/java/com/esri/samples/symbology/symbolize_shapefile/README.md

@@ -0,0 +1,35 @@
+<h1>Symbolize Shapefile</h1>
+
+<p>Demonstrates how to override symbols of the default renderer for a shapefile.</p>
+  
+<p><img src="SymbolizeShapefile.png"/></p>
+
+<h2>How to use the sample</h2>
+
+<p>Press the toggle button to switch between red and yellow symbols and the default renderer.</p>
+
+<h2>How it works</h2>
+
+<p>To change the renderer of a shapefile feature layer:</p>
+
+<ol>
+  <li>Create a <code>ShapefileFeatureTable</code> passing in the URL of a shapefile.</li>
+  <li>Create a <code>FeatureLayer</code> using the <code>ShapefileFeatureTable</code>.</li>
+  <li>Create a <code>SimpleLineSymbol</code> and <code>SimpleFillSymbol</code> (uses the line symbol).</li>
+  <li>Make a <code>SimpleRenderer</code> with the <code>SimpleFillSymbol</code>.</li>
+  <li>To apply the renderer, use <code>featureLayer.setRenderer(renderer)</code>.</li> 
+  <li>To go back to the default renderer, use <code>featureLayer.resetRenderer()</code>.</li>
+</ol>
+
+<h2>Features</h2>
+
+<ul>
+  <li>FeatureLayer</li>
+  <li>ShapefileFeatureTable</li>
+  <li>SimpleFillSymbol</li>
+  <li>SimpleLineSymbol</li>
+  <li>SimpleRenderer</li>
+</ul>
+
+
+

src/main/java/com/esri/samples/symbology/symbolize_shapefile/SymbolizeShapefile.png

@@ -0,0 +1,132 @@
+/*
+ * Copyright 2018 Esri.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not
+ * use this file except in compliance with the License. You may obtain a copy of
+ * the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+ * License for the specific language governing permissions and limitations under
+ * the License.
+ */
+
+package com.esri.samples.symbology.symbolize_shapefile;
+
+import java.io.File;
+
+import javafx.application.Application;
+import javafx.geometry.Insets;
+import javafx.geometry.Pos;
+import javafx.scene.Scene;
+import javafx.scene.control.Alert;
+import javafx.scene.control.ToggleButton;
+import javafx.scene.layout.StackPane;
+import javafx.stage.Stage;
+
+import com.esri.arcgisruntime.data.ShapefileFeatureTable;
+import com.esri.arcgisruntime.layers.FeatureLayer;
+import com.esri.arcgisruntime.loadable.LoadStatus;
+import com.esri.arcgisruntime.mapping.ArcGISMap;
+import com.esri.arcgisruntime.mapping.Basemap;
+import com.esri.arcgisruntime.mapping.view.MapView;
+import com.esri.arcgisruntime.symbology.SimpleFillSymbol;
+import com.esri.arcgisruntime.symbology.SimpleLineSymbol;
+import com.esri.arcgisruntime.symbology.SimpleRenderer;
+
+public class SymbolizeShapefileSample extends Application {
+
+  private MapView mapView;
+
+  @Override
+  public void start(Stage stage) throws Exception {
+
+    try {
+      // create stack pane and application scene
+      StackPane stackPane = new StackPane();
+      Scene scene = new Scene(stackPane);
+
+      // set title, size, and add scene to stage
+      stage.setTitle("Symbolize Shapefile Sample");
+      stage.setWidth(800);
+      stage.setHeight(700);
+      stage.setScene(scene);
+      stage.show();
+
+      // create a map with a basemap
+      ArcGISMap map = new ArcGISMap(Basemap.createTopographic());
+
+      // set the map to the map view
+      mapView = new MapView();
+      mapView.setMap(map);
+
+      // create a shapefile feature table from the local data
+      File shapefile = new File("./samples-data/auroraCO/Subdivisions.shp");
+      ShapefileFeatureTable shapefileFeatureTable = new ShapefileFeatureTable(shapefile.getAbsolutePath());
+
+      // use the shapefile feature table to create a feature layer
+      FeatureLayer featureLayer = new FeatureLayer(shapefileFeatureTable);
+      featureLayer.addDoneLoadingListener(() -> {
+        if (featureLayer.getLoadStatus() == LoadStatus.LOADED) {
+          // zoom to the feature layer's extent
+          mapView.setViewpointGeometryAsync(featureLayer.getFullExtent());
+        } else {
+          Alert alert = new Alert(Alert.AlertType.ERROR, featureLayer.getLoadError().getMessage());
+          alert.show();
+        }
+      });
+
+      // add the feature layer to the map
+      map.getOperationalLayers().add(featureLayer);
+
+      // create the symbols and renderer
+      SimpleLineSymbol lineSymbol = new SimpleLineSymbol(SimpleLineSymbol.Style.SOLID, 0xFFFF0000, 1.0f);
+      SimpleFillSymbol fillSymbol = new SimpleFillSymbol(SimpleFillSymbol.Style.SOLID, 0xFFFFFF00, lineSymbol);
+      SimpleRenderer renderer = new SimpleRenderer(fillSymbol);
+
+      // create a toggle button to switch between renderers
+      ToggleButton symbolizeButton = new ToggleButton("Toggle Symbology");
+      symbolizeButton.setOnAction(e -> {
+        if (symbolizeButton.isSelected()) {
+          featureLayer.setRenderer(renderer);
+        } else {
+          // switch back to the default renderer
+          featureLayer.resetRenderer();
+        }
+      });
+
+      // add the map view and toggle button to the stack pane
+      stackPane.getChildren().addAll(mapView, symbolizeButton);
+      StackPane.setAlignment(symbolizeButton, Pos.TOP_LEFT);
+      StackPane.setMargin(symbolizeButton, new Insets(10, 0, 0, 10));
+    } catch (Exception e) {
+      // on any error, display the stack trace.
+      e.printStackTrace();
+    }
+  }
+
+  /**
+   * Stops and releases all resources used in application.
+   */
+  @Override
+  public void stop() throws Exception {
+
+    if (mapView != null) {
+      mapView.dispose();
+    }
+  }
+
+  /**
+   * Opens and runs application.
+   *
+   * @param args arguments passed to this application
+   */
+  public static void main(String[] args) {
+
+    Application.launch(args);
+  }
+
+}