Onboarding guide and manual

Manual is focused on fast user onboarding. Our platform is primarily designed for Virtual Reality, offering an immersive and intuitive experience.

Recommended PC specs

GPU

  • NVIDIA RTX 3060 with at least 8GB or more
  • or an AMD equivalent GPU, eg. Radeon RX 6700 XT with at least 8GB or more

CPU

  • Intel i5-4590 / AMD Ryzen 5 1500X or greater

We support following headsets

  • Meta Quest 3
  • Meta Quest 2
  • Meta Quest Pro
  • HTC XR Elite
  • HTC Vive Focus 3
  • PICO 4
  • HP Reverb G2

Switch between VR and Desktop version

You can switch between VR and desktop seamlesly anytime by pressing “V” on your keyboard

We focus on the spatial experience, so the VR version of the platform may have more tools and more options – for example, VR version has more natural work with curved and organic surfaces, spatial drawing or just overall immersion.

Although focused on spatial interaction, most of the tools are available in a 2D desktop version and the user interface is very similar.

Launcher

To join Wearrecho platform, login via launcher with your credentials

1 If the update is available, it is recommended to download it

Note:
To run the VR version of the platform, the headset must be connected to the computer. You don’t need to use SteamVR for Wearrecho.

You can run the platform in desktop or VR versions. You can switch between modes at any time.

1 Choose whether you want to run the desktop or VR version. However, you can switch between either mode at any time using the “V” keyboard shortcut

2 You can select to run platform in the easy mode (checked by default, you can switch to editor mode in the settings)

Open Settings menu

Note:
Other UI elements are available and described in the individual chapters. The settings menu is essential for getting started and for opening projects, sessions and overall collaboration

A) In VR

In a VR environment with both controllers, proceed as shown in the figure below – that is, place the secondary hand controller (left on the picture) with its head at the base of the main hand controller (right on the picture). The Settings menu will appear in front of you:

B) On desktop

The settings menu in desktop mode is always in the same position – on the right side of the screen recognisable by the gear icon

When you open the settings table, you will see several tabs – projects, settings, manual settings and notifications. Here you can also turn off the platform.

Project settings (Open project, Load-Save, Location,…)

2 General settings (Movement, Graphical settings, …)

3 Notifications (Overall notifications, accept summon, …)

4 Turn off platform

5 Close tab

6 Easy mode switch

Basic platform control – VR

1. Teleport

• For a classic VR teleport, put the joystick on the main hand in the “forward” position – a circular marking will appear at the end of the laser pointer (on the ground), showing the teleport destination

Shortcuts during teleport

A) Scale yourself by 500%

Use teleport directly above you to scale by 500% (repeatable)

B) Scale yourself back to 100% (1:1)

Hold the teleport for 3 seconds (the teleport visual will change as an indication)

2. Rotate

• Rotate physically or using the joystick on the main hand by positioning left and right

3. Scale

• By holding both grips and moving the controllers towards each other or away from each other while releasing them.

• Your size is displayed as a percentage (%) and is visible between the controls in front of you when scaling.

100% is 1:1 scale.

4. Climbing

• Hold the grip on the main controller and move the controller up and down while holding to move vertically up and down.

• With the floor height set in the VR headset, it is then the actual height of the user in the VR space.

• 0 is your base offset (height).

5. Continuous movement

• For more experienced VR users, there’s smooth motion, creating the impression of walking.

• By holding the right grip button on the side of the controller and moving the joystick. This movement is also suitable for use while sitting.

This movement is ideal when: sitting or in a limited space.

Basic platform control – 2D

This is a very simplified mode for browsing and newcomers to the spatial environment with simplified navigation elements and no editing options. To start:

1 Leave it checked if you want the platform to start in easy mode (it will remember this for the future)

2 In the settings tab, you can turn easy mode on and off in an already open platform

Simplified mod is available in both VR and desktop versions. Both have a simplified user interface in the following form:

1 Open Guides (how to move)

2 Open saved Views

3 Open Settings tab

4 Change Weather and Time

5 Turn on/off Grid visibility

6 Open Layers tab

7 Turn on/off Spectator

Basic functions (Easy mode and Observer)

A) Open saved Views

• Saved views are used to keep the intended views – including the time, layers and user position

1 Hover over the image and click to teleport to this view (including saved time, layers and position in that view)

2 Hover over the image on the very left to see other views on the carousel

B) Turn on/off Grid visibility

• It may happen that the grid is sometimes turned on, which can have a negative impact on the visual impression of the scene. This function can be used to toggle its visibility

C) Change Time and Weather

• Time tab is connected with real-world location and sun position

1 Change the time of day

2 Manually rotate sun position

3 Change month

4 Weather presets

D) Turn on/off Layers

• User defined layers. Sometimes some items may be attached to a layer and may be hidden on purpose.
You can hide and unhide these items on this tab.

1 Hide/Unhide layer

2 Switch to BIM Revit layers

E) Turn on/off Spectator mode

• Spectator simulates real life walking – by moving on the surface such as floor, terrain, but allouws you to climb up stairs, ramps and other surfaces
• When in VR using Easy mode, Spectator is enabled automatically
• Works both on desktop and VR

1 The user walks on the surface

2 there is slow, free fall if the user does not have a surface below them

• When spectator is on, the icon is blue

Tip: Scene

Settings tab > Settings > Scene

1 To stabilize VR footage on your screen in real time – switch this functionality ON. Switching ON has a minor effect on performance

2 Change the Graphics from Minimalistic to High if your computer is powerful enough

3 Also, check VSync box to sync platform FPS with your monitor refresh rate

Optionally, for better GPU utilisation during 2D desktop mode, you have the option to set a FPS limit (the lower, the less demanding. 50-90 FPS is recommended for editor desktop use)

The main difference between minimalistic and high settings is that high settings have a better display of shadows and reflective surfaces. However, this is at the expense of performance.

Note:
It’s up to you how complex your spaces are. We don’t limit you, however the frame rate drops below 70 and becomes unpleasant if you have too many high-poly objects, lights and high settings.

The difference between minimalistic (left) and high (right) settings:

Note:
Scenes with a large number of polygons, especially imported polygons, but also lights and shadows, are the biggest burden on performance.

Tip: Movement (VR only)

Settings tab > Settings > Movement

1 Set your speed of walking/flying from 1 to 5 (lower is better people sensitive for motion sickness and unexperienced VR users)

2 Set your rotation from 15°, 30°, 45° and 90°

3 Teleport to 0,0,0 is there if you get lost and want to reset your position to „project zero“ (entry point)

4 Teleport ignores walls – checbox is there for more simple teleport solution:

  • Unchecked – default state. You can teleport everywhere – on visible grid, on objects above you (for example to get to the higher floors quickly). It simply knows about collision with other objects
  • Checked – this state allows you to teleport ONLY on grid (even when its hidden). In this case, your teleport will ignore walls and you can move freely on one plane. To move to different floor, you need to be on the correct floor

Tip: Report issue

Settings tab > Settings > Report

While using the platform, you may encounter something that seems like it should be different or doesn’t work as expected.

Feel free to let us know at the link the report button directs you to:

Report page

During a VR session, you see on your monitor what another user sees in VR. In this scenario, enter observer mode by pressing the SPACEBAR.

A) This mode is recommended for new VR users. The user in VR doesn’t even need controllers in this mode, everything can be controlled from the desktop view

B) Once you enter oberserver mode, you’ll be able to control several things in the scene from your PC, including the VR user’s position or time

Most of the functions are the same as in Easy mode:

1 Change resolution for a better quality, if needed

2 VR display view with stabilizer (stabilized, no shake)

3 Summon the user to the current desktop and position view

Be careful – try not to fly – the user will be teleported to your position and this will cause him to free fall

Platform cloud

Our platform offers its own cloud service. This brings various benefits:

A) Centralized organization: everything is conveniently organized, ensuring seamless access and efficient management of your project files.

B) Universal accessibility: Enjoy the freedom to access your project from anywhere at any time, empowering you to collaborate and work remotely without constraints.

C) Automatic saving: Forget manual saves – our cloud service automatically saves your progress, eliminating the risk of data loss and providing peace of mind.

Project tab (Settings)

1 Project – the first tab in the Settings

2 Options to login in | out, open projects, join live sessions or save and load current scene

3 Information about the current session and its users

4 Save / Load progress

5 Current active project and status

6 Current project location (automatically from Revit or added manually)

Projects

Chapter will focus on the basic work with projects – creating them, opening them and general work with them.
The principle of working with projects and folders on cloud is generally the same as when working on a computer, which you are used to.

In this chapter you will be able to look at:

  • (A) Create a new project
  • (B) Open/Load new or existing project
  • (C) Save project
  • (D) Copy, Delete or Rename project
  • (E) Offline project workflow

(A) Create a new project

A) In the Settings tab, select Project

1 Open the Settings tab and select Project from the tabs

2 Open Project

B) Project tab will open

1 List of Projects and Directories (Folders). Directories are in blue highlight

2 Create new Directory

3 Select New Project to create a new one


(B) Open/Load new or existing project

When you created project, or project already exists:

A) Select intended project / directory

1 Click on the project name, it will take you to the Saves of that project

B) Open the last auto or manual save

You then have two options – continue where you left off (autosave), or open one of the saved manual saves – (user saved) project milestones


Remember: If you create a new project, it will automatically create an autosave. Open this autosave to start working on the project!

1 Switch to Autosave – to continue where you finished

2 Manual save – you can save your progress and create milestones

(C) Save project

Live projects save automatically, so you can pick up where you left off.

1 To save or load project milestones or other project versions, select Save or Load option

(D) Rename, Delete or Copy

Projects, directories or saves. These changes can only be made by the Company admin and the user who created the project. If these options are not interactive, then you are not the admin or the project administrator.

A) Rename

1 You can rename directories, projects and project saves. Just click on the following:

B) Delete

1 You can delete directories, projects and project saves. Just click on the following:

C) Move

1 You can move directories and projects (not saves). Just click on the following:

2 After clicking on the move function, the bottom part of the UI offers 2 options – Put Here and Cancel

Go to the Directory where you want to move the project and click on Put Here. The task will move the project/directory.

To abort the move, click Cancel.

(E) Offline workflow

Platform is designed for online, and real-time collaboration is at the heart of what we do. We don’t currently have plans to support a fully-featured offline mode.

The file will be saved locally as .WR. This is a snapshot of the current file, and doesn’t include any version history or comments. When you import the .WR into platform, it will be treated as a new file. For this reason, we only recommend using this approach as a last resort.

A) Save offline version

1 Under Save on the Project tab, select Save to File. This opens a Windows tab where you name the file and save it locally.

B) Load offline version of the project

Make sure that no session is active – so you are not in any online project. If you are in an online scene, say Disconnect.

1 In the Project Tab select Load

2 Select Load from file

A) Open Join Session in the Settings …

.. and simply select the live session you want to join – that’s it!

Live sessions are created automatically when someone from the same company has opened a project and is in an active session.

Note:
If a project is already opened, another person cannot open the same project – they must join this live session of the project

B) Or Join Session directly next to a project
name

The session is created automatically if someone opens the project on the cloud. If there is no one in the project, this option will not be there and you can start the session – just open the project.

Tip: Collaboration Settings

1 Microphone on/off

2 Sound on/off (of other users during collaboration)

3 Summoning (teleport to your location) an individual or a whole group of people currently on the scene

Notes are another great tool for asynchronous communication – more about this feature in the Chapter 3 – under Annotation part

Tip: User Summon

Settings tab > Settings > User Summon

During multiplayer session, you can summon other users to your position and your VR scale

1 click on the username of the person you want to summon to summon them

2 click on “summon all” to summon all users in the scene

Important:
• If the user is in Spectator Mode or Easy Mode, he will be summoned directly.
• If the user is in Edit Mode (default if not in Easy Mode), they will need to confirm the action (a confirmation window will open)


The EDITOR section will focus on advanced UI that allows you to create attractive environments and basic settings – either the scene itself or by manipulation.
The image below shows several states of creating a sample project at your disposal – from an initial concept created in a multi-person collaboration in VR, to taking it into the Revit environment and parametric measures, culminating in a parametric model directly in VR with a staged scene to illustrate the architectural vision.


parametric, detailed BIM model from the Revit environment is then identical in the platform environment (one Digital Twin) – if you manipulate this model, then the Revit environment will reflect the changes (more on Revit in Chapter 3)

Enhanced controls over Easy Mode for editing and creation

Decelect / Escape (ESC)

• Deselect, escape (ESC), or whenever there is something unwanted, we want to close the menu, return to the basic state, we can use Escape by moving the joystick on the secondary controller (with palette menu) backwards

• It can also be used during creation to interrupt and save the progress of the current function – e.g. ending drawing a curve, saving material modifications, etc.

Undo – Redo

• The creation tool can’t do without undo-redo

• There are two X and Y buttons on the secondary controller below the Palette menu for step backward/forward

Selection

• Selection using the secondary controller (with the palette menu) and its trigger button (the one on the front)

• Select (or deselect already selected) multiple elements

Double click to select the entire mass and Tripple-click triple-click to select connected elements

2D desktop interactions (editor)


The basic principles of menu – VR

Once you get these 3 basics down, the platform becomes more intuitive

A) Palette menu – To create something (Spaces, props library, import, …)

B) Scene settings – To control visibility of your scene (hiding, time of day, ortho mode, …)

C) Context menu – To edit the element (To open materials, editing options, …)

The basic principles of menu – 2D desktop

The 2D version follows the same principles as the VR version

A) Palette menu – To create something (Spaces, props library, import, …)

B) Scene settings – To control visibility of your scene (hiding, time of day, ortho mode, …)

C) Context menu – To edit the element (To open materials, editing options, …)

Multiple tool / function states

Some tools and functions have multiple state options.

The number and possibility of different states can be recognized by presence of small circles under/next to the tool, indicating the selected state and possible switch. (Hover over to display more info about the state).

Simply Click on buttons to switch state.

Example of buttons:

Example of optional states:

Information during manipulation

During creation it is important to know how many units you are moving, how big the area is, which tool you have selected and so on. This information is available at the following positions: