Navigation

← Previous Changeset
Next Changeset →

Changeset 20929

Timestamp:

11/18/07 13:05:25 (1 year ago)

Author:

patrick

Message:

Without SPROC support, there is no way to use AudioWorks?. Beyond that,
AudioWorks? seems to have disappeared long ago.

Files:

juggler/trunk/INSTALL.html (modified) (8 diffs)
juggler/trunk/INSTALL.txt (modified) (4 diffs)
juggler/trunk/doc/INSTALL.xml (modified) (4 diffs)
juggler/trunk/modules/sonix/ChangeLog (modified) (1 diff)
juggler/trunk/modules/sonix/plugins/AudioWorks (deleted)
juggler/trunk/modules/sonix/plugins/configure.ac (modified) (3 diffs)

Legend:

: Unmodified
: Added
: Removed
: Modified
: Copied
: Moved

juggler/trunk/INSTALL.html

r20738	r20929
1	1	<html><head>
2	2	<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
3		<title>Building and Installing the Juggler Project (Version 2.3)</title><link rel="stylesheet" href="base_style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="d0e1"></a>Building and Installing the Juggler Project (Version 2.3)</h2></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="othername">The Juggler Team</span></h3></div></div></div><div><p class="pubdate">$Date$</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#d0e15">Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e32">Important Notes for IRIX Users</a></span></dt><dt><span class="section"><a href="#d0e116">Important Note for Windows Users</a></span></dt></dl></dd><dt><span class="section"><a href="#d0e124">Build Tools</a></span></dt><dt><span class="section"><a href="#source.code.section">Getting the Source Code and the Dependencies</a></span></dt><dd><dl><dt><span class="section"><a href="#section.cvs.access">How to Get the Juggler Suite from Subversion</a></span></dt><dt><span class="section"><a href="#d0e250">Downloading Third-Party Dependencies</a></span></dt></dl></dd><dt><span class="section"><a href="#compile.section">Compiling</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e332">Important Note Regarding Compiling</a></span></dt><dt><span class="section"><a href="#d0e343">Compiling the Juggler Suite of Tools</a></span></dt><dt><span class="section"><a href="#compile.individual.section">Tips for Compiling Individual Tools in the Juggler
	3	<title>Building and Installing the Juggler Project (Version 2.3)</title><link rel="stylesheet" href="base_style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="d0e1"></a>Building and Installing the Juggler Project (Version 2.3)</h2></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="othername">The Juggler Team</span></h3></div></div></div><div><p class="pubdate">$Date$</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#d0e15">Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e32">Important Notes for IRIX Users</a></span></dt><dt><span class="section"><a href="#d0e116">Important Note for Windows Users</a></span></dt></dl></dd><dt><span class="section"><a href="#d0e124">Build Tools</a></span></dt><dt><span class="section"><a href="#source.code.section">Getting the Source Code and the Dependencies</a></span></dt><dd><dl><dt><span class="section"><a href="#section.cvs.access">How to Get the Juggler Suite from Subversion</a></span></dt><dt><span class="section"><a href="#d0e250">Downloading Third-Party Dependencies</a></span></dt></dl></dd><dt><span class="section"><a href="#compile.section">Compiling</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e332">Important Note Regarding Compiling</a></span></dt><dt><span class="section"><a href="#d0e343">Compiling the Juggler Suite of Tools</a></span></dt><dt><span class="section"><a href="#compile.individual.section">Tips for Compiling Individual Tools in the Juggler
4	4	Suite</a></span></dt></dl></dd></dl></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e15"></a>Introduction</h2></div></div></div><p>You have downloaded the source code for Version 2.3 of the Juggler
5	5	Project. This is the code that will become VR Juggler 3.0, and it is the
…	…
216	216	software. Sonix itself cannot play audio, but it includes
217	217	plug-ins based on popular interfaces for playing audio. Each
218		plug-in depends on a specific audio software library.</p><div class="itemizedlist"><ul type="disc"><li><p>VPR</p></li><li><p>GMTL 0.4.12</p></li></ul></div><div class="section" lang="en"><div class="titlepage"><div><div><h6 class="title"><a name="d0e475"></a>Sonix OpenAL Plug-in</h6></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Sonix</p></li><li><p>OpenAL</p></li><li><p>Free ALUT</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h6 class="title"><a name="d0e488"></a>Sonix Audiere Plug-in</h6></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Sonix</p></li><li><p>Audiere</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h6 class="title"><a name="d0e498"></a>Sonix AudioWorks Plug-in</h6></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Sonix</p></li><li><p>AudioWorks</p></li></ul></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e508"></a>Gadgeteer</h5></div></div></div><p>Gadgeteer handles all input devices that can be used by
219		VR Juggler applications.</p><div class="itemizedlist"><ul type="disc"><li><p>VPR</p></li><li><p>JCCL</p></li><li><p>GMTL 0.4.12</p></li><li><p>X Window System (non-Windows platforms)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e526"></a>Gadgeteer Device Driver Plug-ins</h5></div></div></div><p>The device driver plug-ins for Gadgeteer are independent
	218	plug-in depends on a specific audio software library.</p><div class="itemizedlist"><ul type="disc"><li><p>VPR</p></li><li><p>GMTL 0.4.12</p></li></ul></div><div class="section" lang="en"><div class="titlepage"><div><div><h6 class="title"><a name="d0e475"></a>Sonix OpenAL Plug-in</h6></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Sonix</p></li><li><p>OpenAL</p></li><li><p>Free ALUT</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h6 class="title"><a name="d0e488"></a>Sonix Audiere Plug-in</h6></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Sonix</p></li><li><p>Audiere</p></li></ul></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e498"></a>Gadgeteer</h5></div></div></div><p>Gadgeteer handles all input devices that can be used by
	219	VR Juggler applications.</p><div class="itemizedlist"><ul type="disc"><li><p>VPR</p></li><li><p>JCCL</p></li><li><p>GMTL 0.4.12</p></li><li><p>X Window System (non-Windows platforms)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e516"></a>Gadgeteer Device Driver Plug-ins</h5></div></div></div><p>The device driver plug-ins for Gadgeteer are independent
220	220	components that are discovered and used at run time based on
221	221	the application configuration. Drivers with dependencies are
222	222	optional.</p><div class="itemizedlist"><ul type="disc"><li><p>Gadgeteer</p></li><li><p>VRPN 07.03 for the VRPN driver plug-in</p></li><li><p>TrackD API 4 for the TrackD API driver
223	223	plug-in</p></li><li><p>Microsoft Speech API for the MS Speech API driver
224		plug-in</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e544"></a>Gadgeteer Cluster Plug-ins</h5></div></div></div><p>The cluster plug-ins extend the functionality of the
225		clustering infrastructure built into Gadgeteer.</p><div class="itemizedlist"><ul type="disc"><li><p>Gadgeteer</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e553"></a>VR Juggler</h5></div></div></div><p>The VR Juggler module is the unifying piece that pulls
	224	plug-in</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e534"></a>Gadgeteer Cluster Plug-ins</h5></div></div></div><p>The cluster plug-ins extend the functionality of the
	225	clustering infrastructure built into Gadgeteer.</p><div class="itemizedlist"><ul type="disc"><li><p>Gadgeteer</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e543"></a>VR Juggler</h5></div></div></div><p>The VR Juggler module is the unifying piece that pulls
226	226	all the other Juggler modules together. It provides a virtual
227	227	platform for VR application development. Real-time rendering is
…	…
229	229	is optional.</p><div class="itemizedlist"><ul type="disc"><li><p>Gadgeteer</p></li><li><p>Sonix</p></li><li><p>OpenGL</p></li><li><p>OpenGL Performer for the
230	230	<span class="emphasis"><em>optional</em></span> OpenGL Performer Draw
231		Manager</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e574"></a>VR Juggler Run-Time Performance Monitoring Plug-in
	231	Manager</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e564"></a>VR Juggler Run-Time Performance Monitoring Plug-in
232	232	(C++)</h5></div></div></div><p>The C++ VR Juggler Run-Time Performance Monitoring
233	233	Plug-in provides an optional extension to VR Juggler for remote
234	234	visualization of performance metrics that are captured while
235	235	running a VR Juggler application. Communication is performed
236		using the Tweek C++ API on top of CORBA.</p><div class="itemizedlist"><ul type="disc"><li><p>Tweek C++ API</p></li><li><p>VR Juggler</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e586"></a>VR Juggler Run-Time Performance Monitoring Plug-in
	236	using the Tweek C++ API on top of CORBA.</p><div class="itemizedlist"><ul type="disc"><li><p>Tweek C++ API</p></li><li><p>VR Juggler</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e576"></a>VR Juggler Run-Time Performance Monitoring Plug-in
237	237	(Java)</h5></div></div></div><p>The Java VR Juggler Run-Time Performance Monitoring
238	238	Plug-in is an optional extension that provides the features
…	…
241	241	another JavaBean handled by the Tweek JavaBean Loader, and it
242	242	uses CORBA to communicate with the C++ VR Juggler Run-Time
243		Performance Monitoring Plug-in.</p><div class="itemizedlist"><ul type="disc"><li><p>JCCL Java API</p></li><li><p>JFreeChart (included with Juggler source)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e598"></a>VRJConfig</h5></div></div></div><p>VRJConfig is the graphical editor for Juggler
	243	Performance Monitoring Plug-in.</p><div class="itemizedlist"><ul type="disc"><li><p>JCCL Java API</p></li><li><p>JFreeChart (included with Juggler source)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e588"></a>VRJConfig</h5></div></div></div><p>VRJConfig is the graphical editor for Juggler
244	244	configurations. It is a JavaBean loaded by the Tweek JavaBean
245	245	Loader, and it makes use of the editor Beans provided by the
246		JCCL Java API.</p><div class="itemizedlist"><ul type="disc"><li><p>JCCL Java API</p></li><li><p>JGraph (included with Juggler source)</p></li></ul></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e610"></a>Preparing Flagpoll</h4></div></div></div><p>The Flagpoll software has a default search path where it
	246	JCCL Java API.</p><div class="itemizedlist"><ul type="disc"><li><p>JCCL Java API</p></li><li><p>JGraph (included with Juggler source)</p></li></ul></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e600"></a>Preparing Flagpoll</h4></div></div></div><p>The Flagpoll software has a default search path where it
247	247	looks for <code class="filename">.pc</code> and <code class="filename">.fpc</code>
248	248	package metadata files. It searchs
…	…
356	356	when running <span class="command"><strong>configure.pl</strong></span>.</p></div></li></ol></div><p>By default, the configuration process will configure VR
357	357	Juggler and all of its dependencies. This includes Sonix, which
358		is an interesting special case. Sonix can make use of Audiere,
359		~~OpenAL, or AudioWorks to add sound to VR Juggler applications.~~
360		~~If none of those packages is found, Sonix will “<span class="quote">stub~~
361		~~out</span>” its sound APIs. This means that Sonix and the VR~~
362		~~Juggler Sound Manager can still be used in applications, but no~~
363		~~audio will be heard at run time. See <a class="xref" href="#sonix.compile.section" title="Sonix">the section called “Sonix”</a> for more information about~~
364		~~how to configure Sonix to use Audiere, OpenAL, or~~
365		Audi~~oWorks~~.</p><p>For example uses of <span class="command"><strong>configure.pl</strong></span>, take
	358	is an interesting special case. Sonix can make use of Audiere
	359	or OpenAL to add sound to VR Juggler applications. If none of
	360	those packages is found, Sonix will “<span class="quote">stub out</span>” its
	361	sound APIs. This means that Sonix and the VR Juggler Sound
	362	Manager can still be used in applications, but no audio will be
	363	heard at run time. See <a class="xref" href="#sonix.compile.section" title="Sonix">the section called “Sonix”</a>
	364	for more information about how to configure Sonix to use
	365	Audiere or OpenAL.</p><p>For example uses of <span class="command"><strong>configure.pl</strong></span>, take
366	366	a look at the Wiki page relating to building from source
367	367	(<a class="ulink" href="http://www.vrjuggler.org/twiki_public/bin/view/Juggler/BuildingFromSvn" target="_top">http://www.vrjuggler.org/twiki_public/bin/view/Juggler/BuildingFromSvn</a>).
…	…
370	370	has information on more advanced uses of
371	371	<span class="command"><strong>configure.pl</strong></span> that are beyond the scope of
372		this document.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e896"></a>Using Locally Installed Software</h5></div></div></div><p>As noted in <a class="xref" href="#source.code.section" title="Getting the Source Code and the Dependencies">the section called “Getting the Source Code and the Dependencies”</a>, VR
	372	this document.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e886"></a>Using Locally Installed Software</h5></div></div></div><p>As noted in <a class="xref" href="#source.code.section" title="Getting the Source Code and the Dependencies">the section called “Getting the Source Code and the Dependencies”</a>, VR
373	373	Juggler depends on several external software packages. As an
374	374	example, consider the case where the Boost libraries are
…	…
387	387	tools in the Juggler Suite are compiled correctly. For the most part,
388	388	this duplicates information that can be found on the Wiki page
389		relating to building from source (<a class="ulink" href="http://www.vrjuggler.org/twiki_public/bin/view/Juggler/BuildingFromSvn" target="_top">http://www.vrjuggler.org/twiki_public/bin/view/Juggler/BuildingFromSvn</a>).</p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="sonix.compile.section"></a>Sonix</h4></div></div></div><p>Sonix wraps other audio subsystems such as OpenAL (<a class="ulink" href="http://www.openal.org/" target="_top">www.openal.org</a>), Audiere
390		(<a class="ulink" href="http://audiere.sf.net/" target="_top">audiere.sf.net</a>), or
391		AudioWorks (<a class="ulink" href="http://www.multigen.com/" target="_top">multigen.com</a>). At least one
392		of these packages must be installed for use by Sonix in order to
393		hear sounds in VR Juggler applications. Once you have all the
394		necessary source code and third-party package installations, add
395		one or more of the following options to your
	389	relating to building from source (<a class="ulink" href="http://www.vrjuggler.org/twiki_public/bin/view/Juggler/BuildingFromSvn" target="_top">http://www.vrjuggler.org/twiki_public/bin/view/Juggler/BuildingFromSvn</a>).</p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="sonix.compile.section"></a>Sonix</h4></div></div></div><p>Sonix wraps other audio subsystems such as OpenAL (<a class="ulink" href="http://www.openal.org/" target="_top">www.openal.org</a>) or Audiere
	390	(<a class="ulink" href="http://audiere.sf.net/" target="_top">audiere.sf.net</a>). At
	391	least one of these packages must be installed for use by Sonix in
	392	order to hear sounds in VR Juggler applications. Once you have all
	393	the necessary source code and third-party package installations,
	394	add one or more of the following options to your
396	395	<span class="command"><strong>configure.pl</strong></span> command line to enable the
397	396	appropriate audio subsystem:</p><div class="itemizedlist"><ul type="disc"><li><p><code class="option">--enable-openal
…	…
403	402	of Audiere and tell the build where Audiere is installed.
404	403	The default search path is
405		<code class="filename">/usr/local</code>.</p></li><li><p><code class="option">--enable-audioworks
406		--with-audioworks=<AUDIOWORKS_PATH></code>: Enable
407		the use of AudioWorks and tell the build where AudioWorks is
408		installed. The default search path is
409		<code class="filename">/usr</code>.</p></li></ul></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>AudioWorks and OpenAL cannot be compiled together. They
410		depend on mutually exclusive VPR threading subsystems. Warnings
411		will be printed by the Sonix configure script indicating this
412		fact. OpenAL and Audiere can be compiled together,
413		however.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="tweek.build.section"></a>Tweek</h4></div></div></div><p>Tweek needs JDK 1.4 or newer and a C++ CORBA implementation.
	404	<code class="filename">/usr/local</code>.</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="tweek.build.section"></a>Tweek</h4></div></div></div><p>Tweek needs JDK 1.4 or newer and a C++ CORBA implementation.
414	405	Currently, we primarily use omniORB 4.0. Visit the <a class="ulink" href="http://omniorb.sourceforge.net/" target="_top">omniORB website</a> to
415	406	download omniORB.</p><p>For the following steps, assume that you have omniORB

juggler/trunk/INSTALL.txt

r20738	r20929
498	498
499	499	* Audiere
500
501
502
503		~~Sonix AudioWorks Plug-in~~
504
505
506		* Sonix
507
508		* AudioWorks
509	500
510	501
…	…
759	750	By default, the configuration process will configure VR Juggler and all of
760	751	its dependencies. This includes Sonix, which is an interesting special
761		case. Sonix can make use of Audiere~~, OpenAL, or AudioWorks to add sound to~~
762		~~VR Juggler applications. If none of those packages is found, Sonix will~~
763		~~"stub out" its sound APIs. This means that Sonix and the VR Juggler Sound~~
764		~~Manager can still be used in applications, but no audio will be heard at~~
765		~~run time. See the section called "Sonix" for more information about how~~ to
766		~~configure Sonix to use Audiere, OpenAL, or AudioWorks~~.
	752	case. Sonix can make use of Audiere or OpenAL to add sound to VR Juggler
	753	applications. If none of those packages is found, Sonix will "stub out" its
	754	sound APIs. This means that Sonix and the VR Juggler Sound Manager can still
	755	be used in applications, but no audio will be heard at run time. See the
	756	section called "Sonix" for more information about how to configure Sonix to
	757	use Audiere or OpenAL.
767	758
768	759	For example uses of configure.pl, take a look at the Wiki page relating to
…	…
818	809	Sonix
819	810
820		Sonix wraps other audio subsystems such as OpenAL (www.openal.org), Audiere
821		(audiere.sf.net), or AudioWorks (multigen.com). At least one of these
822		packages must be installed for use by Sonix in order to hear sounds in VR
823		Juggler applications. Once you have all the necessary source code and
824		third-party package installations, add one or more of the following options
825		to your configure.pl command line to enable the appropriate audio
826		subsystem:
	811	Sonix wraps other audio subsystems such as OpenAL (www.openal.org) or
	812	Audiere (audiere.sf.net). At least one of these packages must be installed
	813	for use by Sonix in order to hear sounds in VR Juggler applications. Once
	814	you have all the necessary source code and third-party package
	815	installations, add one or more of the following options to your
	816	configure.pl command line to enable the appropriate audio subsystem:
827	817
828	818
…	…
835	825	/usr/local.
836	826
837		* --enable-audioworks --with-audioworks=<AUDIOWORKS_PATH>: Enable the use
838		~~of AudioWorks and tell the build where AudioWorks is installed. The~~
839		~~default search path is /usr.~~
840
841
842
843		~~Note~~
844
845		~~AudioWorks and OpenAL cannot be compiled together. They depend on mutually~~
846		~~exclusive VPR threading subsystems. Warnings will be printed by the Sonix~~
847		~~configure script indicating this fact. OpenAL and Audiere can be compiled~~
848		~~together, however.~~
849	827
850	828

juggler/trunk/doc/INSTALL.xml

r20738	r20929
636	636	<listitem>
637	637	<para>Audiere</para>
638		~~</listitem>~~
639		~~</itemizedlist>~~
640		~~</section>~~
641
642		~~<section>~~
643		~~<title>Sonix AudioWorks Plug-in</title>~~
644
645		~~<itemizedlist>~~
646		~~<listitem>~~
647		~~<para>Sonix</para>~~
648		~~</listitem>~~
649
650		~~<listitem>~~
651		~~<para>AudioWorks</para>~~
652	638	</listitem>
653	639	</itemizedlist>
…	…
1012	998	<para>By default, the configuration process will configure VR
1013	999	Juggler and all of its dependencies. This includes Sonix, which
1014		is an interesting special case. Sonix can make use of Audiere,
1015		OpenAL, or AudioWorks to add sound to VR Juggler applications.
1016		If none of those packages is found, Sonix will <quote>stub
1017		out</quote> its sound APIs. This means that Sonix and the VR
1018		Juggler Sound Manager can still be used in applications, but no
1019		audio will be heard at run time. See <xref
1020		linkend="sonix.compile.section" /> for more information about
1021		how to configure Sonix to use Audiere, OpenAL, or
1022		AudioWorks.</para>
	1000	is an interesting special case. Sonix can make use of Audiere
	1001	or OpenAL to add sound to VR Juggler applications. If none of
	1002	those packages is found, Sonix will <quote>stub out</quote> its
	1003	sound APIs. This means that Sonix and the VR Juggler Sound
	1004	Manager can still be used in applications, but no audio will be
	1005	heard at run time. See <xref linkend="sonix.compile.section" />
	1006	for more information about how to configure Sonix to use
	1007	Audiere or OpenAL.</para>
1023	1008
1024	1009	<para>For example uses of <command>configure.pl</command>, take
…	…
1090	1075
1091	1076	<para>Sonix wraps other audio subsystems such as OpenAL (<ulink
1092		url="http://www.openal.org/">www.openal.org</ulink>), Audiere
1093		(<ulink url="http://audiere.sf.net/">audiere.sf.net</ulink>), or
1094		AudioWorks (<ulink
1095		url="http://www.multigen.com/">multigen.com</ulink>). At least one
1096		of these packages must be installed for use by Sonix in order to
1097		hear sounds in VR Juggler applications. Once you have all the
1098		necessary source code and third-party package installations, add
1099		one or more of the following options to your
	1077	url="http://www.openal.org/">www.openal.org</ulink>) or Audiere
	1078	(<ulink url="http://audiere.sf.net/">audiere.sf.net</ulink>). At
	1079	least one of these packages must be installed for use by Sonix in
	1080	order to hear sounds in VR Juggler applications. Once you have all
	1081	the necessary source code and third-party package installations,
	1082	add one or more of the following options to your
1100	1083	<command>configure.pl</command> command line to enable the
1101	1084	appropriate audio subsystem:</para>
…	…
1117	1100	<filename>/usr/local</filename>.</para>
1118	1101	</listitem>
1119
1120		~~<listitem>~~
1121		~~<para><option>--enable-audioworks~~
1122		~~--with-audioworks=<AUDIOWORKS_PATH></option>: Enable~~
1123		~~the use of AudioWorks and tell the build where AudioWorks is~~
1124		~~installed. The default search path is~~
1125		~~<filename>/usr</filename>.</para>~~
1126		~~</listitem>~~
1127	1102	</itemizedlist>
1128
1129		~~<note>~~
1130		~~<para>AudioWorks and OpenAL cannot be compiled together. They~~
1131		~~depend on mutually exclusive VPR threading subsystems. Warnings~~
1132		~~will be printed by the Sonix configure script indicating this~~
1133		~~fact. OpenAL and Audiere can be compiled together,~~
1134		~~however.</para>~~
1135		~~</note>~~
1136	1103	</section>
1137	1104

juggler/trunk/modules/sonix/ChangeLog

r20871	r20929
1	1	DATE AUTHOR CHANGE
2	2	----------- ----------- -------------------------------------------------------
	3	Nov-18-2007 patrick Removed the AudioWorks plug-in.
3	4	Sep-26-2007 patrick Added snx::sonix::shutdownAPI() so that user-level code
4	5	can control when the sound API is closed rather than

juggler/trunk/modules/sonix/plugins/configure.ac

r20865	r20929
60	60	[ --enable-subsynth Compile in Subsynth support [default=yes]],
61	61	[SUBSYNTH_ENABLED="$enableval"], [SUBSYNTH_ENABLED='yes'])
62
63		~~# does the user want AudioWorks?~~
64		~~AC_ARG_ENABLE(audioworks,~~
65		~~[ --enable-audioworks Compile in AudioWorks support [default=yes]],~~
66		~~[AUDIOWORKS_ENABLED="$enableval"], [AUDIOWORKS_ENABLED='yes'])~~
67	62
68	63	# does the user want Audiere?
…	…
157	152	else
158	153	AC_MSG_WARN([* Audiere connot be used with a VPR installation that ues SPROC threads. *])
159		fi
160		fi
161
162		~~# Test for AudioWorks.~~
163		~~HAVE_AUDIOWORKS='N'~~
164		~~if test "x$AUDIOWORKS_ENABLED" = "xyes" ; then~~
165		~~if test "x$VPR_SUBSYSTEM" = "xSPROC"; then~~
166		~~DPP_HAVE_AUDIOWORKS([/usr], [HAVE_AUDIOWORKS='Y'],~~
167		~~[AC_MSG_WARN([* AudioWorks plug-in cannot be built. *])])~~
168		~~else~~
169		~~AC_MSG_WARN([* AudioWorks cannot be used with a VPR installation that does not use SPROC threads. *])~~
170	154	fi
171	155	fi
…	…
382	366
383	367	AC_SUBST(HAVE_AUDIERE)
384		~~AC_SUBST(HAVE_AUDIOWORKS)~~
385	368	AC_SUBST(BUILD_OPENAL)
386	369	AC_SUBST(HAVE_SUBSYNTH)

Download in other formats: