Ecoscape Interactive Viewer 

User Guide

A three button mouse with scroll wheel is required for full viewer functionality. Simple, inexpensive 3-button with scroll wheel mouse products are readily available online.

Download Viewer

  1. Sign in to your Sunscape® account from ecoscape.app.  

  2. Go to your ‘Download’ section and select to download the Viewer. 

Initialize the Viewer and Load the Sunscape® mapped model.

  1. Click the Viewer Icon on your desktop screen.

  2. Initialize the Viewer the first time you use it, by entering your assigned API key at the input prompt.

    TIP- copy and paste the API key from your Welcome to Ecoscape email 

  3. Press Start.

  4. Select to highlight a Sunscape® Mapped Model file then press confirm to load.

  5. Reload models anytime using ‘Load’ on the function bar at the top of the viewer.

Position and resize Viewer

  1. Move the Viewer up by clicking and dragging the Sunscape® header bar.

  2. Resize the Viewer by clicking and dragging Viewer side and bottom edges. 

Select Sunscape® Maps

Sunscape® Maps are listed in the Sunscape® Map queue in the right-side View Area.

Maps are labeled with date range followed by timespan.

  1. Beginning date - Ending date (number day, roman numeral month)

  2. Beginning time - Ending time (24 hour clock format)

  3. Label may include a Named date range or timespan

  4. Click the label to bring the Map to the Viewer.  

View your mapped Model 

View Area – Click the cube top face for top view, or circle segment for cardinal directions (hover circle segment, click blue)

Move – Positron mouse, click to hold Right Button and drag mouse to move the map around on the viewer screen. Move mouse in a horizontal direction if you wish to avoid changing perspective.

Orbit – Position mouse, click to hold the mouse Wheel or Left Button and drag the mouse to turn the model up, down, right, and left on the screen.  To continue to turn the model, orbit, reposition mouse, continue turning.

Zoom In and Out  – Scroll the mouse Wheel forward and back to see close-up and pan views.

Save an Image of your mapped Model 

  1. Choose ‘Save’ from the Function Toolbar at the top of the Viewer.

  2. Input a name for the image file in the large section of the line provided.

  3. Click “Path” to choose a storage location on your system, and ‘Save’.

  4.  Print image file or transfer image file to your phone for outdoor viewing.

Close and Reopen the Viewer

  1. Choose ‘Exit’ from the Function Toolbar at the top of the Viewer to close the Viewer.

  2. To reopen, select the Viewer Icon from your screen, your model(s) will be listed for selection.

More about the Viewer 


Viewer Screen

  1. Model Geolocation is displayed in the upper left of the viewer.

  2. The map’s daytime and date range are displayed on the line below geolocation.

  3. The Sunscape® Map legend is on the left. The legend is segmented into colors that indicate sun exposure. 

  4. A North indicator is located bottom right and changes with map orientation.

  5. A curser related sun exposure indicator is located bottom left.

    1. The indicator reads “no data” when the cursor is positioned on a non-mapped area of the model.

Note:  Maps are segmented into sun exposure based on the sunlight received during the timespan and date range of the map.   

Viewer Function Toolbar - located at the top of the Viewer.

  1. Load, to select a model for import.  

  2. Save, to save Sunscape® Viewer images. 

  3. Exit, for exiting and closing the Viewer.

View Menu - located on the right, provides tools for interacting with maps in the Sunscape® Viewer:

  1. Top and Cardinal Direction, use cube faces, and circle segments (hover to turn blue then click) for snap-to camera views.

  2. Edges, to view model object edges, click ‘Default’ to turn Edges off.

  3. 2-sided rendering, select to see 2D objects from all viewing perspectives. (Ecoscape models do not have 2D objects)

  4. Sunscape® Map queue lists maps with date range and timespan labels, click to bring the map to the Viewer. 

Perspective

  1. Models are brought to the Viewer in the original file perspective.

  2. Maps are brought to the Viewer in the perspective of the previous map.  This makes it easy to compare area sun exposure by toggling between different timespan and date range maps without having to readjust the perspective for each map.

  3. If your mouse action appears ‘unstable’ click on the cube top face in the right-side View Menu.  This will change perspective to a top view of the model and initialize your mouse.   

  4. If the process of moving, zooming, and orbiting gets you into an awkward view of the model that is difficult to remedy, simply ‘Exit’ the Viewer, and ‘Start’ again.  

If you have questions or require assistance, please email us.  We’re here to help.

Your Technical Support Team

techsupport@ecoscape.app.