Sophie

Sophie

distrib > Mageia > 7 > i586 > media > core-release > by-pkgid > 4f48f620eaa1d8b8f904a92a0540d40f > files > 1914

audaspace-doc-1.3.0-18.mga7.noarch.rpm

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.15"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Audaspace: Building and Installation</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  <td id="projectalign" style="padding-left: 0.5em;">
   <div id="projectname">Audaspace
   &#160;<span id="projectnumber">1.3.0</span>
   </div>
   <div id="projectbrief">A high level audio library.</div>
  </td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.15 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
var searchBox = new SearchBox("searchBox", "search",false,'Search');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
$(function() {
  initMenu('',true,false,'search.php','Search');
  $(document).ready(function() { init_search(); });
});
/* @license-end */</script>
<div id="main-nav"></div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
     onmouseover="return searchBox.OnSearchSelectShow()"
     onmouseout="return searchBox.OnSearchSelectHide()"
     onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0" 
        name="MSearchResults" id="MSearchResults">
</iframe>
</div>

</div><!-- top -->
<div class="PageDoc"><div class="header">
  <div class="headertitle">
<div class="title">Building and Installation </div>  </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p>This page describes how to build and install audaspace.</p>
<p>The build system used to build audaspace is CMake and it allows very building the library for very different application scenarios from a very general shared library build with plugins that is suitable for system wide installations to building everything into a single static library to be linked into a standalone program.</p>
<h2>Build Dependencies </h2>
<p>Audaspace is written in C++ 11 so a fairly recent compiler (g++ 4.8.2, clang 3.3, MSVC 2013) is needed to build it. The build system used is CMake and you need at least version 3.0. The following build dependencies are all optional, but without any it's neither possible to open sound files nor play back through the speakers. For windows a library folder called build-dependencies can be downloaded from <a href="https://github.com/audaspace/audaspace/releases">https://github.com/audaspace/audaspace/releases</a>.</p>
<ul>
<li>OpenAL (input/output device)</li>
<li>SDL (output device)</li>
<li>Jack (output device)</li>
<li>libsndfile (file access)</li>
<li>ffmpeg (file access)</li>
<li>Python (language binding, needs NumPy as well)</li>
</ul>
<h2>Getting the Code </h2>
<p>The audaspace source code or binary releases can be downloaded from <a href="https://github.com/audaspace/audaspace/releases">https://github.com/audaspace/audaspace/releases</a>.</p>
<p>For the most recent version you can use git to get the source code. </p><pre class="fragment">git clone https://github.com/audaspace/audaspace.git
</pre><h2>Plugins </h2>
<p>Before diving into the exact build steps for each platform, we will have a look at plugins. There are so far two types of plugins: input and output plugins. Input plugins are for reading audio files in many different formats and output plugins are for output devices on different platforms. During the configuration audaspace's standard plugins can be enabled with their repsective <code>WITH_*</code> and <code>PLUGIN_*</code> configuration option. Plugins are built as shared libraries. By default audaspace looks in the <code>DEFAULT_PLUGIN_PATH</code> for shared libraries it can load. Building with a dependency (<code>WITH_*</code>) but without enabling the respective <code>PLUGIN_*</code> option will compile the plugin directly into the library, so the plugin always gets loaded when the plugins are initialised.</p>
<h2>Building for Linux </h2>
<h3>Configuration</h3>
<p>It is highly recommended to build audaspace outside of the actual source code in a specific build directory. </p><pre class="fragment">mkdir build
cd build
</pre><p>Configuration is then either done interactively by using ccmake </p><pre class="fragment">ccmake ../audaspace
</pre><p><b>or</b> it can be done by defining variables directly during the run of cmake. </p><pre class="fragment">cmake ../build \
-DCMAKE_INSTALL_PREFIX:PATH=/usr \
-DCMAKE_BUILD_TYPE:STRING=Release \
-DBUILD_DEMOS:BOOL=TRUE \
-DSHARED_LIBRARY:BOOL=TRUE \
-DWITH_C:BOOL=TRUE \
-DWITH_FFMPEG:BOOL=TRUE \
-DWITH_JACK:BOOL=TRUE \
-DWITH_LIBSNDFILE:BOOL=TRUE \
-DWITH_OPENAL:BOOL=TRUE \
-DWITH_PYTHON:BOOL=TRUE \
-DWITH_SDL:BOOL=TRUE \
-DDEFAULT_PLUGIN_PATH:PATH=/usr/share/audaspace/plugins
</pre><p>This specific configuration is recommended for a system wide installation of audaspace where all build dependencies are required.</p>
<h3>Building</h3>
<p>After configuration the building is as easy as running </p><pre class="fragment">make
</pre><h3>Installation</h3>
<p>Installation is then also simple using </p><pre class="fragment">make install
</pre><h3>Using the library</h3>
<p>When audaspace is installed to the system, the required configuration for <em>pkgconfig</em> is also installed and pkgconfig can then be used to compile projects with audaspace.</p>
<p>It is also possible to build audaspace as a static library and use it directly in a project. For this the library has to be configured accordingly with ccmake and after building the resulting library file can be added to the project's build system.</p>
<h2>Building for Windows </h2>
<h3>Configuration</h3>
<p>Using cmake-gui select Visual Studio 2013 or 2015 for the architecture you want to build for and choose audaspace's source directory and a build directory. It is highly recommended to build audaspace outside of the source directory. During the first configuration cmake tries to find the dependencies. Dependencies that are not installed on the system are automatically disabled. To prevent this, enable <code>WITH_STRICT_DEPENDENCIES</code>. To use the build dependencies folder from the website, set the <code>LIBRARY_PATH</code> to point to the extracted directory. Also don't forget to set the <code>CMAKE_INSTALL_PREFIX</code> to a path where your user account can install to. Finally enable the dependencies that you want to use (<code>WITH_*</code>), configure and generate.</p>
<h3>Building</h3>
<p>Open the project in Visual Studio and set the configuration to Release. Then you can simply hit the build button.</p>
<h3>Installation</h3>
<p>To install audaspace to your target folder, build the INSTALL target. Note that if you don't use the libraries folder provided on the website, the INSTALL target might fail and you need to copy the files manually, including the dlls of the dependencies.</p>
<h3>Using the library</h3>
<p>To use audaspace in your project, configure the include path and the libraries that you need, which you can find in the include and lib directories in your installation path.</p>
<h3>Notes for plugins on windows</h3>
<ul>
<li><a class="el" href="classFFMPEG.html" title="This plugin class reads and writes sounds via ffmpeg.">FFMPEG</a>: Due to a problem with <a class="el" href="classFFMPEG.html" title="This plugin class reads and writes sounds via ffmpeg.">FFMPEG</a>'s 32 bit libraries, it is necessary to disable SAFESEH for the audffmpeg build target inside Visual Studio (Properties, Linker, Advanced). This has to be done after each generate step of CMake.</li>
<li>Jack: If no jack server is running on windows and your application or one of the demos tries to use the jack plugin, this adds a long delay to the device initialisation. In case you don't need jack, make sure to disable the plugin or for the prebuilt version of audaspace simply delete audjack.dll (and any files with jack in the name to clean up). </li>
</ul>
</div></div><!-- PageDoc -->
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by &#160;<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.15
</small></address>
</body>
</html>

Perl :: Catalyst :: PostgreSQL :: RPM Valid HTML 4.01 Transitional