Grid Contour Toggle

Purpose

Demonstrates various tools for real-time terrain analysis.

How to Use

The MGRS Grid, Contours, Overlay, Overlay Maximum Angle and Add Gridloc Marker tools function by simple checkbox, dropdown selection or slider UI controls. 

The terrain panel appears by default on scene launch and is divided into the following options:

GUI Debug Menu Navigation

Top Options

• Toggle format of terrain maps; use the arrows to select between Split LMAB (default) and Single LMAB formats. System/System2 display various real-time stats.

General

• Clear Terrain – Removes an in-progress or completely loaded terrain map from the scene.
• Clear Data Cache – Removes …\AppData\LocalLow\USC-ICT\Ride\datacache folder; use this command in the event terrain maps fail to load properly.
• Center Camera – Places the camera at the defined map center of the terrain map.

Load Terrain

• Load Trees – Click to toggle off/on. Replaces low-detail tree geometry in the map with various high-fidelity SpeedTree objects; note, may not be available in all maps.
• Use Camera Pos As Start – Terrain map streams into scene from approximate scene camera location; used in conjunction with Radius slider.
• Radius – Adjust the slider to change the distance at which terrain tiles are rendered from the current camera position.  
• Use Asset Bundles – Test command for future delivery method of terrain map data. 
• Progress – Indicator of approximate completeness for the streaming of the current terrain map into the scene. 
• Time – Tracks how long the terrain map took to stream into the scene, reaching 100% completion. 
• Plane – Instances a simple plane object for test purposes; note, does not have tree objects.

Load Terrain – Split LMAB Format & LOD

• Select a terrain map, choose a LOD setting (lowest selected by default) and then click Load Terrain to begin streaming that terrain map data into the scene. Overall progress statements incrementally appear until loading finishes (1.0 value).

Load Terrain – Single LMAB Format & LOD

• Select a terrain map, choose a LOD setting (lowest selected by default) and then click Load Terrain to begin streaming that terrain map data into the scene. Overall progress statements incrementally appear until loading finishes (1.0 value).

Scene Location & Name

Assets/Ride/Examples/GridContourToggle/ExampleGridContourToggle.unity

Setup Requirements 

Utilize the Grid Contour Toggle tools by adding related script and prefabs to your scene. Refer to the example scene for all components.  

ExampleGridContourToggle Script

Add this script to an empty object in your scene to enable the contour tools. This script is derived from ExampleLoadTerrain, hence the terrain loading debug panel. Modify as needed to suit your own needs. 

LocationMarker Prefab

To enable the Gridloc Marker tool, add the LocationMarker prefab to your scene, then disable it from startup. The related prefab under the Canvas object will handle the UI.

Canvas and Prefabs

Add a Canvas object to the scene to organize the different UI elements. Next, add the following prefabs as child objects:

• GeoreferenceDisplayMenu
• GeoreferenceLocationMarkerMenu
• ShadingMenu

RideSystems Prefab

Instance the RideSystems prefab in your scene to enable the various necessary RIDE systems. Expand it in the Hierarchy panel, choose ResourceLoader, and add the LocationMarker prefab to the Unit Prefabs section.

Camera

Recommend adding the Simple Terrain Camera script to the Camera object, per the controls described above for manipulating the camera at run-time.