Getting Started

From Visual3D Wiki Documentation
Jump to: navigation, search
Language:  English  • français • italiano • português • español 

This page provides information for installing, activating, and verifying that Visual3D launches successfully on your computer.

For information on using Visual3D, you can visit the Tutorials Section or the online documentation

A video of the installation process can be found [Here]

Visual3D Hardware Requirements

Visual3D runs under Microsoft Windows Vista/Win7/Win8/Win10. It has no specific minimal hardware requirements. It runs as a 32 bit application. It even runs on a netbook with an Atom processor and 256MB of memory. But naturally, more powerful and advanced hardware is best. We recommend having 8GB or more of memory and dual-core processors or better.

Visual3D also runs on a Mac under Parallels or VMWare (or dual boot to Windows with Bootcamp). Sorry, there is no iPad, MAC, or Linux version.

Downloading Visual3D

C-Motion software is all downloaded over the Internet at
Customers are provided login information to access the download page.

After you log in at, you will see a downloads screen as show in the following video:
(Note: The C-Motion web site has changed, so while the screens are a little different, the process is the same.)

  1. Click the Download Software Buttons to save the installation files to your computer. The Real-Time modules are Zip files that contain an install.txt file describing where to copy files.
  2. Click the Download License Key File button to download the license key file to your computer.

Most web browsers will offer you a choice of where to save the downloaded file. Make sure you remember where you save the downloaded file.

Installing Visual3D v5

Visual3D Version 5 does NOT put a license file on C:\ like v3 and v4 did. Visual3D v5 comes with a new installer that stores the license file for you.

(If updating Visual3D, just install right over top the existing installation. Your settings will remain intact - there is no need to uninstall or deactivate licenses first.)

1. After you download the software and license key file, simply run the installer and follow the instructions. (For example, in Windows Explorer you double-click on the file with a name similar to: Visual3D_Setup_v5.02.27.exe.)

Remember to click the Install License Key button too.

It goes like this:

2. Unzip any real-time modules you have downloaded and follow the directions in the Install.txt file.

Every motion capture vendor has their own way of streaming real-time data, so the vendor libraries that C-Motion uses require various DLL’s to be copied to specific locations on your computer. Most DLL’s are copied to the Visual3D Plugin directory, but sometimes there are more files to copy.

FOR WINDOWS 8 or WINDOWS 10: win8err1.JPG win8err2.JPG

Installing Visual3D v6

Visual3D Version 6 does NOT put a license file on C:\ like v3 and v4 did. Visual3D v6 comes with a new installer that stores the license file for you.

(If updating Visual3D, just install right over top the existing installation. Your settings will remain intact - there is no need to uninstall or deactivate licenses first.)


  • You can run Visual3Dv5 and v6 on the same computer (version 6 will not overwrite version 5).
  • Visual3Dv6 comes in two versions; 64 bit and 32 bit. You will need to download and install the appropriate version for your computer.

To install Visual3D:

  1. Download the software and license key from your institution's account at C-Motion
  2. Run the installer and follow the instructions
    1. To run the installer: in Windows Explorer you double-click on the installation file with a name similar to: Visual3D_Setup_x64_v6.00.11.exe or Visual3D_Setup_x32_v6.00.11.exe
    2. When the installer is running, make sure to click Browse to install License Key
  3. Unzip any real-time modules you have downloaded and follow the directions in the Install.txt file.
    1. Every motion capture vendor has their own way of streaming real-time data, so the vendor libraries that C-Motion uses require various DLL’s to be copied to specific locations on your computer. Most DLL’s are copied to the Visual3D Plugin directory, but sometimes there are more files to copy.

Visual3D Activation

Visual3D licenses are activated and managed via the Internet - it has a license activation scheme very similar to Microsoft Office. When you start Visual3D on a computer, it checks to see that it is properly licensed. New installations must therefore be activated.

The activation process is fully automatic. The first time you start Visual3D you should see a message that "Visual3D has automatically activated."

Manual Activation

If you are not connected to the Internet the first time you start Visual3D, you will get a message with a TOKEN and other information. You can manually activate a license from the downloads web page (from the list of activated systems section), or you may copy the entire message in the dialog box and e-mail it to

You will receive a code to enter (at the bottom of that same dialog box) that will activate Visual3D on that computer only.

NOTE: Be aware that C-Motion staff must run a special program to validate the license and generate that manual activation code, so they need to be awake and at their computer in order to get the e-mail. It is not instantaneous or automated (yet).

NOTE: If you see the tab Free CMO Reader in Visual3D, it means that the software is not activated.

NOTE: If all licenses are in use, then you either need to purchase additional licenses, or De-activate an old license.

Visual3D Deactivation - Moving Visual3D to a Different Computer

Moving Visual3D requires freeing up the activated license so it can be used elsewhere.

In Visual3D, go to HELP->DEACTIVATE to free up the license. This is automatic and handled over the Internet.

Non-Internet deactivations by C-Motion staff are quite involved and require manual database updates and are only done in emergencies (i.e. totally crashed computers). If someone leaves the lab taking a licensed and activated copy of Visual3D with them means that a replacement license needs to be purchased. Replacement/additional licenses start at $2000 USD.

After deactivating a license, then you should uninstall Visual3D. That way it won't accidentally reactivate if someone launches it.

Verifying The Installation

Verify that Visual3D is installed, licensed and working correctly

  1. Download the sample data file Visual3DExample1.cmo.
  2. Launch Visual3D.
  3. From the File menu, choose Open/Add…
  4. Locate the file which you downloaded.
  5. Click the file name to select it and click Open.
  6. Visual3D will open to the Workspace tab and you will see 3 items highlighted in blue.
  7. Above the workspace there are several tabs. Click the Signal and Event Processing tab.
  8. At the top of your screen, locate the drop down menu with the default value of ALL_FILES. This is the combo menu and it indicates which of the files loaded into your workspace are currently active.
  9. Use the mouse to change the menu selection from ALL_FILES to Walking1.c3d.
  10. Click the Play button—the right-pointing triangle—in the VCR control panel at the bottom of the screen. You will then see the animated walking model, similar to the one in the following illustration. If you do not see the animated skeleton check the troubleshoot section below.
  11. Use the VCR control buttons and the view options to alter the view.
    Note: The 3D animation viewer camera perspective is controlled using the mouse keys and mouse movements. The Visual3D tutorials describe how to control the camera angle along with many other helpful things.

Test the printing option

  1. Click the Pause button on the viewer.
  2. Click the Reporting tab to switch to the Visual3D Reporting Mode.
  3. In the upper right corner of your screen, just above the tabs, is the page-number control. Use this control to cycle through the various report pages.
  4. Click on the printer icon, or choose Print… from the File menu.
  5. If necessary, select a printer and click OK.

Associating cmo files with Visual3D

The Visual3D installer should associate .cmo and .c3d files with Visual3D. However, if you want to change a setting:

In Win 7, 8, and 10 use the windows file explorer and find any CMO file.

Then, right-click on it and select Properties.

Right on top is a Change button to set the association. In each dialog that follows scroll to the bottom to select "other" applications until eventually you will get a file open dialog. Go to: C:\Program Files (x86)\Visual3D v5\Visual3D.exe select that and all should work OK from then.

Setting Visual3D Default Folders

Visual3D pipeline commands can include default path names for folders. This allows the user to specify paths relative to a default path, which is convenient when a user modifies their data directories, or want to sent a pipeline to another folder that has a different default path.

Each installation of Visual3D (Production, Beta, etc) includes folders containing the animation model files, configuration files, etc. This can be confusing for the user should they modify or add a new model file, and then can find it available in one version of Visual3D and not the other. More critically, if the user modifies one of the default models, the next installation will overwrite the file. To combat any changes in the installation, users can specify a common path for all Visual3D versions that the Installer is not aware of.

Create a C:\VISUAL3D directory and copy all your Model, Plug-in, Pipeline, and Data directories there.

Select the "Preferences" option under the "Menu" Item.

Default Folders

Select the "Default Folders" tab set the defaults to the new locations.

Subsequent Visual3D updates will not change these new locations, so be careful if C-Motion releases new model graphics - meaning that you many need to copy any new graphic files to your own models directory (note that this is very rare).

This dialog is divided into folders that are constant unless changed by the user explicitly (top two groups), and those folders that are dynamic and changed by Visual3D as the user selects files (e.g. Visual3D attempts to remember the last path selected).


Persistent Paths

Default folders for Visual3D

Plugins Folder Visual3D searches this folder for Visual3D Plugins. These plugins may be processing plugins that will appear in the list of Pipeline commands, or they may be Real_Time plugins that will appear in the options for Real-Time Streaming
Segment Graphics Folder The animation models associated with the model segments are stored in. If no path to an object file is selected in the Segment Properties dialog, Visual3D searches hear for the file.
Pipelines Folder Default folder for Pipelines. Used mainly for the Pipeline Favorites. The pipeline commands may refer to the default pipeline folder as VISUAL3D_DEFAULT_PIPELINE_FOLDER

Default folders for data and templates

Default Data Folder The pipeline commands may refer to the default data folder as VISUAL3D_DEFAULT_DATA_FOLDER
Default Report Template Folder The pipeline commands may refer to the default report template folder as VISUAL3D_DEFAULT_REPORT_FOLDER
Default Model Folder The pipeline commands may refer to the default model template folder as VISUAL3D_DEFAULT_MODEL_FOLDER

A typical way to define the default folders for use in a pipeline is Set_Pipeline_Parameter_To_Folder_Path

Transient Paths

Report Template Folder Current default FOLDER for the report template. Reset every time a Report Template is opened.
Model Folder Current default FOLDER for the standing trial. Reset every time a Hybrid Model is created.
Motion File Folder Current default FOLDER for the motion trial. Reset every time a movement file is opened.

Uninstalling Visual3D

Please do Help->Deactivate to free up the license before uninstalling.

To uninstall Visual3D, you can either use the uninstall utility in the Programs group or use the Windows add/remove programs control panel. They both link to the same install shield program. Note: Make sure you have Administrator privileges on the PC—if not, you may need to seek help from your laboratory IT support staff.

  • You should always uninstall beta and evaluation versions of the software.
  • Once you have the full version, however, it is normally not necessary to uninstall.
  • You can download updates and newer versions ”on top of” your previous installation.

Trouble Shooting

Activation does not persist

When Visual3D is launched a PC that has been activated previously may still request manual activation .

The activation code is stored in the user registry so it should only ever need to be entered one time.

The code is unique to the PC, so it will always be the same code on that computer.

Problems we've seen:

  1. Some IT departments have weird policies that recreate a user directory on each login (deleting it on logout) that causes this problem.
  2. logging on as a different user requires an activation for that user name
  3. The IT department limits user access security to prohibit writing to the registry
  4. a bug in the Visual3D software.
    we are not aware of any problems, so if you think there is bug contact
  5. if you switch between version 4 and 5 you will need to reactivate each time because they share the same registry locations, but use different techniques and codes.

System Crashes

Visual3D crashes immediately after being installed

There are three things that should be attempted before contacting C-Motion.

  1. Update the graphics card drivers on your computer. Visual3D uses OpenGL for its 3D rendering. Occasionally there can be a conflict with OpenGL. Updating your video card drivers will many times fix the issue.
  2. Update Microsoft Internet Explorer
  3. Update Microsoft DirectX

When I use Visual3D on a laptop in a docking station with an external monitor Visual3D works fine. When I undock the laptop and use it on battery power alone, Visual3D causes the screen to flash for about 20 seconds every time a window is opened or item selected, effectively making it unusable

Look at the display settings/ advanced for a ’powerplay’ tab. This tab has performance vs battery power settings and by default it's set to maximize battery life when running off the battery. Change this to maximize performance.

Cannot Uninstall Visual3D

Trouble Shooting - I installed Visual3D on a computer successfully. I now want to uninstall Visual3D but it seems that I can't do it

Check your permissions for this account. If Visual3D was installed by the Administrator, a user may not have the privileges to uninstall the software.

Missing Tabs

Trouble Shooting - I have just installed Visual3D and it seems to be missing most of its features

As of version 3.60, Visual3D will run as a data viewer when no license key is installed. This viewer will allow you to visualize the data and the reports, but no processing is available.

When Visual3D is first installed on a computer the user needs to manually install a license key. This will take Visual3D out of viewer mode and enable all of the normal features of the software.

The process of installing the license file is explained in the section titled Visual3D License Registration.

Odd Animation Graphics

The skeleton looks pretty good, there are some problems with the 'transparency' of some of the bones. For some reason the spine seems to appear in front of the head, and also the shoulder blades seem to be in front of the ribs. However, when I rotate the model, the positions are actually correct.

Visual3D uses OpenGL graphics libraries. OpenGL drivers are often the last libraries implemented on graphics cards for windows operating systems.
The solution is typically to download the current graphics drivers for your computer.
It turns out that my laptop has two graphics boards (Intel (HD) – Graphics Chip, an Onboard-Graphics Card, as well as an NVIDIA NVS 3100M, firm 3D-graphics adapter). By default the laptop uses the Onboard-Graphics Card and I had to appoint the NVIDIA processor manually to Visual3D to fix the problem with the skeleton.

Bones Don't Appear

Trouble Shooting - I have loaded the example files but I can't see the bones in the 3D Viewer

  1. The most common cause of missing bones is that the toggle button caption to display the bones in the 3D viewer has been toggled off.
    1. Find this button on your screen and press it to see if the bones reappear.
    2. You can also open the View menu and select Modify 3D Animation View Options. The Program Options dialog should open to the Visual3D 3D Animation Options(2) tab.
      Note: The keyboard shortcut for this is Alt+V.
    3. On this tab verify that the Segments checkbox is checked. If not check it now.
  2. The 2nd possibility is that the object files that contain the wire frame models of the bones have been accidentally removed from your system
    1. Open Windows file explorer and navigate to C:\Program Files\Visual3D v3\Models.
    2. Verify that .obj and/or .v3g files appear in the folder.
      Note: Depending on the version of software you have it could be either .obj and/or .v3g or a combination of the two.
    3. If the neither .obj and/or .v3g files appear in the folder you will have to re-install Visual3D.
  3. The 3rd possibility is that Visual3D is looking in the wrong place for the object files that contain the wire frame models of the bones.
    1. From the Properties menu select Program Options.
      Note: The keyboard shortcut for this is Alt+O
    2. Verify that the path is correct. If Visual3D was installed in the default directory, the path will be C:\Program Files\Visual3D v5\Models.
    3. If the path is incorrect, click the ellipses button caption next to the path labeled Segment Graphics Folder.
    4. From the Browse For Folder dialog box select C:\Program Files\Visual3D v5\Models and click OK.

Copyright © 2002-2016 C-Motion, Inc. All rights reserved.

Retrieved from ""