~paparazzi-uav/paparazzi/v5.0-manual

« back to all changes in this revision

Viewing changes to sw/ext/opencv_bebop/opencv/platforms/winrt/readme.txt

  • Committer: Paparazzi buildbot
  • Date: 2016-05-18 15:00:29 UTC
  • Revision ID: felix.ruess+docbot@gmail.com-20160518150029-e8lgzi5kvb4p7un9
Manual import commit 4b8bbb730080dac23cf816b98908dacfabe2a8ec from v5.0 branch.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
Building OpenCV from Source, using CMake and Command Line
 
2
=========================================================
 
3
 
 
4
Requirements
 
5
============
 
6
CMake 3.1.0 or higher
 
7
Windows Phone/Store 8.1 Visual Studio 2013
 
8
Windows Phone/Store 8.0 Visual Studio 2012
 
9
 
 
10
For example, to be able to build all Windows Phone and Windows Store projects install the following:
 
11
 
 
12
Install Visual Studio 2013 Community Edition
 
13
    http://go.microsoft.com/?linkid=9863608
 
14
 
 
15
Install Visual Studio Express 2012 for Windows Desktop
 
16
    http://www.microsoft.com/en-us/download/details.aspx?id=34673
 
17
 
 
18
 
 
19
 
 
20
To create and build all Windows Phone (8.0, 8.1) and Windows Store (8.0, 8.1) Visual Studio projects
 
21
==========================================================================================
 
22
cd opencv/platforms/winrt
 
23
setup_winrt.bat "WP,WS" "8.0,8.1" "x86,ARM" -b
 
24
 
 
25
If everything's fine, a few minutes later you will get the following output in the opencv/bin directory:
 
26
 
 
27
bin
 
28
    install
 
29
        WP
 
30
            8.0
 
31
                ARM
 
32
                x86
 
33
            8.1
 
34
                ARM
 
35
                x86
 
36
        WS
 
37
            8.0
 
38
                ARM
 
39
                x86
 
40
            8.1
 
41
                ARM
 
42
                x86
 
43
    WP
 
44
        8.0
 
45
            ARM
 
46
            x86
 
47
        8.1
 
48
            ARM
 
49
            x86
 
50
    WS
 
51
        8.0
 
52
            ARM
 
53
            x86
 
54
        8.1
 
55
            ARM
 
56
            x86
 
57
 
 
58
"-b" flag in the command above builds each generated solutions in both "Debug" and "Release" configurations. It also builds the predefined "INSTALL" project within generated solutions. Building it creates a separate install location that accumulates binaries and includes for specified platforms. Default location is "<ocv-src>\bin\install\".
 
59
 
 
60
WinRT samples reference 'install' binaries and include files via "OPENCV_WINRT_INSTALL_DIR" environment variable. Please declare it and point to "<ocv-src>\bin\install\" directory to resolve references within sample applications.
 
61
 
 
62
If you don't want to build all configurations automatically, you can omit "-b" flag and build OpenCV.sln for the particular platform you are targeting manually. Due to the current limitations of CMake, separate x86/x64/ARM projects must be generated for each platform.
 
63
 
 
64
You can also target a single specific configuration
 
65
    setup_winrt.bat "WP" "8.1" "x86"
 
66
 
 
67
Or a subset of configurations
 
68
    setup_winrt.bat "WP,WS" "8.1" "x86"
 
69
 
 
70
To display the command line options for setup_winrt.bat
 
71
    setup_winrt.bat -h
 
72
 
 
73
Note that x64 CMake generation support is as follows:
 
74
------------------------------
 
75
Platform\Version | 8.0 | 8.1 |
 
76
-----------------|-----|-----|
 
77
Windows Phone    | No  | No  |
 
78
Windows Store    | Yes | Yes |
 
79
 
 
80
Note: setup_winrt.bat calls the unsigned PowerShell script with the -ExecutionPolicy Unrestricted option.
 
81
 
 
82
 
 
83
CMake command line options for Windows Phone and Store
 
84
======================================================
 
85
 
 
86
cmake [options] <path-to-source>
 
87
 
 
88
Windows Phone 8.1 x86
 
89
cmake -G "Visual Studio 12 2013" -DCMAKE_SYSTEM_NAME=WindowsPhone -DCMAKE_SYSTEM_VERSION=8.1 <path-to-source>
 
90
 
 
91
Windows Phone 8.1 ARM
 
92
cmake -G "Visual Studio 12 2013 ARM" -DCMAKE_SYSTEM_NAME=WindowsPhone -DCMAKE_SYSTEM_VERSION=8.1 <path-to-source>
 
93
 
 
94
Windows Store 8.1 x86
 
95
cmake -G "Visual Studio 12 2013" -DCMAKE_SYSTEM_NAME=WindowsStore -DCMAKE_SYSTEM_VERSION=8.1 <path-to-source>
 
96
 
 
97
Windows Store 8.1 ARM
 
98
cmake -G "Visual Studio 12 2013 ARM" -DCMAKE_SYSTEM_NAME=WindowsStore -DCMAKE_SYSTEM_VERSION=8.1 <path-to-source>
 
99
 
 
100
Note: For Windows 8.0 Phone and Store you can specify either Visual Studio 11 2012 or Visual Studio 12 2013 as the generator
 
101
 
 
102
Windows Phone 8.0 x86
 
103
cmake -G "Visual Studio 12 2013" -DCMAKE_SYSTEM_NAME=WindowsPhone -DCMAKE_SYSTEM_VERSION=8.0 <path-to-source>
 
104
 
 
105
Windows Phone 8.0 ARM
 
106
cmake -G "Visual Studio 12 2013 ARM" -DCMAKE_SYSTEM_NAME=WindowsPhone -DCMAKE_SYSTEM_VERSION=8.0 <path-to-source>
 
107
 
 
108
Windows Store 8.0 x86
 
109
cmake -G "Visual Studio 12 2013" -DCMAKE_SYSTEM_NAME=WindowsStore -DCMAKE_SYSTEM_VERSION=8.0 <path-to-source>
 
110
 
 
111
Windows Store 8.0 ARM
 
112
cmake -G "Visual Studio 12 2013 ARM" -DCMAKE_SYSTEM_NAME=WindowsStore -DCMAKE_SYSTEM_VERSION=8.0 <path-to-source>
 
113
 
 
114
Example
 
115
======================================================
 
116
 
 
117
To generate Windows Phone 8.1 x86 project files in the opencv/bin dir
 
118
 
 
119
mkdir bin
 
120
cd bin
 
121
cmake -G "Visual Studio 12 2013" -DCMAKE_SYSTEM_NAME=WindowsPhone -DCMAKE_SYSTEM_VERSION=8.1 ../
 
122
 
 
123
Running tests for Windows Store
 
124
===============================
 
125
1. You might need to install this if you haven't already: http://www.microsoft.com/en-US/download/details.aspx?id=40784
 
126
 
 
127
2. Set OPENCV_TEST_DATA_PATH environment variable to location of opencv_extra/testdata (cloning of https://github.com/Itseez/opencv_extra repo required) to get tests work correctly. Also, set OPENCV_PERF_VALIDATION_DIR environment variable in case you are planning to have place where to store performance test results and compare them with the future test runs.
 
128
 
 
129
3. In case you'd like to adjust some flags that are defaulted by setup_winrt script, go to "Manual build" section. Otherwise go to platforms/winrt and execute
 
130
 
 
131
setup_winrt.bat "WS" "8.1" "x64"
 
132
 
 
133
This will generate all files needed to build open_cv projects for selected platform in opencv\bin\<Depends on generated configuration>. Open the opencv\bin\<path to required configuration> directory and open the OpenCV.sln.
 
134
 
 
135
4. Set OCV solution to Release mode and build it. They should build without errors and generate executables in "bin\WS\8.1\x64\bin\Release\" (or similar path depending on the configuration)
 
136
 
 
137
5. Running tests:
 
138
 - **Accuracy:** Run opencv_test_{module}.exe via console or as usual by double clicking it. You should see output in the console window
 
139
 - **Performance:** Run opencv_perf_{module}.exe via console or as usual by double clicking it. You should see output in the console window. In case you'd like to write test results to file use --perf_write_validation_results=<filename> parameter; To compare current results to previous use --perf_read_validation_results=<filename>. This should read/write files from/to OPENCV_PERF_VALIDATION_DIR
 
140
 
 
141
Manual build
 
142
============
 
143
 
 
144
 CMake interface:
 
145
-----------------
 
146
  1. Set CMAKE_SYSTEM_NAME to WindowsStore or WindowsPhone and CMAKE_SYSTEM_VERSION to 8.0 or 8.1
 
147
  2. Set CMAKE_INSTALL_PREFIX using format "<install dir>\WS\8.1\x64" (this structure is required by samples)
 
148
  3. Click "Configure" and choose required generator
 
149
  4. Click "Generate"
 
150
 
 
151
 Command line:
 
152
--------------
 
153
  1. md bin
 
154
  2. cd bin
 
155
  3. Add any required parameters to this command and execute it:
 
156
 
 
157
  cmake -G "Visual Studio 12 2013 Win64" -DCMAKE_SYSTEM_NAME:String=WindowsStore -DCMAKE_SYSTEM_VERSION:String=8.1 -DCMAKE_VS_EFFECTIVE_PLATFORMS:String=x64 -DCMAKE_INSTALL_PREFIX:PATH=.\install\WS\8.1\x64\ ..
 
158
 
 
159
Return to "Running tests for Windows Store", list item 4.
 
 
b'\\ No newline at end of file'