Move the sources to trunk
[opencv] / docs / HTML / FAQ.htm
1 <HTML>
2   <HEAD>
3     <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
4     <META NAME="Generator" CONTENT="Microsoft Word 97">
5     <META NAME="Template" CONTENT="D:\WIN32APP\msoffice97\Office\html.dot">
6     <META NAME="GENERATOR" CONTENT="Microsoft FrontPage 4.0">
7     <META NAME="Author" CONTENT="Gary Bradski">
8     <META NAME="Description" CONTENT="Header for main functions">
9     <META NAME="KeyWords" CONTENT="CV.h">
10     <TITLE>OpenCV Frequently Asked Questions</TITLE>
11   </HEAD>
12   <BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
13     <a name="top">
14       
15     <CENTER><TABLE CELLSPACING=0 CELLPADDING=5 WIDTH="90%" BGCOLOR="#6A9BED" NOSAVE >
16     <TR NOSAVE>
17       <TD NOSAVE>
18         <h1 align="center">
19         Open Source Computer Vision Libray</h1>
20         <p align="center">
21         <i><font size="+4" color="#000000">
22           Frequently Asked Questions
23         </font></i></p>
24       </TD>
25     </TR>
26       </TABLE></CENTER>
27
28     <p>&nbsp;</p>
29     <h2>
30
31 <b>General Qs:</b>
32     </h2>
33     <p>&nbsp;</p>
34 <h3 ><b>Q1: Where do I submit Bug reports for
35 the computer vision library?</b></h3>
36 <p >A1: Send email to <a href="mailto:OpenCV@yahoogroups.com">OpenCV@yahoogroups.com</a>&nbsp;
37 Subject: BUG &lt;....your title...&gt;</p>
38 <p >&nbsp;</p>
39 <h3 ><b>Q2: How do I send bug reports for the
40 Intel® Image Processing Library?</b></h3>
41 <p >A2: Send email to <a href="mailto:developer_support@intel.com">developer_support@intel.com</a><br>
42 </p>
43 <h3 ><b>Q3: How do I join the web group for
44 the library?</b></h3>
45 <p >A3: Send email to <a href="mailto:OpenCV-subscribe@yahoogroups.com">OpenCV-subscribe@yahoogroups.com</a>,
46 after you are a member and select your logon, you can read the web group at <a href="http://groups.yahoo.com/group/OpenCV">http://groups.yahoo.com/group/OpenCV</a>
47  **. </p>
48 <p >&nbsp;</p>
49 <h3 ><b>Q4: How do I modify the web group so
50 that I don't receive email everyday?</b></h3>
51 <p >A4: To get the messages real time, or
52 once a day as a daily digest, you can go to <a href="http://groups.yahoo.com/mygroups" target="_top">http://groups.yahoo.com/mygroups</a>
53  ** and choose your setting from the pull down list to the right of OpenCV.&nbsp;&nbsp;</p>
54
55 <p>&nbsp; 
56 </p>
57
58 <h3><b>Q5: How do I get support for the Image Processing Library (IPL)?</b> 
59 </h3>
60
61 <p>
62 A5: For the Image Processing Library, all support questions should go through:<BR>
63 <a href="http://support.intel.com/support/performancetools/support.htm"> http://support.intel.com/support/performancetools/support.htm</a> (for release libraries)<BR>
64 <a href="https://premier.intel.com/scripts-quad/welcomeplsb.asp"> https://premier.intel.com/scripts-quad/welcomeplsb.asp</a>  (for beta libraries)<BR> 
65 </p>
66
67     <h2><BR>
68 <b >Windows* OS related Qs:</b>
69 <BR><BR>
70     </h2>
71 <h3 ><b>Q1: When I try to build one of the
72 apps, I get an error, streams.h not found?</b></h3>
73     <p >A1: You need the direct show SDK for
74 streams.h. You do not need DirectX* SDK for NT* 4.0 to compile and run DirectShow
75 filters. You need only DirectX Media* SDK (version 5.x or higher), that can be
76 downloaded from <a href="http://microsoft.com/directx/homeuser/downloads/default.asp" target="_top">http://microsoft.com/directx/homeuser/downloads/default.asp</a>
77  ** This SDK can be used under Win98, NT 4.0 or Win2000 without any problem. Do not forget to put
78 paths to the <i>include</i> subfolder and <i> classes\base</i> (in case of
79     DirectX Media 5.x or 6.x) or <i>samples\Multimedia\DirectShow\BaseClasses </i>(in
80     case of DirectX 8.x) subfolder to include paths in
81 DevStudio* (they should go <b>first </b>in the list!!!) and <i> lib</i> subfolder to lib
82 paths in DevStudio. </p>
83     <p >If you have DirectX 8.x, you should build base C++ library for Direct
84     Show by yourself. In DevStudio open <i>baseclasses.dsw</i> workspace from <i>samples\Multimedia\DirectShow\BaseClasses</i>
85     subfolder and build both release and debug configurations of the library.
86     Finally, copy resulting <i>strmbase.lib</i> and <i>strmbasd.lib </i>libraries
87     to <i>lib</i> subfolder of DirectX 8.x or OpenCV installation folder. That's
88     it. </p>
89 <h3 >&nbsp;</h3>
90 <h3 ><b>Q2: I've installed the DirectX Media
91 SDK, but get build problems.</b></h3>
92 <p >A2: Do not forget to put paths to the
93 include subfolder and classes\base subfolder to include paths in DevStudio (they
94 should go <b>first </b>in the list!!!) and lib subfolder to lib paths in
95 DevStudio. Do not forget to build DirectShow C++ libraries. See the previous
96 question as well. </p>
97 <h3 >&nbsp;</h3>
98 <h3 ><b>Q3: Where can I find out about
99 compatible USB Cameras?</b></h3>
100 <p >A3: look at <a href="http://web2.airmail.net/mprater/101/">http://web2.airmail.net/mprater/101/</a>&nbsp;**
101 There are a lot of USB camera (often called WebCams) links there. </p>
102 <p >&nbsp;</p>
103 <h3 ><b>Q4: When I build a filter graph with
104 a USB camera, there are no output pins!? (Happens with Win2000* 3Com* camera).</b></h3>
105 <p >A4: You can get the output pins to
106 appear by selecting &quot;refresh&quot; from the graphedt.exe** menu.</p>
107 <p >&nbsp;</p>
108 <h3 ><b>Q5: How do you set the video format
109 (e.g., resolution) of a WDM* video capture source camera within GraphEdit* (Filter
110 Graph Editor)?</b></h3>
111 <p >A5: Set the video format with the
112 property page of the output pin of the capture source. Just click the right
113 mouse button in GraphEdit on the output pin to display the property page. <b>But</b>
114 make sure you do that before connecting the pin to other pins.</p>
115 <p >&nbsp;</p>
116 <h3 ><b>Q6: When I try to register a filter
117 or install the library, I get an &quot;IPL Waterfall&quot; error, what's up?</b></h3>
118 <p >A6: IPL library has a bug in it, it
119 uses a DLL switcher so that IPL.DLL replaces itself with the processor
120 appropriate DLL (such as IPLA6.DLL for a PIII).&nbsp; The problem is, the DLL
121 switcher looks only in the system path, not in the current directory.&nbsp;
122 Thus, if the IPL DLL directory isn't in the system path, or you have a different
123 version of IPL somewhere in front of the current directory in the system path,
124 this error will occur.&nbsp; Solution: Get rid of other versions of IPL and
125 change the system path to point to the correct IPL directory or move the IPL
126 DLLs to a directory (system, system32) that is in the system path.</p>
127 <p >&nbsp;</p>
128 <h3 ><b>Q7: How do I register a
129 directShow filter?</b></h3>
130 <p >A7: Call up a command line prompt, cd
131 to the directory the filter is in, run regsvr32 &lt;filtername.ax&gt;.&nbsp;
132 Obviously, this will only work if regsvr32 is in your system path.&nbsp;</p>
133 <p >&nbsp;</p>
134 <h3 ><b>Q8: regsvr32 &lt;filtername.ax&gt;
135 fails.&nbsp; What to do?</b></h3>
136 <p >A8: Almost always means that some DLL
137 the filter depends on is not being found in the local directory or the system
138 path.&nbsp; If you have MSVC++* installed, you have a copy of a program called
139 &quot;depends.exe&quot;.&nbsp; Run this program on the offending filter.&nbsp;
140 Missing DLLs will appear highlighted.&nbsp; Find these DLLs, move them to the
141 local directory or system path and try regsvr32 again. Viola.</p>
142 <h3>&nbsp;</h3>
143 <h3><b>
144 Q9: I get: LINK : fatal error LNK1104: cannot open file "cvd.lib" Error executing link.exe. Where can I get this lib from?</B></h3>
145 <p>
146 A9: It's the debug version of the library. Using MSVC++: Either: Under the Project menu, select Settings. Then select the Link tab and change the library to use to cv.lib; Or: Build a debug version of the library -- Under the build menu select "Set Active Configuration", click on "Debug" and the build all to build a debug version of cv.lib named cvd.lib. Another method is to just rename cv.lib to cvd.lib ... but you won't be able to debug.</p>
147 <p >&nbsp;</p>
148
149     <h2>
150
151 <b >Linux* Related Qs:</b>
152     </h2>
153 <p >&nbsp;</p>
154 <h3><b>Q1:
155 Do you know, if there exist any Linux drivers for USB cameras and/or for Matrox
156 MeteorII boards?</b></h3>
157 <p>A1:&nbsp;
158 USB on Linux is just now maturing, but is doing so very quickly. The best site
159 to visit is (URL:<a href="http://www.linux-usb.org/">http://www.linux-usb.org/ </a>**
160 ). Of specific interest is the link (URL:<a href="http://www.qbik.ch/usb/devices/">http://www.qbik.ch/usb/devices/</a>
161 **), which has a video section. For the Matrox MeteorII, there appears to be a
162 driver for the Linux4Video2 system, which is a more advanced video system being
163 developed in parallel with the Linux4Video(1), included in the kernel. Details
164 at (URL:<a href="http://www.thedirks.org/v4l2/">http://www.thedirks.org/v4l2/</a>
165 **). See the &quot;People&quot; section for the driver. A downside with V4L2 is
166 that it's not yet working under 2.3.x or 2.4.x of the Linux kernel.</p>
167 <p >&nbsp;</p>
168 <!-- <h3 ><b>Q2: OpenCV won't run without a Linux
169 version of the Intel® Image Processing Library, where do I get this?</b></h3>
170 <p >A2: Go to the <a href="/research/mrl/research/cvlib/Downloadlicense.htm">download</a>
171 page and get the Intel® Image Processing Library (IPL) for Linux<font size="3">.</font></p>
172 <p >&nbsp;</p>
173 -->
174 <hr noshade size=2 width=100%>
175 <H3>
176   <A NAME="Bottom"></A><A HREF="#Top">Back to Top<IMG SRC="up.gif" BORDER=0 height=26 width=30></A></H3>
177
178   </BODY>
179 </HTML>