tutorial how to design an interactive stingray walk ... · edddison is the easiest way to navigate...

edddison is the easiest way to navigate through Stingray models.

TutorialHow to design an interactive Stingraywalk-through in minutes

edddison Tutorialwww.edddison.com

Design a Stingray walk-through in minutes

1. Install software

Install Stingray 1.4 or higher on your PC running Windows 7, 8, or 8.1

2. Install edddison

Install edddison on your computer. Follow the installation wizard until the end. You might need to restart your computer at the end of the installation process.

Click on the ‚Open plugin folder‘ to open the folder with the plugin script file and the tutorial.

Design a Stingray walk-through in minutes edddison Tutorialwww.edddison.com

3. Create project

In the Stingray-Project Manager create an empty project or open your own.

5. Copy edddison.lua

Copy edddison.lua from your “Documents” folder (C:\Users\your user name\Documents\edddison\stingray) to the “/YOUR_PROJECT/script/lua/ folder.

4. Add objects

Add objects or import your 3d models to the scene. Also add a Stingray Camera.

Design a Stingray walk-through in minutes edddison Tutorialwww.edddison.com

6. Open project.lua

Open project.lua (from the above folder) and search for this line:

function Project.on_level_load_pre_flow()

This function is usually located on line 27 within a new empty project.

7. Edit project.lua

Add the following lines before the above line:

local edddison = require 'script/lua/edddison'

And this line after the above line:

edddison.init()

If you want edddison to close with your project, search for the following line

function Project.shutdown()

and add the following beneath

edddison.close()



8. Adding a Boundingbox

You can use the edddison module to subscribe units by name:

edddison.subscribeUnit('YOUR_UNIT_NAME')

A full example could look like this:

function Project.on_level_load_pre_flow()

edddison.init(false)

edddison.subscribeUnit('bb_down floor')

edddison.subscribeUnit('bb_entire range')

end

9. Adding 3D objects

The same approach is going to be used for moveable 3D objects. Add an object to your Stingray Project, name it and paste it’s name in a new „edddison.subscribeUnit“-line in the project.lua file.



10. Starting edddison

Save your lua-files and press the “Run Project” Button in Stingray to run the scene and start edddison.

At the first start of edddison, don‘t forget to add your edddison license-file.

11. Prepare Stingray project in edddison

First you have to create control elements to interact with your Stingray scene.

Create Floor plans and connect them with your Bounding Box objects. (see 12.-14.)

Create moveable 3D objects and connect them with your Stingray objects.

Create a Point of view object and connect it with your Stingray camera. (see 15.)



12. Creating Floor Plans to connect with Bounding boxes

Floor plans are needed for easy and precise orientation in the 3D view.

Create an image (topview of your model) and use it as a floorplan to be shown on the edddison surface. If you choose a tablet as a control device, edddison will show the floorplan on the tablet.

14. Choose a Floor Plan image

Choose the Floor plan image you have prepared before.

Choose a name for your Floor Plan.

The image will be shown on the edddison surface.

13. Choose a Bounding Box

Select „Create Floorplan“ from the widget toolbar.

This will create the first walkable area in your scene.

In the next dialog window choose the bounding box you want to connect with the floorplan. Use the same approach for moveable 3D objects.



17. Deploy Stingray Project

If you create an executable file out of your project, you can use it on any machine where edddison is installed. Then edddison will start automatically at opening the “.exe”.

15. Create a Point of View object

Choose „Create Point of View“ from the widget toolbar.

Select the camera you have created in Stingray, usually named “Stingray camera”.

Choose a name or leave it as „Point of View“.

16. Take a Walk-through

Add more Floor Plans to switch between different floors and navigation areas.

Move the Point of View Icon to walk through your scene.

Use the mouse wheel to rotate your point of view.

Change properties/values to control height, tilt, roll and angle view.