[92d25a]: index.html Maximize Restore History

Download this file

index.html    252 lines (207 with data), 11.7 kB

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>VXL homepage</title>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
</head>
<body bgcolor=white>
<center>
<h1>The
<a href="http://vxl.sourceforge.net/">
<img ALT="VXL" src="logo1-quant.gif" border="0" width="128" height="48" align="top"></a>
Homepage</h1>
<p>C++ Libraries for Computer Vision Research and Implementation</p>
</center>
<hr>
<b>Contents:</b>
<a href="#intro">[Introduction]</a>&nbsp;&nbsp; <a href="#docs">[Documentation]</a>&nbsp;&nbsp;
<a href="#examples">[Example code and images]</a>&nbsp;&nbsp;
<a href="#download">[Download and install]</a>&nbsp;&nbsp;
<a href="#mail">[Mailing list]</a>&nbsp;&nbsp;
<a href="#dashboard">[Builds dashboard]</a>&nbsp;&nbsp; <a href="#bugs">[Bug reports]</a>
<hr>
<h2><a name="intro">Introduction: What is VXL?</a></h2>
VXL (the Vision-<i>something</i>-Libraries) is a collection of C++ libraries designed for computer
vision research. It was created from <a href="http://www.esat.kuleuven.ac.be/~targetjr/">
TargetJr</a> and the <a href="http://www.aai.com/AAI/IUE/IUE.html">Image Understanding Environment</a>
(IUE) with the aim of making a lighter, faster and more consistent system. VXL is written in ANSI/ISO
C++ and is designed to be portable over many platforms.
The core libraries in VXL are:
<ul>
<li><b>vcl (C++ compatibility layer)</b>: This library exists purely to make sure all standard C++
libraries are the same on all compilers. This means that all standard headers in VXL are
preceded with the letters vcl_, so for example instead of including <code>&#60;vector&#62;</code>
you would include <code>&#60;vcl_vector.h&#62;</code> and would use <code>vcl_vector&lt;&gt;</code>
rather than <code>std::vector&lt;&gt;</code> in your code.</li>
<li><b>vnl (numerics)</b>: Numerical containers and algorithms, in particular vnl provides
matrix and vector classes with operations for manipulating them, such as matrix decompositions.</li>
<li><b>vil (imaging)</b>: Loading, saving and manipulating images in many common file formats,
including very large images.</li>
<li><b>vgl (geometry)</b>: Geometry for points, curves and other elementary objects in 1, 2 or 3 dimensions.</li>
<li><b>vsl (streaming I/O)</b>: Platform independent binary I/O functionality.</li>
<li><b>vbl (basic templates)</b>: A collection of useful templated C++ classes and functions
that would have been in the STL if we had designed it. For example smart pointers,
2D and 3D arrays, sparse 2D and 3D arrays.</li>
<li><b>vul (utilities)</b>: Useful non-numeric bit of code, e.g. for file,
directory, and url handling, command-line parsing, using strings, timing, etc.</li>
<li><b>vpl (posix)</b>: Some POSIX commands, such as mkdir and unlink.</li>
</ul>
As well as the core libraries, there are libraries covering <b>numerical algorithms, image processing,
co-ordinate systems, camera geometry, stereo, video manipulation, structure recovery from
motion, probability modelling, GUI design, classification, robust estimation,
feature tracking, topology, structure manipulation</b>, and much more.
These libraries may be in the VXL package, or in one of the add-on packages
such as tbl or oxl or rpl which contain useful code that may not be up to the
excellent quality standards of VXL.
<p>Each core library is lightweight, and can be used without reference to the
other core libraries. To prevent too much interdependency between libraries,
there are strict rules on which libraries may use each other.
This makes the whole dependency graph quite sparse, and allows you to compile and link just
the libraries you really need.
<p>For a more detailed description of the libraries see
<a href="http://paine.wiau.man.ac.uk/pub/doc_vxl/books/core/book.html">the VXL book</a>.
<hr>
<h2><a name="docs">Documentation</a></h2>
<h3>Documentation on the whole of VXL</h3>
There are two main references for information on the whole of VXL:
<ul>
<li><a href="http://paine.wiau.man.ac.uk/pub/doc_vxl/index.html">VXL package documentation</a>
- this documents the latest development version of VXL.
It has a detailed description of every
class and function in VXL which is auto-generated from the code using
<a href="http://www.stack.nl/~dimitri/doxygen/index.html">Doxygen</a>.
An alternative lay-out with essentially identical content can be found
<a href="http://www.esat.kuleuven.ac.be/~targetjr/vxl/">here</a>.
<li><a href="http://paine.wiau.man.ac.uk/pub/doc_vxl/books/core/book.html">VXL book</a>
- this is a single reference for all high-level documentation on VXL. It currently documents
the CVS snapshot of VXL.
</ul>
The <a href="http://www.isbe.man.ac.uk/search_vxl.html">documentation search</a>
page is useful for quickly finding documentation.
<h3>VXL guides</h3>
These are short guides to specific areas in VXL:
<ul>
<li><b>xcv</b> is an application built to demonstrate the functionality of the VXL libraries.
<ul>
<li>There is a <a href="manuals/xcv/newxcv.html">guide to using xcv</A>
(also available <a href="manuals/xcv.ps.gz">in postscript format</a>).
<li>Download <a href="manuals/xcv.zip">xcv for Windows</a>,
<a href="manuals/xcv-SunOS5.bin.gz">xcv for solaris</a>.
and <a href="manuals/xcv-linux.bin.gz">xcv for linux</a>
<li>Here is some <a href ="manuals/xcvdata.tar.gz">example data</a>
suitable for use with xcv.
</ul>
<br>
<li><b>vgui</b> is the VXL graphical user interface library.
<ul>
<li>For a simple introduction to using VGUI there is the
<a href="manuals/vgui_users_guide/index.html">VGUI users guide</a>
(also <a href="manuals/vgui_users_guide.ps.gz">in postscript format</a>).
Here is the <a href ="manuals/examples-tutorial.tar.gz">
example code</a> used in the guide.
<li>The <a href="manuals/vgui_ref_manual/index.html">VGUI
reference manual</a> (also <a href="manuals/vgui_ref_manual.ps.gz">in
postscript format</a>) is designed for developers of VGUI.
</ul>
</ul>
xcv and vgui have not changed a lot since the last release of VXL so these guides should be useful for both
the release and development versions of VXL.
<ul>
<li>The <a href="http://paine.wiau.man.ac.uk/pub/doc_vxl/books/contrib/mul/book.html">MUL
book</a> is an overview of libraries concerned with probability modelling,
classification, and registered images.</li>
</ul>
<hr>
<h2><a name="examples">Example code and images</a></h2>
<ul>
<li><a href ="manuals/examples.tar.gz">Example code with no user interface</a>
<li><a href ="manuals/examples-with-vgui.tar.gz">Example code using vgui</a>
<li><a href ="manuals/examples-gtk.tar.gz">Examples using gtk</a>
<li><a href ="manuals/images.tar.gz">Example images</a>
</ul>
<hr>
<h2><a name="download">Download and install</a></h2>
You can either download the latest official release (VXL 1.0 beta2) or
the latest development version of VXL. If you are only interested in
using VXL as a collection of libraries then this is the recommended
version:
<ul>
<li><a href="http://sourceforge.net/projects/vxl/">Download VXL 1.0 beta2</a>
<li><a href="releases/install-beta.html">Installing beta version</a>
</ul>
If you wish you may download the latest development version of VXL
(you will definitely need this version if you are interested in
contributing to VXL). The latest version of VXL is available from
SourceForge and can be downloaded using CVS (Concurrent Versions
System). You will also need to download <a href="http://www.cmake.org/">CMake</a>
(this is a tool for generating makefiles or Microsoft project files
that is used by the latest version of VXL).
<ul>
<li><a href="http://www.gnu.org/software/cvs/cvs.html">CVS homepage</a>. If you are using a Windows platform
you may wish to use <a href="http://sources.redhat.com/cygwin/">Cygwin</a> or
<a href="http://www.wincvs.org">WinCVS</a> which provide a nice GUI for CVS.
<li><a href="http://www.cmake.org/">CMake homepage</a>
<li><a href="http://sourceforge.net/cvs/?group_id=24293">Download latest development version of VXL</a>. (If you don't know what to use for <I>modulename</I> see the note below.)
<li><a href="releases/install-latest.html">Installing latest VXL</a>
</ul>
When you are checking out VXL you can use any of the
following <I>modulename</i>s:
<UL>
<LI>"vxl" - the sources for everything, including the contrib libraries.
<LI>"www" - these web pages
</UL>
<!--
<strong>Caveat</strong>: Even when you check out a subset of the code,
a subsequent <tt>cvs update</tt> may pull in everything! For example,
if you do a <tt>cvs checkout vxl</tt>, you will get <tt>src/vxl</tt>,
<tt>src/vcl</tt>, and a couple more. If you then do <tt>cvs update
-Pd</tt> from the <tt>src</tt> directory, you will get
<tt>src/gel</tt>, <tt>src/oxl</tt>, etc. We can't do much about
this. Blame CVS. :-)
-->
<p>
The following links may be helpful if you work under Windows.
<ul>
<li> <a href="http://www.cs.bris.ac.uk/~cooper/vxlcvs.html">VXL using CVS and SourceForge</a>
<li> <a href="http://www.cs.bris.ac.uk/~cooper/sshcvs.html">SSH and CVS under Windows</a>
</ul>
<hr>
<h2>Problems and where to get help</h2>
<h3><a name="mail">Mailing list</a></h3>
The <a href="http://sourceforge.net/mail/?group_id=24293">VXL mailing
lists</a> are at SourceForge. You can find list descriptions,
subscription information, and archives there.
<h3><a name="dashboard">Dashboard</a></h3>
The <a href="http://www.cs.rpi.edu/research/vision/vxl/Testing/Dashboard/MostRecentResults-Nightly/Dashboard.html">dashboard</a>
is a summary (collated from different machines at different sites in
different timezones) of the current build status of VXL. More builds
are welcome; just follow the <a href="submit-build.html">instructions for submitting a build</a>.
<h3><a name="bugs">Reporting bugs to the mailing list</a></h3>
If you think you have found a bug, or if you have an installation or build problem
which is not covered on this page (see below), please submit a bug
report on the <a href="http://lists.sourceforge.net/lists/listinfo/vxl-users">vxl-users
mailing list</a>. Also supply the following information unless you know for certain it is not relevant:
<ul>
<li> Exactly what you did and exactly what goes wrong. Be verbose. We need to know this in order to help.
If you have problems configuring VXL, include the options you gave to configure and the output it
produced. If you have problems compiling VXL, include the command the makefiles issued, as well as
the entire error message.
<li> Compiler and <i>compiler version number</i>. For gcc, this means we want the output of the
two shell commands "gcc -v" and "g++ -v" (yes, both, please - they have been known to differ). For other
compilers try -V, -ver, -version or read the manual.
<li> Operating system (e.g. linux/solaris/irix) and architecture (e.g. i386/sparc/mips). If this
means nothing to you, give some indication of the sort of machine (e.g. does it have "Indy"
or "AEGIS" or "Ultra" or "Cray" or "HAL" etc written on it?).
</ul>
<hr>
<address>
<a href="http://validator.w3.org/check/referer"><img
src="http://www.w3.org/Icons/valid-html401" height="31" width="88"
align=right border="0" alt="Valid HTML 4.01!"></a>
<p><font color="#0000ff">vxl-maintainers at
lists dot sourceforge dot net</p></font></address>
<p>
Hosted by <A href="http://sourceforge.net">
<IMG src="http://sourceforge.net/sflogo.php?group_id=24293&amp;type=1" alt="SourceForge Logo" align="middle" border="0"> </A>
</body>
</html>