Skip to content

Your first project#

At this stage everything is installed, your license is active and you are now ready to create your first XR Twin project.

The user interface starts with the Project Launcher view. Here you can manage your XR Twin projects: create, import, duplicate, archive, share and collaborate with your team and more.

Creating a project#

To create a new empty project from the Project Launcher:

  1. Click on the New project button in the left side panel. A new project thumbnail appears in the Recent Projects center panel.
    Screenshot
  2. Complete the project's information in the right side panel (Title, Author, Description). See below.
  3. Open your project by clicking on the Open project button in the bottom-right corner.

Project Information#

Filling in project information is advised in order to facilitate later project management. To Edit project information, click on the Screenshot button at the top of the right side panel.

Screenshot

In Project Information panel:

  • Project name: Name your project accordingly,
  • Author: Person creating or modifying the project,
  • Created on: Project creation date (cannot be modified),
  • Last modified on: date of last modification (cannot be modified),
  • Description: Free text field allowing you to add valuable information on the project,
  • Version: You can assign a project version number (e.g. after each project milestone or major modification).

To open the Project Information in Edit mode:

  1. Click the ProjectAdmin_EditprojectButton button at the top of the right side panel to open Edit mode,
  2. Alternatively, you can dubble-click in a field.
  3. Modify information according to your needs,
  4. When you are finished, click the ProjectAdmin_EditprojectButton button again to apply your changes and close Edit mode.

Project management#

The thumbnail context menu (also referred to as "project menu") can be accessed by clicking on the ProjectMenuButton button as shown in the image below.

Screenshot

In the Thumbnail (Project) popup menu:

  • Edit project thumbnail: Change your project preview image.
  • Edit project information: Modify project information (also accessible from the right side panel).
  • Duplicate: Will create a copy (clone) of your project along with all assets and dependencies. The copy has the same name, indexed.
  • Export: Will create an .xrproj file in the chosen folder. You can now share this project file with other XR Twin users.
  • Archive: Will create an .xrproj file (archive) in the chosen folder and delete the project from the XR Twin interface. Use this command when you are done working on a project and want to store the archive.
  • Delete: Will delete the project and all its assets.

Customizing project image

The default project thumbnail is automatically generated upon saving your project. You can force your own thumbnail by clicking on the ProjectMenuButton button and select Edit project thumbnail in the popup menu.

Import a project#

To import an existing project in XR Twin (from an archive or sended to you by another XR Twin user):

  1. Click on the Import project button in the left side panel, browse and select the .xrproj file that you want to import in XR Twin.
  2. Finish by clicking Open to close the browser.
  3. The project is charged in your Working Directory and a new thumbnail is added in the Recent Project panel. The name is that of the initial project (may be different from the file name).

Screenshot

What happens if same project exist ?

If the project you are trying to import already exists in your Working Directory (same "project ID"), a message will warn you. You can choose to continue by overwriting the existing project (note that this project will be lost). Or you may choose to cancel, make a copy of your existing project (use Duplicate), and then re-import the project. This time, choose Continue.
Projects are identified by their project ID independently of their name. You cannot change this ID directly, but by duplicating your project, the duplicate will have a different ID.

Tips and best practices: duplicate to backup!

It is highly recommended to duplicate your projects. By creating backups, you can easily revert to previous versions if modifications are needed or if unexpected issues arise. Duplicating projects ensures that you have a safety net and can avoid potential data loss or setbacks.

Open a project#

Now that you have a project, you can open it:

  1. In the Recent Project panel, select the project thumbnail you wish to open,

  2. Bottom right-hand panel, click the Open Project button,
    ProjectOpen

  3. The project opens in a new interface: the Edition panel.
    Edition_0

  4. From the menu bar at top left, select Object>Add>Primitive to open the Add Primitive popup.
    Edition_1
  5. In the Add Primitive popup, select Sphere and click the Import to scene button.
    Edition_3
  6. A new object "Sphere" is added in the 3dview panel and selected in the left side panel.
  7. Press the F key to focus on the sphere.
  8. Change point of view:
    • Press Alt+LMB (Left Mouse Button) and drag to turn around (Orbit) the focused object.
    • Press MMB (Middle Mouse Button) and drag to Pan the 3D view.
    • Scroll with MMW (Middle Mouse Wheel) to zoom in/out.
  9. Save your changes: from the menu, select Project>Save (or Ctrl+S).
  10. Move your mouse to the top left and click the Home HomeButton button to return to the Launcher panel.



You've taken your first steps into XR Twin. Go on to discover all its features by browsing the next chapters of this User Guide.