Diff of /vxl-users-faq.html [b2a8d6] .. [f130fc]  Maximize  Restore

Switch to unified view

a/vxl-users-faq.html b/vxl-users-faq.html
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2
<html>
2
<html>
3
  <head>
3
  <head>
4
    <title>vxl-users FAQ</title>
4
    <title>vxl-users FAQ</title>
5
    <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
    <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
6
    <style type="text/css">
7
      body { color: black ; background-color: white }
8
      p.question { font-style: oblique ; font-weight: bold }
9
      p.answer { color: green }
10
    </style>
6
  </head>
11
  </head>
7
12
8
  <body bgcolor=white>
13
  <body>
9
  <a href="http://vxl.sourceforge.net/"><span style="position: absolute; left: 1005; top: 16"><img ALT="VXL" src="logo1-quant.gif" align=right border=0
14
  
10
     width="128" height="48"></span></a>
15
  <h1><a href="http://vxl.sourceforge.net/"><img alt="VXL" src="logo1-quant.gif" border="0" width="128" height="48"/></a>-users Frequently Asked Questions</h1>
11
  <h1>vxl-users Frequently Asked Questions</h1>
12
16
13
<hr>
17
<hr/>
14
18
15
  <ol>
19
  <ol>
16
    <li>
20
    <li>
17
      <blockquote><p>I have successfully built VXL under MS Visual Studio, and am now trying to build a simple
21
      <p class="question">I have successfully built VXL under MS Visual Studio, and am now trying to build a simple
18
    program that uses the libraries. The Linker complains that there are multiple definitions (error
22
    program that uses the libraries. The Linker complains that there are multiple definitions (error
19
        <code>LNK2005</code>)
23
        <code>LNK2005</code>)
20
    of several things from the C++ Standard Library. What is going wrong?</p>
24
    of several things from the C++ Standard Library. What is going wrong?</p>
21
      </blockquote>
22
      <p>These kinds of errors often indicate that you are linking against different C++ run-time libraries that you
25
      <p class="answer">These kinds of errors often indicate that you are linking against different C++ run-time libraries that you
23
      compiled VXL with (release vs debug, static vs DLL stdlib, etc). The flags like
26
      compiled VXL with (release vs debug, static vs DLL stdlib, etc). The flags like
24
      <code> /MP</code> and <code> /MD</code> much match exactly,
27
      <code>/MP</code> and <code>/MD</code> much match exactly,
25
      in VXL's build and your program's build. These flags are set in Visual Studio under
28
      in VXL's build and your program's build. These flags are set in Visual Studio under
26
      Settings->C/C++->Code Generation->Use run-time library.</p>
29
      Settings-&gt;C/C++-&gt;Code Generation-&gt;Use run-time library.
30
      <br/>
27
      <p>The easiest way to link against these projects, we've found, is to use CMake for your project too.
31
      The easiest way to link against these projects, we've found, is to use CMake for your project too.
28
      CMake will then make sure the flags match, or else will give you an error or warning.</p>
32
      CMake will then make sure the flags match, or else will give you an error or warning.</p>
29
33
30
<hr>
34
<hr/>
31
35
32
    </li>
36
    </li>
33
37
34
    <li>
38
    <li>
35
      <blockquote>
36
        <p>I followed the VXL installation documentation, but found that some of the entries in the
39
      <p class="question">I followed the VXL installation documentation, but found that some of the entries in the
37
        <code>
40
        <code>
38
        CMakeCache.txt</code> file say that CMake could not find programs, paths, etc. Is this a problem?&nbsp;</p>
41
        CMakeCache.txt</code> file say that CMake could not find programs, paths, etc. Is this a problem?</p>
39
      </blockquote>
40
      <p>    No. VXL needs very little to build correctly (only a C/C++ compiler at worst), however it can make use of
42
      <p class="answer">No. VXL needs very little to build correctly (only a C/C++ compiler at worst), however it can make use of
41
  various system provided libraries, rather than build its own versions. CMake also looks for lots of system tools
43
  various system provided libraries, rather than build its own versions. CMake also looks for lots of system tools
42
  so that it can understand the environment it is in. So having lots of <code> NOTFOUND</code> entries is quite normal. There is
44
  so that it can understand the environment it is in. So having lots of <code>NOTFOUND</code> entries is quite normal. There is
43
  no need to worry unless CMake displays a warning or error message while it runs.</p>
45
  no need to worry unless CMake displays a warning or error message while it runs.</p>
44
46
45
<hr>
47
<hr/>
46
48
47
      </li>
49
    </li>
48
50
49
    <li>
51
    <li>
50
      <blockquote>
51
  <p>I used CMake to create a MSVC project with <code>BUILD_SHARED_LIBRARY=ON</code>. But when I try to build, it gives message
52
      <p class="question">I used CMake to create a MSVC project with <code>BUILD_SHARED_LIBRARY=ON</code>. But when I try to build, it gives message
52
  &quot;<code>cannot open
53
  &quot;<code>cannot open
53
  vcl.lib</code>&quot;. What's wrong?&nbsp;</p>
54
  vcl.lib</code>&quot;. What's wrong?</p>
54
      </blockquote>
55
      <p>    VXL does not support the CMake "Shared Library" feature on MSVC. You have to use static libraries. This is mostly
55
      <p class="answer">VXL does not support the CMake "Shared Library" feature on MSVC. You have to use static libraries. This is mostly
56
  due to MSVC's requirements to have either a complete list of every exportable identifier or a decoration of every
56
  due to MSVC's requirements to have either a complete list of every exportable identifier or a decoration of every
57
  identifier in the code. We are too lazy (or appalled at this "feature") to try to fix this. If you absolutely need
57
  identifier in the code. We are too lazy (or appalled at this "feature") to try to fix this. If you absolutely need
58
  DLLs you can build your code using Cygwin, which can produce shared libraries in a "normal" manner. Alternatively, if you only want to export a small
58
  DLLs you can build your code using Cygwin, which can produce shared libraries in a "normal" manner. Alternatively, if you only want to export a small
59
  number of classes or functions, then you can manually list them. See the MSVC tool documentation for further
59
  number of classes or functions, then you can manually list them. See the MSVC tool documentation for further
60
  details.</p> <hr></li>
60
  details.</p>
61
  
61
62
<hr/>
63
64
    </li>
62
65
63
    <li>
66
    <li>
64
      <blockquote>
67
      <p class="question">I have successfully built VXL, but when I try to write my own program to use it,
65
  <p>I have successfully built VXL, but when I try to write my own program to use it, I get errors like &quot;<code>include file not found</code>&quot;, 
68
      I get errors like &quot;<code>include file not found</code>&quot;,
66
  or &quot;<code>unresolved symbol</code>&quot; , or &quot;<code>unresolved external symbol</code>&quot; . What&#039;s wrong?
69
      or &quot;<code>unresolved symbol</code>&quot; , or &quot;<code>unresolved external symbol</code>&quot;.
67
          </p>
70
      What&#039;s wrong?</p>
68
      </blockquote>
69
      <p>Your makefile or IDE settings have not been correctly set up to include VXL .h files, or link
71
      <p class="answer">Your makefile or IDE settings have not been correctly set up to include VXL .h files, or link
70
      against VXL or system libraries. Details can be found in the &quot;Build Systems&quot; appendix of the
72
      against VXL or system libraries. Details can be found in the &quot;Build Systems&quot; appendix of the
71
      <a href="http://paine.wiau.man.ac.uk/pub/doc_vxl/books/core/book.html">VXL Book</a>. If you
73
      <a href="http://paine.wiau.man.ac.uk/pub/doc_vxl/books/core/book.html">VXL Book</a>. If you
72
      still have problems, show the appendix to a competent local programmer, and ask for their advice.</p>
74
      still have problems, show the appendix to a competent local programmer, and ask for their advice.</p>
73
    <hr></li> 
74
      
75
75
76
  
76
<hr/>
77
78
    </li>
79
77
    <li>
80
    <li>
78
      <blockquote>
79
  <p>No-one has answered my question on vxl-users. It is really important that I get an answer.</p>
81
      <p class="question">No-one has answered my question on vxl-users. It is really important that I get an answer.</p>
80
      </blockquote>
81
      <p>Your questions may be very poorly posed, and none of the other members of vxl-users, can answer it.
82
      <p class="answer">Your questions may be very poorly posed, and none of the other members of vxl-users, can answer it.
82
      If you still haven't had a reply after a week, please read the <a href="vxl-users-policy.html"> vxl-users list policy</a>,
83
      If you still haven't had a reply after a week, please read the <a href="vxl-users-policy.html">vxl-users list policy</a>,
83
      and repost your email after taking account of the advice in the policy.</p>
84
      and repost your email after taking account of the advice in the policy.</p>
85
86
<hr/>
87
84
      </li>       
88
      </li>
85
      
89
86
  </ol>
90
  </ol>
87
91
88
<hr>
92
<hr/>
89
    <address>
93
  <address>
90
<font color="#0000ff">vxl-maintainers at
94
   <a href="http://validator.w3.org/check?uri=referer"><img src="valid-html401.png" height="31" width="88" align="right" border="0" alt="Valid HTML 4.01 Transitional"/></a>
91
    lists dot sourceforge dot net</font>
95
   <font color="blue">vxl-maintainers&nbsp;at&nbsp;lists&nbsp;dot&nbsp;sourceforge&nbsp;dot&nbsp;net</font>
96
  <br/>
97
   Hosted by <a href="http://sourceforge.net/"><img src="sflogo.png" alt="SourceForge Logo" align="middle" border="0"/></a>
92
</address>
98
  </address>
93
94
99
95
  </body>
100
  </body>
96
</html>
101
</html>