|
| 1 | +# Running OpenPose 3-D Reconstruction Demo - Windows |
| 2 | +This is a beta version that makes body pose 3-D reconstruction and rendering. We will not keep updating it nor solving questions/issues about it at the moment. It requires the user to be familiar with computer vision, in particular with camera calibration, i.e. extraction of intrinsic and extrinsic parameters. |
| 3 | + |
| 4 | +The Windows steps were tested and worked in the OpenPose 1.0.1 version from the last GitHub commit on July 7th, 2017 in the [oficial repository](https://github.com/CMU-Perceptual-Computing-Lab/openpose). |
| 5 | + |
| 6 | + |
| 7 | + |
| 8 | +### Hardware |
| 9 | +This demo assumes 3 stereo cameras, FLIR company (former Point Grey). Ideally any USB-3 FLIR model should work, but we have only used the following specific specifications: |
| 10 | + |
| 11 | +1. Camera details: |
| 12 | + - Blackfly S Color 1.3 MP USB3 Vision (ON Semi PYTHON 1300) |
| 13 | + - Model: BFS-U3-13Y3C-C |
| 14 | + - 1280x1024 resolution and 170 FPS |
| 15 | + - https://www.ptgrey.com/blackfly-s-13-mp-color-usb3-vision-on-semi-python1300 |
| 16 | + - Hardware trigger synchronization required. For this camera model, see `Blackfly S` section in [https://www.ptgrey.com/tan/11052](https://www.ptgrey.com/tan/11052) or [https://www.ptgrey.com/KB/11052](https://www.ptgrey.com/KB/11052). |
| 17 | + - (Ubuntu-only) Open your USB ports following section `Configuring USBFS` in [http://www.ptgrey.com/KB/10685](http://www.ptgrey.com/KB/10685). |
| 18 | + - Install the Spinnaker SDK for your operating system: [https://www.ptgrey.com/support/downloads](https://www.ptgrey.com/support/downloads). |
| 19 | +2. Fujinon 3 MP Varifocal Lens (3.8-13mm, 3.4x Zoom) for each camera. |
| 20 | + - E.g. [https://www.bhphotovideo.com/c/product/736855-REG/Fujinon_DV3_4X3_8SA_1_3_MP_Varifocal_Lens.html](https://www.bhphotovideo.com/c/product/736855-REG/Fujinon_DV3_4X3_8SA_1_3_MP_Varifocal_Lens.html). |
| 21 | +3. 4-Port PCI Express (PCIe) USB 3.0 Card Adapter with 4 dedicated channels. |
| 22 | + - E.g. [https://www.startech.com/Cards-Adapters/USB-3.0/Cards/PCI-Express-USB-3-Card-4-Dedicated-Channels-4-Port~PEXUSB3S44V](https://www.startech.com/Cards-Adapters/USB-3.0/Cards/PCI-Express-USB-3-Card-4-Dedicated-Channels-4-Port~PEXUSB3S44V). |
| 23 | +4. USB 3.0 cable for each FLIR camera. |
| 24 | + - From their official website: [https://www.ptgrey.com/5-meter-type-a-to-micro-b-locking-usb-30-cable](https://www.ptgrey.com/5-meter-type-a-to-micro-b-locking-usb-30-cable). |
| 25 | + |
| 26 | + |
| 27 | + |
| 28 | +### Calibrate Cameras |
| 29 | +You must manually get the intrinsic and extrinsic parameters of your cameras and introduce them on: `openpose3d\cameraParameters.hpp`. We used the 8-distortion-parameter version of OpenCV. |
| 30 | + |
| 31 | + |
| 32 | + |
| 33 | +### Windows |
| 34 | +1. Open the OpenPose visual studio solution `windows\openpose.sln`. |
| 35 | +2. Right-click on `Solution 'OpenPose'` of the `Solution Explorer` window, usually placed at the top-right part of the VS screen. |
| 36 | +3. Click on `Properties`. Go to `Configuration Properties` -> `Configuration` and check `Build` for the `OpenPose3DReconstruction` project. |
| 37 | +4. Get the last Spinnaker SKD version, i.e. the FLIR camera driver and software: |
| 38 | + - Download last Spinnaker SDK: https://www.ptgrey.com/support/downloads |
| 39 | + - Copy `{PointGreyParentDirectory}\Point Grey Research\Spinnaker\bin64\vs2015\` as `{OpenPoseDirectory}\3rdparty\windows\spinnaker\bin\`. You can remove all the *.exe files. |
| 40 | + - Copy `{PointGreyParentDirectory}\Point Grey Research\Spinnaker\include\` as `{OpenPoseDirectory}\3rdparty\windows\spinnaker\include\`. |
| 41 | + - Copy `Spinnaker_v140.lib` and `Spinnakerd_v140.lib` from `{PointGreyParentDirectory}\Point Grey Research\Spinnaker\lib64\vs2015\` into `{OpenPoseDirectory}\3rdparty\windows\spinnaker\lib\`. |
| 42 | + - (Optional) Spinnaker SDK overview: https://www.ptgrey.com/spinnaker-sdk |
| 43 | +5. Get the last OpenGL Glut library version for the rendering: |
| 44 | + - Download the latest `MSVC Package` from http://www.transmissionzero.co.uk/software/freeglut-devel/ |
| 45 | + - Copy `{freeglutParentDirectory}\freeglut\bin\x64\` as `{OpenPoseDirectory}\3rdparty\windows\freeglut\bin\bin\`. |
| 46 | + - Copy `{freeglutParentDirectory}\freeglut\include\` as `{OpenPoseDirectory}\3rdparty\windows\freeglut\include\`. |
| 47 | + - Copy `{freeglutParentDirectory}\freeglut\lib\x64\` as `{OpenPoseDirectory}\3rdparty\windows\freeglut\lib\`. |
| 48 | + |
| 49 | + |
| 50 | + |
| 51 | +### Ubuntu |
| 52 | +We do not support Ubuntu at all for this demo. We did an original and very initial version long ago, but it was highly changed later. In case you need Ubuntu, these are the steps we used for our that original version in Ubuntu 16. Note that they might be several differences to make it work in the current version. Feel free to send us or make a pull request with the updated steps and we will update them, but we will not answer any kind of questions about it. |
| 53 | + |
| 54 | +1. `sudo apt-get install freeglut3-dev`. |
| 55 | +2. Compile OpenPose by your own [from https://github.com/CMU-Perceptual-Computing-Lab/openpose](from https://github.com/CMU-Perceptual-Computing-Lab/openpose). |
| 56 | +3. Perform `make distribute` on OpenPose, and copy the `include` and `lib` files in [3rdparty/openpose/](3rdparty/openpose/). |
| 57 | +4. Copy the `include` and `lib` folders from {OpenPose path}/3rdparty/caffe/distribute/ to [3rdparty/caffe/](3rdparty/caffe/). |
| 58 | +5. Copy your Spinnaker desired version `include` and `lib` folders on [3rdparty/spinnaker/](3rdparty/spinnaker/). |
| 59 | +6. Open the [rtstereo.pro](rtstereo.pro) file with Qt to have the project ready-to-compile-and-go. If you prefer using your own Makefile file, you can take a look to this Qt file to know which files (basically [src/](src/) and [include/](include/)) and compiler flags used. |
| 60 | + 1. If using Qt, you will have to manually copy the {OpenPose path}/models folder inside the generated build folder. |
| 61 | +7. You must copy the contents of [add_to_bin_file/](add_to_bin_file/) where the final binary file is generated. |
0 commit comments