> For the complete documentation index, see [llms.txt](https://asrob-uc3m.gitbook.io/robotdevastation-user-manual/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://asrob-uc3m.gitbook.io/robotdevastation-user-manual/en/install-robot-devastation/pc-windows.md). # pc-windows First of all, you need a C++ compiler. You can download the latest Visual Studio (Community edition) from the [Microsoft website](https://www.visualstudio.com/downloads/). In order to configure and build VS projects, CMake will be used ([downloads page](https://cmake.org/download/)). ## Download and install YARP binaries RD software is designed around YARP. In case you installed a recent version of Visual Studio, you may just download precompiled binaries from the [YARP downloads page](http://www.yarp.it/download.html) and skip to [#Download and install additional dependencies](/robotdevastation-user-manual/en/install-robot-devastation/pc-windows.md#download-and-install-additional-dependencies). Alternatively, you may compile ACE and YARP from sources. ## Download and compile ACE from sources YARP communications rely on [ACE](http://www.cs.wustl.edu/~schmidt/ACE.html). Download the latest *micro* release of ACE from [here](http://download.dre.vanderbilt.edu/), TAO is not required. Follow the instructions at [Building and Installing ACE on Windows with Microsoft Visual Studio](http://www.dre.vanderbilt.edu/~schmidt/DOC_ROOT/ACE/ACE-INSTALL.html#msvc). Select either the *Release Win32* or *Release x64* configuration in VS. Remember this choice for later: both the dependencies and the game itself must be compiled in/against the same architecture (Win32/x64). **Note:** we recommend to launch the *ACE\_wrappers* solution (depending on your Visual Studio toolset, you'll choose either *ACE\_wrappers\_vc12.sln* or *ACE\_wrappers\_vc14.sln*) instead of *ACE* since the former will prevent you from compiling a lot of binaries you probably won't need, thus reducing the overall build time. ## Download and compile YARP from sources YARP code is hosted on [GitHub](https://github.com/robotology/yarp). You can download the source code by clicking [here](https://github.com/robotology/yarp/archive/master.zip), or clone the repository in your local machine with the help of your preferred Git client. Now, configure the VS project: 1. Run the CMake GUI application. 2. Point the *Where is the source code* path to the folder where you have decompressed/cloned YARP. 3. Point the *Where to build the binaries* path to a `/build` subfolder of the previous directory. 4. Click on `Configure` and select the corresponding Visual Studio toolset you had installed at the beginning of this guide. Pick the architecture option chosen for ACE in the previous section (*Win64* suffix in case of a 64-bit architecture). 5. Provide the path to your ACE build in the corresponding options: `ACE_INCLUDE_DIR` should point to the *ACE\_wrappers* directory (unless renamed), and `ACE_ACE_LIBRARY_RELEASE` to *ACE\_wrappers/lib/ACE.lib*. 6. Click on `Generate` and `Open project` (if your CMake GUI version provides such button) or browse to the build path and click on the Visual Studio solution (look for the *.sln* extension). If you want to install YARP in the default path (*C:\Program Files* or *C:\Program Files (x86)*), you'll need to start Visual Studio with administrator privileges, then click on *File>Open*, browse to the build folder and open the *.sln* file. In Visual Studio, select the *Release* configuration and compile the solution. To install YARP (not obligatory), compile the *INSTALL* project from the project explorer. ## Download and install additional dependencies RD depends on the following libraries: * [SDL 2.0](https://www.libsdl.org/index.php) ([downloads page](https://www.libsdl.org/download-2.0.php)) * [SDL\_image 2.0](https://www.libsdl.org/projects/SDL_image/) * [SDL\_mixer 2.0](https://www.libsdl.org/projects/SDL_mixer/) * [SDL\_ttf 2.0](https://www.libsdl.org/projects/SDL_ttf/) * [ZBar](http://zbar.sourceforge.net/) ([download link (32-bit only)](https://sourceforge.net/projects/zbar/files/latest/download), [asrob-uc3m mirror](https://github.com/asrob-uc3m/ZBar/releases/latest)) Unzip/install these libraries in the locations of your choice, you'll need these paths later on. ## Compile Robot Devastation Run CMake GUI and follow points 1 to 3 from [#Download and compile YARP from sources](/robotdevastation-user-manual/en/install-robot-devastation/pc-windows.md#download-and-compile-yarp-from-sources) to prepare your RD build in the desired path. Upon pressing `Configure`, CMake will warn you about missing configuration variables pertaining to previously listed project dependencies that you'll need to provide manually so you can proceed further by clicking `Configure` again. This process should be repeated until no more errors are thrown. Open the Visual Studio solution, select the *Release* configuration and compile. ## Set runtime path Locations of dependent dynamic libraries (files with the *.dll* extension) should be appended to the *PATH* environment variable in order to link them at run time when YARP and the RD programs (as *.exe* files) are launched. This configuration can be set on *Computer>System properties>Advanced system settings>Advanced>Environment Variables*. Alternatively, you may just copy all DLLs and paste them in the same directories the executables are located in. ## Configure YARP data directories YARP needs to locate RD resources and configuration files. To achieve that, add the *YARP\_DATA\_DIRS* environment variable (see previous section) and set its value to the absolute path that leads to `/share/rd` in your build or installation directory of Robot Devastation. ## Known issues and remarks ZBar is shipped with an outdated *zlib1.dll* library, a more recent one can be found in the bundles SDL2 comes with. Remember to omit this file when copying all DLLs to the directory where the executables are placed in, or move its location path after SDL2 in the *PATH* environment variable, depending on your preference as explained in the previous section. If unzipping all SDL2 stuff to the same location (i.e. all headers go to a common `include` directory, DLLs to `lib` and so on), make sure that you always keep the most recent version when prompted to choose between files with the same name. This is motivated by another clash between different versions of *zlib1.dll* used by SDL2 projects (image and ttf). In addition, *official* ZBar binaries are compiled for 32-bit architectures only. In order to achieve a 64-bit build, you need to download the corresponding installer from our [GitHub mirror](https://github.com/asrob-uc3m/ZBar/releases/latest) (available for both 32-bit and 64-bit archs).