README.win64_msvc

Requirements
------------

- Visual Studio Community 2013
  http://www.visualstudio.com/en-us/news/vs2013-community-vs.aspx
- CMake
  http://www.cmake.org/cmake/resources/software.html
- Git
  http://code.google.com/p/msysgit/

1. Clone the PS Move API repository
    `git clone --recursive https://github.com/cboulay/psmoveapi.git`
    `cd psmoveapi`
    
3. Build libusb-1.0
    Optional - Only required if you are building the positional tracker.
    Open psmoveapi\external\libusb-1.0\msvc\libusb_2013.sln
    Right-click on libusb-1.0 (static) and select Properties.
    In the properties Window, make sure the Platform is set to All Platforms.
    Set the Configurations to Release
    In the properties Window, navigate to Configuration Properties > C/C++ > Code Generation
    Change "Runtime Library" to Multi-threaded DLL (/MD)
    Click Apply
    Set the Configurations to Debug
    Change "Runtime Library" to /MDd
    Click OK
    Right-click on libusb-1.0 (static) and Build for each of the Release and Debug configurations,
    and for each of the Win32 and x64 Target Platforms.
    
4. OpenCV
    Optional - Only required if you are building the positional tracker.
    Still in `psmoveapi/external`
    `git clone --depth 1 --branch 2.4.11 git://github.com/Itseez/opencv.git`
    `cd opencv`
    `mkdir build`
    `cd build`
    `cmake .. -G "Visual Studio 12 Win64" -DBUILD_SHARED_LIBS=OFF -DBUILD_WITH_STATIC_CRT=OFF -DBUILD_PERF_TESTS=OFF -DBUILD_TESTS=OFF -DBUILD_DOCS=OFF -DBUILD_opencv_apps=OFF -DBUILD_opencv_calib3d=ON -DBUILD_opencv_flann=ON -DBUILD_opencv_features2d=ON -DBUILD_opencv_objdetect=OFF -DBUILD_opencv_photo=OFF -DBUILD_opencv_ts=OFF -DBUILD_opencv_ml=OFF -DBUILD_opencv_video=OFF -DBUILD_opencv_java=OFF -DWITH_OPENEXR=OFF -DWITH_FFMPEG=OFF -DWITH_JASPER=OFF -DWITH_TIFF=OFF`

    Open the solution in psmoveapi\external\opencv\build\OpenCV.sln
    Change the target to Release x64 (at the top of the Visual Studio window).
    Build the solution (Build Menu -> Build Solution).
    You can also build the solution for Debug target if you intend to debug psmoveapi.
    
    Note: OpenCV 2.4.11 is required only for MSVC builds of the psmoveapi; Linux and Mac builds of the psmoveapi require OpenCV 3.
    
5. SDL2
    Optional - Only required if you are building the OpenGL examples or the coregistration tool.
    Still in `psmoveapi/external`
    `cd SDL2`
    `mkdir build`
    `cd build`
    `cmake .. -G "Visual Studio 12 Win64" -DDIRECTX=OFF`
    
    Open the solution (psmoveapi\external\SDL2\build\SDL2.sln)
    Change the target to Release (at the top of the VS window).
    Build the solution (Build Menu -> Build Solution).

6. stb - single file, header only game utility library
    Optional - Only required if you are building the coregistration tool
    `cd external`
    `git clone https://github.com/nothings/stb.git`

7. Oculus SDK - Required if building the coregistration tool.
    Download OculusSDK from [here](https://developer.oculus.com/downloads/pc/0.8.0.0-beta/Oculus_SDK_for_Windows/)
    Copy the folder `OculusSDK\LibOVR` from the zip to <psmoveapi>/external/

8. Build psmoveapi

    Still in the VS2013 command prompt:

    Change back to the psmoveapi directory.
    `mkdir build `
    `cd build`
    `cmake .. -G "Visual Studio 12 Win64" -DPSMOVE_USE_PS3EYE_DRIVER=1 -DPSMOVE_BUILD_OPENGL_EXAMPLES=ON -DPSMOVE_BUILD_TUIO_SERVER=ON`
    #`cmake .. -G "Visual Studio 12 Win64" -DPSMOVE_USE_PS3EYE_DRIVER=1 -DPSMOVE_BUILD_OPENGL_EXAMPLES=ON -DPSMOVE_BUILD_TUIO_SERVER=ON -DPSMOVE_USE_TRACKER_TRACE=ON -DPSMOVE_USE_DEBUG=ON`

    Open the `build\Project.sln` solution file.
    Change the target to Release.
    Build the solution.
    You can also build the Debug solution.
    
9. Read [this Wiki](https://github.com/cboulay/psmove-ue4/wiki) for windows-specific information on pairing and connecting the psmove controller and on using the PS3Eye camera.

10. Start one of the desired test applications

    If you previously chose to build the example applications (which is the
    default), you can then run

    example.exe

    for a basic example.

For questions, please read the archives of the PS Move Mailing List. If you
cannot find an answer to your question in the archives, send an e-mail:

   https://groups.google.com/forum/#!aboutgroup/psmove