Download the package from the asset store [LINK]. Import all the content of the package to you Unity3D project.

There is an example scene you can check. Go to the folder Assets->Neurorehablab->Scenes e open the scene MapperDemo.

If you want to add the Reh@Mapper to your scene, just drage the prefab “DeviceMapperPrefab” to your scene. The prefab is located in the folder Assets->Neurorehablab->Prefabs.

In both scenarios, either if you added the mapper to your scene or if you are exploring the example scene, the configuration steps are always the same.

To correctly configure the Reh@Panel Unity client, you must first create a Tag (“AvailableToMap”) and a layer to track the objects (any name is valid for the layer). The Tag, that must be name “AvailabeToMap”, identifies the objects in the scene that are mapped by the Reh@Panel Unity client. The Layer will only be used to display a preview of the object in the scene. If you need to creates this Tag and Layer, follow the next steps:

Create a tag named “AvailableToMap” (1, 2 e 3)

Add a new layer named “previewCamera” (4,5 e 6)

There are a few settings that you can change in the editor. Select the Reh@Panel Unity client prefab located in the folder Assets.>Neurorehablab->Prefabs (or click it in the hierarchy). In the inspector, you can change the default shortcut to display the Reh@Panel Unity client, choose which layer will be used  to display the object preview and which tag will be used to map the objects (must be the tag AvailableToMap).

Change settings:

1. Select the prefab in the hierarchy (7)
2. Choose Camera Layer = PreviewCamera (8)
3. Choose Gameobject to map = Available To Map (9)

After complete these configurations, you still have to add the tag ‘AvailableToMap’ to all the objects you want the mapper to track.

Add the tag to all objects that will be mapped

1. Choose an object and click on the dropdown next to the label ‘Tag’(10)
2. Choose the tag ‘AvailableToMap’ (11)

Once the scene is ready, you can run the game by pressing the button ‘Play’ and start calibrating the Mapper. To display the Mapper main window, press the shortcut key (default is ‘1’). Note that once you open the Mapper, the game will be automatically paused. To unpause the game you can close the Mapper window (by pressing the ‘X’ or pressing the shortcut key again) or you can press the mapper pause button (the ‘||’ button or the shortcut ‘F12’). All these controls are located on the top right of the mapper window.

After you open the Mapper, you can choose an object from the list of object to the right. After you choose an object, this will be displayed in the window ‘Selected GameObject’. You can add Mapper properties to the to the object by clicking the ‘+’ button.

There are 4 types of properties: Positions, Rotations, Values and Booleans. Pressing on these buttons adds or remove properties.

To map an input to a property, select the device from the device list and drag one of its inputs to the property you want to map. The input will change color to green and the property to orange. This indicates that the input is being used (and its information is being received at the moment) and the property has something mapped to it.

1. Select one object from the list of objects (1)
2. Add a property to that object (2)
3. Select the desired device from the device list (3)
4. Drag & drop the input on the property (4)
5. Press the calibration button to perform the calibration (5)

Once the editor window is open, you must choose the source in the Reading From section and click the calibration button. You must also fill the the output limit values to calibrate between the real world readings and the game world values.

Explore the example scene to see the mapper working.

Position/Rotation/Value editor Window

Boolean Editor