Merge pull request #108 from Esri/john0005/TerrainExaggeration

Surface Terrain Exaggeration Sample

Author: john0005

src/main/java/com/esri/samples/scene/terrain_exaggeration/README.md

@@ -0,0 +1,27 @@
+<h1>Terrain Exaggeration</h1>
+
+<p>Demonstrates how to add vertical exaggeration to a scene's surface.</p>
+
+<p><img src="TerrainExaggeration.gif"/></p>
+
+<h2>How to use the sample</h2>
+
+<p>Selecting an exaggeration amount from the slider will apply that to the scene's surface.</p>
+
+<h2>How it works</h2>
+
+<p>To exaggerate a <code>Scene</code>'s <code>Surface</code>:</p>
+
+<ol>
+  <li>Create an elevated surface and add it to the scene, <code>Surface.getElevationSources().add("elevationURL")</code></li>
+  <li>Add surface to the scene, <code> scene.setBaseSurface(Surface)</code></li>
+  <li>Set exaggeration amount of the surface, <code>Surface.setElevationExaggeration(exaggeration)</code></li>
+</ol>
+
+<h2>Features</h2>
+
+<ul>
+  <li>ArcGISScene</li>
+  <li>Surface</li>
+  <li>ArcGISTiledElevationSource</li>
+</ul>

src/main/java/com/esri/samples/scene/terrain_exaggeration/TerrainExaggeration.gif

@@ -0,0 +1,86 @@
+/*
+ * Copyright 2016 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.scene.terrain_exaggeration;
+
+import javafx.fxml.FXML;
+import javafx.scene.control.Slider;
+
+import com.esri.arcgisruntime.geometry.Point;
+import com.esri.arcgisruntime.layers.ArcGISMapImageLayer;
+import com.esri.arcgisruntime.mapping.ArcGISScene;
+import com.esri.arcgisruntime.mapping.ArcGISTiledElevationSource;
+import com.esri.arcgisruntime.mapping.Basemap;
+import com.esri.arcgisruntime.mapping.Surface;
+import com.esri.arcgisruntime.mapping.view.Camera;
+import com.esri.arcgisruntime.mapping.view.SceneView;
+
+public class TerrainExaggerationController {
+
+  @FXML private SceneView sceneView;
+  @FXML private Slider exaggerationSlider;
+
+  public void initialize() {
+
+    try {
+
+      // create a scene and add a basemap to it
+      ArcGISScene scene = new ArcGISScene();
+      scene.setBasemap(Basemap.createNationalGeographic());
+
+      // add the SceneView to the stack pane
+      sceneView.setArcGISScene(scene);
+
+      // add base surface for elevation data
+      Surface surface = new Surface();
+      final String elevationImageService =
+          "http://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer";
+      surface.getElevationSources().add(new ArcGISTiledElevationSource(elevationImageService));
+      scene.setBaseSurface(surface);
+
+      // add terrain layer to scene
+      final String imageLayer =
+          "https://gis.grantcountywa.gov:6443/arcgis/rest/services/EveryoneData/SlopePercent/MapServer";
+      ArcGISMapImageLayer layer = new ArcGISMapImageLayer(imageLayer);
+      layer.loadAsync();
+      scene.getOperationalLayers().add(layer);
+
+      // set exaggeration of surface to the value the user selected
+      exaggerationSlider.valueChangingProperty().addListener(o -> {
+        if (!exaggerationSlider.isValueChanging()) {
+          surface.setElevationExaggeration((float) exaggerationSlider.getValue());
+        }
+      });
+      // add a camera and initial camera position
+      Point initialLocation = new Point(-119.94891542688772, 46.75792111605992, 0, sceneView.getSpatialReference());
+      Camera camera = new Camera(initialLocation, 15000.0, 40.0, 60.0, 0.0);
+      sceneView.setViewpointCamera(camera);
+
+    } catch (Exception e) {
+      // on any exception, print the stack trace
+      e.printStackTrace();
+    }
+  }
+
+  /**
+   * Disposes application resources.
+   */
+  void terminate() {
+    if (sceneView != null) {
+      sceneView.dispose();
+    }
+  }
+}

src/main/java/com/esri/samples/scene/terrain_exaggeration/TerrainExaggeration.png

@@ -0,0 +1,64 @@
+/*
+ * Copyright 2016 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.scene.terrain_exaggeration;
+
+import java.io.IOException;
+
+import javafx.application.Application;
+import javafx.fxml.FXMLLoader;
+import javafx.scene.Parent;
+import javafx.scene.Scene;
+import javafx.stage.Stage;
+
+public class TerrainExaggerationSample extends Application {
+
+  private static TerrainExaggerationController controller;
+
+  @Override
+  public void start(Stage stage) throws IOException {
+    // set up the scene
+    FXMLLoader loader = new FXMLLoader(getClass().getResource("/fxml/terrain_exaggeration.fxml"));
+    Parent root = loader.load();
+    controller = loader.getController();
+    Scene scene = new Scene(root);
+
+    // set up the stage
+    stage.setTitle("Terrain Exaggeration Sample");
+    stage.setWidth(800);
+    stage.setHeight(700);
+    stage.setScene(scene);
+    stage.show();
+  }
+
+  /**
+   * Stops and releases all resources used in application.
+   */
+  @Override
+  public void stop() {
+    controller.terminate();
+  }
+
+  /**
+   * Opens and runs application.
+   *
+   * @param args arguments passed to this application
+   */
+  public static void main(String[] args) {
+
+    Application.launch(args);
+  }
+
+}

src/main/java/com/esri/samples/scene/terrain_exaggeration/TerrainExaggerationController.java

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<?import javafx.scene.control.Label?>
+<?import javafx.scene.control.Slider?>
+<?import javafx.scene.layout.StackPane?>
+<?import javafx.scene.layout.VBox?>
+
+<?import com.esri.arcgisruntime.mapping.view.SceneView?>
+
+<StackPane fx:controller="com.esri.samples.scene.terrain_exaggeration.TerrainExaggerationController" xmlns:fx="http://javafx.com/fxml"
+           stylesheets="/css/style.css">
+    <!--SDK SceneView-->
+    <SceneView fx:id="sceneView"/>
+    <!--Slider box-->
+    <VBox StackPane.alignment="TOP_LEFT" maxWidth="200" maxHeight="50" spacing="5" styleClass="panel-region">
+        <Label text="Exaggeration"/>
+        <Slider fx:id="exaggerationSlider" max="5" majorTickUnit="1" minorTickCount="0" showTickMarks="true" 
+          showTickLabels="true" snapToTicks="true"/>
+    </VBox>
+</StackPane>