WikiStart

Version 114 (Gary Bradski, 2016-03-01 07:24 pm)

1 112 Gary Bradski
h1. *ATTENTION!*
2 112 Gary Bradski
3 112 Gary Bradski
Issue tracker will be closed on 2015-07-27! 
4 114 Gary Bradski
All new tickets should be created on GitHub: https://github.com/Itseez/opencv/issues
5 112 Gary Bradski
6 1
h1. OpenCV Wiki
7 88 Gary Bradski
8 88 Gary Bradski
{{>toc}}
9 50 Gary Bradski
10 52 Gary Bradski
!http://opencv.org/wp-content/themes/opencv/images/logo.png!
11 49 Gary Bradski
12 92 Gary Bradski
OpenCV (Open Source Computer Vision) is a library of programming functions for realtime computer vision. It uses a "BSD license":http://opensource.org/licenses/BSD-3-Clause and hence it's free for both academic and commercial use. It has C++, C, Python and Java (Android) interfaces and supports Windows, Linux, Android, iOS and Mac OS. It has more than 2500 optimized algorithms. Adopted all around the world, OpenCV has more than 7 million downloads growing by nearly 200K/month. Usage ranges from interactive art, to mines inspection, stitching maps on the web on through advanced robotics.
13 1
14 34 Gary Bradski
* "Wiki map":http://code.opencv.org/projects/opencv/wiki/index
15 89 Gary Bradski
* "Roadmap":http://www.code.opencv.org/projects/opencv/roadmap
16 1
17 99 Gary Bradski
18 107 Gary Bradski
h2. GSoC 2015
19 99 Gary Bradski
20 108 Gary Bradski
" !GSoCOpenCV2015.jpg! ":http://code.opencv.org/projects/opencv/wiki/GSoC_2015
21 1
22 109 Gary Bradski
* *[[GSoC 2015|OpenCV Google Summer of Code 2015 Project Page]]*
23 109 Gary Bradski
* "We are an accepted organization in GSoC 2015!":http://www.google-melange.com/gsoc/org2/google/gsoc2015/opencv
24 109 Gary Bradski
25 96 Gary Bradski
26 107 Gary Bradski
"Wiki for Google Summer of Code":https://www.google-melange.com/gsoc/dashboard/google/gsoc2015
27 96 Gary Bradski
28 1
h2. Resources
29 1
30 86 Gary Bradski
h3. General
31 86 Gary Bradski
32 86 Gary Bradski
* "User site":http://opencv.org/, "News":http://opencv.org/category/news and "Help":http://answers.opencv.org.
33 111 Gary Bradski
* *Documentation:* http://opencv.org/documentation.html, including "Books":http://opencv.org/books.html, "Reference manual":http://docs.opencv.org/, "Tutorials":http://docs.opencv.org/doc/tutorials/tutorials.html and "Cheatsheet":http://docs.opencv.org/opencv_cheatsheet.pdf
34 86 Gary Bradski
* "ChangeLog":http://code.opencv.org/projects/opencv/wiki/ChangeLog for the latest releases
35 86 Gary Bradski
36 86 Gary Bradski
h3. Development
37 86 Gary Bradski
38 86 Gary Bradski
* [[How_to_contribute|How to Contribute]]
39 86 Gary Bradski
* Source Codes can be found at "GitHub":https://github.com/Itseez/opencv. The main OpenCV repository was converted to git and compactified. History now begins with the famous “atomic bomb” commit, that dates back to May the 11th, 2010.
40 91 Gary Bradski
** To get the source code, point your git client to @git://github.com/Itseez/opencv.git@. Here are [[Working_with_OpenCV_git_repository|instructions]].
41 78 Gary Bradski
<pre>
42 82 Gary Bradski
git clone git://github.com/Itseez/opencv.git
43 78 Gary Bradski
</pre>
44 80 Gary Bradski
** The rest of the history plus matches between git commits and SVN revisions are stored at a separate "OpenCV Attic" repository: git://code.opencv.org/opencv_attic.git.
45 78 Gary Bradski
** Also OpenCV Extra was put to a separate repository: git://code.opencv.org/opencv_extra.git.
46 86 Gary Bradski
* [[OpenCV Development Process]]
47 86 Gary Bradski
** [[Meeting_notes|Developer meeting notes]]
48 1
49 86 Gary Bradski
h2. Issue Tracking
50 60 Gary Bradski
51 86 Gary Bradski
Please note that OpenCV project, as any open-source project, welcomes contributions from users. Either you have implemented some new functionality, or you're able to localize and fix a bug by yourself, please make a "pull request":https://github.com/Itseez/opencv/pulls at the GitHub. It will be "automatically tested":http://pullrequest.opencv.org and reviewed by peers. Check your code for compliance with [[CodingStyleGuide|OpenCV Code Style Guide]] and please explain how your contribution might help others.
52 60 Gary Bradski
53 3 Gary Bradski
h3. Creating new tickets
54 78 Gary Bradski
55 114 Gary Bradski
All new tickets should be created on GitHub: https://github.com/Itseez/opencv/issues and https://github.com/Itseez/opencv_contrib/issues
56 86 Gary Bradski
57 113 Gary Bradski
Old issue tracker will be moved to read-only state: http://code.opencv.org/projects/opencv/issues
58 1
59 1
h3. Reporting bugs
60 78 Gary Bradski
61 78 Gary Bradski
* First of all ask about the issue at the Q&A forum: http://answers.opencv.org. Then try to debug it in your own environment, because it may take forever to just reproduce the issue on other workstation. If you succeed, submit the fix as a pull request, and your fix may be included to the very next OpenCV release! But if you can't debug it, please do as follows...
62 77 Gary Bradski
63 1
* Please, specify your platform (Windows 32/64bit, Linux x86/x64/ppc/..., MacOSX 32/64bit/ppc); compiler version; OpenCV version/revision; whether IPP, OpenMP, MMX, SSE ... have been enabled or not, and any other information that let us reproduce the environment, identify and localize the problem.
64 78 Gary Bradski
65 86 Gary Bradski
* A sample code reproducing the problem helps us the most. It would really help if you could implement a unit-test that fails! Please check source:samples - for the preferred style (small code size, cross-platform).  There is *no need* to provide any project files or makefiles, if it is a short single-file sample, we could build it and run in a minute. If we can reproduce the problem, we can fix it quickly.
66 51 Gary Bradski
67 1
* If your application is complex, and the problem happens somewhere in the middle, often it is still possible to create a short standalone sample: 
68 16 Gary Bradski
** First, capture and store the data that you pass to the function using FileStorage.
69 17 Gary Bradski
** Then copy the function call and put the corresponding reading from FileStorage in front of it.
70 16 Gary Bradski
71 16 Gary Bradski
h2. Topic Pages
72 1
73 105 Gary Bradski
* [[GSoC 2015|Google Summer of Code 2015 (GSoC 2015) Ideas Page]]
74 101 Gary Bradski
* [[Workshops|Workshops]]
75 110 Gary Bradski
* [[Tutorials|Tutorials]]
76 110 Gary Bradski
* [[VisionChallenge|Vision Challenge Sponsored by OpenCV, CVPR 2015!!]]
77 31 Gary Bradski
* [[New functionality discussion]]
78 75 Gary Bradski
* [[CARMA platform, compilation and testing]]