3DConnexion Device

Last updated June 11, 2020 by Elwanda Klucik elwanda.klucik@trimble.com

Software version: 
Not version-specific
Not environment-specific

3DConnexion Device

Purpose and description

  • This extension allows for the use and customization of 3DConnexion's SpaceMouse devices. The extension packages installs a sidebar featurepart of Tekla Structures functionality that is maintained and owned by Trimble Solutions and that is included in the Tekla Structures installation

    on the right side pane of Tekla Structures with button configuration, options, and device connection information. This extension enables the device to control the model viewview that is represented in the modeling mode

    Model view is available also in the drawing mode and it is represented in its own window.

    movements directly using API integration specific for Tekla Structures.

System requirements

  • You must first install the latest device drivers from 3DCONNEXION here.
  • Use version 10.6.5 or greater

Installing the 3D Connexion Device Extension

To install the extension:

  1. Download the TSEP package from Tekla Warehouseservice for collaboration and for storing and sharing Tekla Structures content

    In Tekla Warehouse the content items are stored in collections. Tekla Warehouse includes the Tekla Warehouse Service and the Tekla Warehouse web site.

    Tekla Warehouse is one of the Tekla Online services.

  2. Import the TSEP into the Applications and components catalogcatalog that contains all system components and custom components, and the macros and applications (see TUA article for instructions)
  3. Start Tekla Structures and open or create a model.
  4. In the main user interface side pane you should see a new "3DConnexion" icon:
  1. To open the tool, select the new icon.

Using the 3D Connection Device Extension

Main Menu

The main menu provides:

  1. information regarding the connection status,
  2. the ability to connect or disconnect from the device,
  3. access to additional menus (see descriptions below), and
  4. the ability to set the center of rotation.


Buttons Menu

The buttons menu provides:

  1. a means of assigning Tekla Structures macros to be available to the hardware devices, and
  2. a means of saving different sets of macros.

Options Menu

The options menu provides a means for refining device behavior in Tekla Structures for both Perspectiveview projection that displays objects in a model view from a particular standpoint so that distant objects appear smaller than close ones, as do text and points

The user can zoom, rotate, pan, or fly through the model objects.

views and Orthogonalview projection that displays objects in right-angles projection

In orthogonal model view the size of the objects is the same despite of their distance to the viewing point and the zoom remains on part faces.

views. When you hover over the settings you get a tooltip with more information about each option and what they control. In most cases you will not need to change these from default. It is better to control the sensitivity settings from the device menu settings where possible. These settings are:

  • Close Up Zoom / Pan Sensitivity -
  • General Zoom Sensitivity -
  • General Pan Sensitivity -
  • Max Zoom Out -
  • Rotation Sensitivity -
  • Roll Offset Factor -
  • Navigation Mode -

Navigation Mode

  • Camera (default) - Rotations pivot about coordinate system (x, y, z axis) of camera or view. Looking into page is z axis for camera for example. When this mode is set all rotation translations are relative to current camera orientation and position.
  • Object - Rotations pivot about model global coordinate systemcoordinate system that reflects the entire space of a model

    A green cube represents the global coordinate system and lies at the global point of origin in the 3D view.

    (x, y, z axis). Spin on device (y-axis) rotates the model about the model Z axis. Tilt on device (x-axis) rotates the model about the model X axis. Roll on device (z-axis) rotates the model about the model Y axis. Everything rotates around model absolute x, y, z axis regardless of current camera orientation in this mode.

Device Menu

The device menu provides access to 3D Connexion's applicationpart of Tekla Structures functionality that is developed in order to extend the capability of Tekla Structures but that is not included in the Tekla Structures installation

menu. Use this to bind the macros you made available in the Buttons Menu to the specific buttons on device hardware. Also, control the sensitivity overall or each axis under Advanced Settings here.

Setting Files

  • Saved Options files are created to attributes folder but can be moved to system folders. File extension is .cdxMSet
  • Saved Buttons files are created to attributes folder but can be moved to system folders. File extension is .cdxBSet

Config File

  • A default configuration file (mapping of macros from Buttons Menu to device physical buttons and settings) is provided by extension installer.
  • Config files are per machine and located: C:\ProgramData\3Dconnexion\3DxWare\Cfg\Tekla Structures.xml
  • User edits to Device Menu are created to: C:\Users\<userName>\AppData\Roaming\3Dconnexion\3DxWare\Cfg\Tekla Structures.xml
  • If you want to restore Device Menu settings to default you can delete the config file from Your AppData folder
  • In case of configuration setup issues with mouse commands/drivers try steps below:
    >Close TeklaStructres and all other software
    >Delete C:\Users\<UserName>\AppData\Roaming\3Dconnexion\3DxWare\Cfg\Tekla Structures.xml
    >Then restart computer, that will reset to defaults by drivers

Multiple Views

  • If only one view is open the device is linked to control only that view.
  • If multiple views are open and one is selected (orange box is drawn inside edges to denote it is selected) the device is linked to control that view and ignore other open views.
  • If multiple views are open and no view is selected, the device is linked to control the first visible view. You might need to make other views inactive or select view you want to control when multiple views are open at the same time.

Additional information

  • Requires latest drivers from 3DCONNEXION to be installed
  • User interface only available in English language currently

Quick feedback

The feedback you give here is not visible to other users. We use your comments to improve our content.
We use this to prevent automated spam submissions.
Content rating: 
Average page rating: 4 (2 votes)
Refresh page after voting to show updated result.