Compiling V-REP and related items

The full source code of V-REP, the DYNAMICS PLUGIN, the MESH CALCULATION PLUGIN and the PATH PLANNING PLUGIN may be downloaded from the coppelia robotics website. While V-REP is GNU GPL licensed, the DYNAMICS PLUGIN, the MESH CALCULATION PLUGIN and the PATH PLANNING PLUGIN have a specific license attached. In short, only EDUCATIONAL ENTITIES (students, teachers, professors, schools or Universities) may download and use those plugins without explicit permission. Make sure you understand and comply with the licensing conditions before doing so.

Other source code items (e.g. various projects, plugins, interfaces, etc.) that are included in the installation packages of V-REP PRO and V-REP PRO EDU are not discussed here.

V-REP, the DYNAMICS PLUGIN, the MESH CALCULATION PLUGIN and the PATH PLANNING PLUGIN are Qt projects, and will require you to have Qt installed on your computer. Try to comply with following list of requirements in order to encounter least problems during compilation:

  • if possible, try using the same Qt version as the one that was used to compile the binary V-REP PRO EDU (click [Help --> About V-REP PRO EDU...] to display the Qt version)
  • if possible, try compiling the projects using Qt Creator.
  • under Windows, use the MinGW or the MSVC compiler. Under Mac OSX and Linux, use the GCC compiler.
  • Ubuntu is the preferred Linux distribution.
  • you will need to download and compile QScintilla2 (C++ editor control).
  • you will need to download and install the Boost C++ library.
  • you will need to download the Lua5.1 binaries and headers.
  • Download and install V-REP PRO EDU. Then download the V-REP source code (and optionally the plugin source codes) into the V-REP PRO EDU installation folder. You should have following folder structure:

     

    When using V-REP in conjunction with a plugin, make sure to use the source code / binaries that come from the same release, in order to avoid incompatibilities. Finally, before being able to compile the V-REP project, you will have to adjust various paths in the v_rep.pro project file, such as:

  • the path to your Boost library folder
  • the path to your QScintilla/Qt4 folder
  • the path to your QScintilla folder
  • the path to your Lua5.1 folder
  • the location of your lua5.1 library file
  • the location of your libqscintilla2 library file
  • When compiling V-REP under Windows, you might have to place a copy of the precompiled header (vrepPrecompiledHeader.h) into the release folder, to avoid having the compiler complaining.

    V-REP compiles to a shared library. The default client application that loads and runs the library is "vrep" or "vrep.exe". You can use the precompiled one, or recompile it yourself (refer to following project files: programming/v_repClientApplication or programming/windowsOnlyProjects/v_repClientApplication). The load operation of the library is successfull only if:

  • the client application could find all needed functions in the shared library
  • the shared library could find all shared libraries that itself relies on (e.g. the Lua shared library)
  • The easiest for you to do is to copy the compiled libraries into the V-REP PRO or V-REP PRO EDU folder, then you will be sure that V-REP should start and won't complain about missing dependencies.