-
Notifications
You must be signed in to change notification settings - Fork 2
Getting Started
Libopenmv runs on top of the .NET runtime. Therefore, the only dependency it requires to run is .NET (in Windows) or Mono (in Linux, Unix or Mac OS X).
However, you may desire to compile libopenmv yourself. Compiling from source requires a Git client to acquire the code and Mono or Visual Studio/Visual C# Express to compile. More detailed instructions for different operating systems may be found below.
Specific information may be found in the libopenmv documentation. Additionally, it may be useful to consult the source code of a specific application.
Finally, if you have any questions or would like to chat with members of the libopenmv community, feel free to join us on IRC in the #libomv channel on EFnet.
##Linux/OSX
###Installing Mono
Follow the instructions on http://www.mono-project.com/ to install Mono on your platform. It is recommended to use the most recent version of Mono, and libopenmv may not run with versions prior to Mono 2.4.
You will also need to install nant from nant-0.86-beta1-src.tar.gz. Please note that many distributions bundle nant 0.85, and building libomv with it will not work.
Download the libopenmv source from Subversion by opening a terminal and typing:
$ git clone https://github.com/openmetaversefoundation/libopenmetaverse
Compile Libopenmv by returning to your terminal and typing:
$ sh runprebuild.sh nant
Common Build error:
The current runtime framework 'mono-2.0' is not correctly configured in the NAnt configuration file. Unable to locate 'mono' module using pkg-config. Download the Mono development packages from http://www.mono-project.com/downloads/.
This is probably due to missing glib2-devel packages, you can confirm this with
$ pkg-config --modversion mono
Common Build error:
The type or namespace name Windows' does not exist in the namespace System'. Are you missing an assembly reference?
This is probably due to missing package libmono-winforms2.0-cil
Common build error:
[: 12: xnant: unexpected operator [: 17: xnant: unexpected operator [: 28: xnant: unexpected operator
This may mean that the shell script did not fully complete, you must run nant manually:
$ nant
libopenmv is written in C#, using .Net/Mono. This means that it is not possible to simply execute the tools independently from the command line as you would with a regular Linux application.
However, assuming you compiled libopenmv yourself, you already have everything that is needed to run the tools from the command line. (If you wish to use the graphical tools, you must install X11.)
In your command prompt, type:
$ mono whicheverprogram.exe
libopenmv is written in C# using Microsoft .NET. Most recent installations of Windows include the .NET runtime and all dependencies necessary to use libopenmv. Therefore, to use libopenmv, you may simply download a set of pre-built binaries from Builds and launch a given application from the Command Prompt. If you desire to build libopenmv yourself, you may follow the instructions below.
###How to compile libopenmv
- Microsoft Visual Studio 2013 Community
- A Git Client like SourceTree or the native GitHub client
-
Download Microsoft Visual Studio 2013 (https://www.visualstudio.com/en-us/news/vs2013-community-vs.aspx) and install it
-
Download and install a Git client.
-
Use your favorite Git client to clone the repository or use the Git Shell command $ git clone https://github.com/openmetaversefoundation/libopenmetaverse
-
Run one of the prebuilds specific for your Visual Studio version and a OpenMetaverse.sln will appear
-
Click on the OpenMetaverse.sln to open it in Visual Studio and hit F6 to compile and run it.
The library, example applications and tools will be in the bin directory