Skip to content

Commit a02aa08

Browse files
committed
Docs: update Windows instructions
1 parent 7c49c30 commit a02aa08

File tree

1 file changed

+51
-1
lines changed

1 file changed

+51
-1
lines changed

README.md

Lines changed: 51 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,9 @@ The depth packet processor runs on OpenGL by default. You can try alternatives,
6363

6464
This project uses the libusbx drivers and API. Setting things up varies by platform.
6565

66-
### Windows
66+
### Windows / Visual Studio
67+
68+
#### libusbK driver
6769

6870
If you have the Kinect for Windows v2 SDK, install it first. You don't need to uninstall the SDK or the driver before doing this procedure.
6971

@@ -90,6 +92,54 @@ This will enumerate the Kinect sensor again and it will pick up the K4W2 SDK dri
9092

9193
You can go back and forth between the SDK driver and the libusbK driver very quickly and easily with these steps.
9294

95+
#### libusb
96+
97+
* Build from source (recommended)
98+
```bash
99+
cd depends/
100+
git clone https://github.com/libusb/libusb.git
101+
cd libusb
102+
git remote add joshblake https://github.com/JoshBlake/libusbx.git
103+
git fetch joshblake
104+
git merge joshblake/winiso # patches for libusbK backend
105+
```
106+
Open `libusb/msvc/libusb_2013.sln` with Visual Studio 2013 (or older version, accordingly), set configurations to "Release x64", and build "libusb-1.0 (dll)". You can clone the libusb repo to somewhere else, but you will need to set environment variable `LibUSB_ROOT` to that path. Building with "Win32" is not recommended as it results in lower performance.
107+
108+
* Pre-built binary
109+
110+
Joshua Blake provided a Debug version binary: https://www.dropbox.com/s/madoye1ayaoajet/libusbx-winiso.zip. Install it as `depends/libusbx`. This version was built in 2013.
111+
112+
#### TurboJPEG
113+
114+
* Download from http://sourceforge.net/projects/libjpeg-turbo/files
115+
* Extract it to the default path (`c:\libjpeg-turbo64`), or as `depends/libjpeg-turbo64`, or anywhere as long as the environment variable `TurboJPEG_ROOT` is set to installed path.
116+
117+
#### GLFW
118+
119+
* Download 64-bit Windows binaries from http://www.glfw.org/download.html
120+
* Extract it as `depends/glfw` (rename `glfw-3.x.x.bin.WIN64` to glfw), or anywhere as long as the environment variable `GLFW_ROOT` is set to the installed path.
121+
122+
#### OpenCV
123+
124+
* Download the installer from http://sourceforge.net/projects/opencvlibrary/files/opencv-win
125+
* Extract it anywhere (maybe also in `depends`)
126+
127+
#### OpenCL
128+
129+
* Intel GPU: Download `intel_sdk_for_ocl_applications_2014_x64_setup.msi` from http://www.softpedia.com/get/Programming/SDK-DDK/Intel-SDK-for-OpenCL-Applications.shtml (SDK official download is replaced by $$$ and no longer available) and install it. Then verify `INTELOCLSDKROOT` is set as an environment variable.
130+
131+
#### Build
132+
133+
You need to specify the location of OpenCV installation in `OpenCV_DIR`.
134+
```
135+
cd example\protonect
136+
mkdir build && cd build
137+
cmake .. -G "Visual Studio 12 2013 Win64" -DCMAKE_INSTALL_PREFIX=. -DOpenCV_DIR=%cd%\..\..\..\depends\opencv\build
138+
cmake --build . --config Release --target install
139+
```
140+
141+
Then you can run the program with `.\bin\Protonect.exe`. If DLLs are missing, you can copy them to the `bin` folder.
142+
93143
### Mac OSX
94144

95145
1. ``cd`` into a directory where you want to keep libfreenect2 stuff in

0 commit comments

Comments
 (0)