summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorathomas <[email protected]>2003-06-29 02:42:53 +0000
committerathomas <[email protected]>2003-06-29 02:42:53 +0000
commita6abfd2da66bb04739dcddf13d9dc382c1d1b831 (patch)
treede00ae87d5ee64951011fbddfa565e9d3ec3f60d
parent2425016110a5907103ad72bf8775c967399bff4c (diff)
set paragraph alignment to "justify"
git-svn-id: file:///home/mbien/NetBeansProjects/JOGAMP/joal-sync/svn-server-sync-demos/joal-demos/trunk@23 235fdd13-0e8c-4fed-b5ee-0a390d04b286
-rw-r--r--www/devmaster/lesson1.html172
-rw-r--r--www/devmaster/lesson2.html29
2 files changed, 104 insertions, 97 deletions
diff --git a/www/devmaster/lesson1.html b/www/devmaster/lesson1.html
index d01c159..69cab92 100644
--- a/www/devmaster/lesson1.html
+++ b/www/devmaster/lesson1.html
@@ -36,38 +36,39 @@ Source</font></span><font size="4"><br>
Maurais<br>
</font></a></span>Adapted for Java by: <a href="mailto:[email protected]"><font color="#888888">Athomas
Goldberg</font></a></p> </p>
- <p>Welcome to the exciting world of OpenAL! OpenAL
-is still in a stage of growth, and even though there is an ever larger following
-to the API it still hasn't reached it's full potential. One of the big reasons
-for this is that there is still not yet hardware acceleration built in for
-specific cards. However, Creative Labs is a major contributor to the OpenAL
-project and also happens to be one of the largest soundcard manufacturers. So
-there is a promise of hardware accelerated features in the near future. OpenAL's
-only other major contributor, Loki, has gone the way of the dinosaur. So the
-future of OpenAL on Linux platforms is uncertain. You can still obtain the Linux
-binaries on some more obscure websites.</p>
-<p>OpenAL has also not been seen in many major
-commercial products, which may have also hurt it's growth. As far as I know the
-only pc game to use OpenAL has been Metal Gear 2 (although recently I've
-discovered that Unreal 2 does as well). The popular modeling program, Blender3D,
-was also known to use OpenAL for all it's audio playback. Aside from these
-however the only other OpenAL uses have been in the sdk examples and a few
-obscure tutorials on the internet.</p>
-<p>But lets face it, OpenAL has a lot of
-potential. There are many other audio libraries that claim to work with the
-hardware on a lower level (and this may be true), but the designers of OpenAL
-did several things in it's design which make it a superior API. First of all
-they emulated the OpenGL API which is one of the best ever designed. The API
-style is flexible, so different coding methods and hardware implementations will
-take advantage of this. People who have had a lot of experience with OpenGL will
-be able to pick up OpenAL quite fast. OpenAL also has the advantage of creating
-3D surround sound which a lot of other API's cannot boast. On top of all of that
-it also has the ability to extend itself into EAX and AC3 flawlessly. To my
-knowledge no other audio library has that capability.</p>
-<p>If you still haven't found a reason here to use
-OpenAL then here's another. It's just cool. It's a nice looking API and will
-integrate well into your code. You will be able to do many cool sound effects
-with it. But before we do that we have to learn the basics.</p>
+
+<p align="justify">Welcome to the exciting world of OpenAL! OpenAL is still in
+ a stage of growth, and even though there is an ever larger following to the
+ API it still hasn't reached it's full potential. One of the big reasons for
+ this is that there is still not yet hardware acceleration built in for specific
+ cards. However, Creative Labs is a major contributor to the OpenAL project and
+ also happens to be one of the largest soundcard manufacturers. So there is a
+ promise of hardware accelerated features in the near future. OpenAL's only other
+ major contributor, Loki, has gone the way of the dinosaur. So the future of
+ OpenAL on Linux platforms is uncertain. You can still obtain the Linux binaries
+ on some more obscure websites.</p>
+<p align="justify">OpenAL has also not been seen in many major commercial products,
+ which may have also hurt it's growth. As far as I know the only pc game to use
+ OpenAL has been Metal Gear 2 (although recently I've discovered that Unreal
+ 2 does as well). The popular modeling program, Blender3D, was also known to
+ use OpenAL for all it's audio playback. Aside from these however the only other
+ OpenAL uses have been in the sdk examples and a few obscure tutorials on the
+ internet.</p>
+<p align="justify">But lets face it, OpenAL has a lot of potential. There are
+ many other audio libraries that claim to work with the hardware on a lower level
+ (and this may be true), but the designers of OpenAL did several things in it's
+ design which make it a superior API. First of all they emulated the OpenGL API
+ which is one of the best ever designed. The API style is flexible, so different
+ coding methods and hardware implementations will take advantage of this. People
+ who have had a lot of experience with OpenGL will be able to pick up OpenAL
+ quite fast. OpenAL also has the advantage of creating 3D surround sound which
+ a lot of other API's cannot boast. On top of all of that it also has the ability
+ to extend itself into EAX and AC3 flawlessly. To my knowledge no other audio
+ library has that capability.</p>
+<p align="justify">If you still haven't found a reason here to use OpenAL then
+ here's another. It's just cool. It's a nice looking API and will integrate well
+ into your code. You will be able to do many cool sound effects with it. But
+ before we do that we have to learn the basics.</p>
<p>So let's get coding!</p>
<pre class=code><font color="#0000FF">import</font> net.java.games.joal.*;
@@ -84,19 +85,20 @@ with it. But before we do that we have to learn the basics.</p>
<span class=codeComment><font color="#006600"> // Sources are points emitting sound.</font></span>
<font color="#0000FF"> static int</font>[] source = <font color="#0000FF">new</font> <font color="#0000FF">int</font>[1];
</pre>
-<p>Those familiar with OpenGL know that it uses &quot;texture objects&quot; (or &quot;texture
-names&quot;) to handle textures used by a program. OpenAL does a similar thing with
-audio samples. There are essentially 3 kinds of objects in OpenAL. A buffer
-which stores all the information about how a sound should be played and the
-sound data itself, and a source which is a point in space that emits a sound.
-It's important to understand that a source is not itself an audio sample. A
-source only plays back sound data from a buffer bound to it. The source is also
-given special properties like position and velocity. </p>
-<p>The third object which I have not mentioned yet is the listener. There is
-only one listener which represents where 'you' are, the user. The listener
-properties along with the source properties determine how the audio sample will
-be heard. For example their relative positions will determine the intensity of
-the sound.</p>
+<p align="justify">Those familiar with OpenGL know that it uses &quot;texture
+ objects&quot; (or &quot;texture names&quot;) to handle textures used by a program.
+ OpenAL does a similar thing with audio samples. There are essentially 3 kinds
+ of objects in OpenAL. A buffer which stores all the information about how a
+ sound should be played and the sound data itself, and a source which is a point
+ in space that emits a sound. It's important to understand that a source is not
+ itself an audio sample. A source only plays back sound data from a buffer bound
+ to it. The source is also given special properties like position and velocity.
+</p>
+<p align="justify">The third object which I have not mentioned yet is the listener.
+ There is only one listener which represents where 'you' are, the user. The listener
+ properties along with the source properties determine how the audio sample will
+ be heard. For example their relative positions will determine the intensity
+ of the sound.</p>
<pre class=code>
<span class=codeComment><font color="#006600"> // Position of the source sound.</font></span>
@@ -115,10 +117,10 @@ the sound.</p>
<span class=codeComment><font color="#006600"> </font></span><font color="#0000FF">static float</font>[] listenerOri = { 0.0f, 0.0f, -1.0f, 0.0f, 1.0f, 0.0f };
</pre>
-<p>In the above code we specify the position and velocity of the source and listener
- objects. These arrays are vector based Cartesian coordinates. You could easily
- build a structure or class to do the same thing. In this example I used arrays
- for simplicity.</p>
+<p align="justify">In the above code we specify the position and velocity of the
+ source and listener objects. These arrays are vector based Cartesian coordinates.
+ You could easily build a structure or class to do the same thing. In this example
+ I used arrays for simplicity.</p>
<p>Here we will create a function that loads all of our sound data from a file.
</p>
<pre class=code><span class=codeComment><font color="#006600"> </font></span><font color="#0000FF">static int</font> LoadALData() {
@@ -136,15 +138,15 @@ the sound.</p>
<span class=codeComment><font color="#006600"> </font></span><span class=codeComment><font color="#006600"> </font></span>al.alBufferData(buffer[0], format[0], data[0], size[0], freq[0]);
<span class=codeComment><font color="#006600"> </font></span><span class=codeComment><font color="#006600"> </font></span>ALut.alutUnloadWAV(format[0],data[0],size[0],freq[0]);
</pre>
-<p>The function 'alGenBuffers' will create the buffer objects and store them in
-the variable we passed it. It's important to do an error check to make sure
-everything went smoothly. There may be a case in which OpenAL could not generate
-a buffer object due to a lack of memory. In this case it would set the error
-bit.</p>
-<p>The ALut is very helpful here. It opens up the file for us and gives us all
- the information we need to create the buffer. And after we have attached all
- this data to the buffer it will help use dispose of the data. It all works in
- a clean and efficient manner.</p>
+<p align="justify">The function 'alGenBuffers' will create the buffer objects
+ and store them in the variable we passed it. It's important to do an error check
+ to make sure everything went smoothly. There may be a case in which OpenAL could
+ not generate a buffer object due to a lack of memory. In this case it would
+ set the error bit.</p>
+<p align="justify">The ALut is very helpful here. It opens up the file for us
+ and gives us all the information we need to create the buffer. And after we
+ have attached all this data to the buffer it will help use dispose of the data.
+ It all works in a clean and efficient manner.</p>
<pre>
<span class=codeComment><font color="#006600"> </font></span><span class=codeComment><font color="#006600"> </font></span><font color="#006600">// Bind buffer with a source.</font>
@@ -159,17 +161,18 @@ bit.</p>
<span class=codeComment><font color="#006600"> </font></span> al.alSourcefv(source[0], AL.AL_POSITION, sourcePos);
<span class=codeComment><font color="#006600"> </font></span> al.alSourcefv(source[0], AL.AL_VELOCITY, sourceVel);
<span class=codeComment><font color="#006600"> </font></span> al.alSourcei (source[0], AL.AL_LOOPING, loop[0] );</pre>
-<p>We generate a source object in the same manner we generated the buffer object.
-Then we define the source properties that it will use when it's in playback. The
-most important of these properties is the buffer it should use. This tells the
-source which audio sample to playback. In this case we only have one so we bind
-it. We also tell the source it's position and velocity which we defined earlier.</p>
-<p>One more thing on 'alGenBuffers' and 'alGenSources'. In some example code I
-have seen these functions will return an integer value for the number of
-buffers/sources created. I suppose this was meant as an error checking feature
-that was left out in a later version. If you see this done in other code don't
-use it yourself. If you want to do this check, use 'alGetError' instead (like we
-have done above).</p>
+<p align="justify">We generate a source object in the same manner we generated
+ the buffer object. Then we define the source properties that it will use when
+ it's in playback. The most important of these properties is the buffer it should
+ use. This tells the source which audio sample to playback. In this case we only
+ have one so we bind it. We also tell the source it's position and velocity which
+ we defined earlier.</p>
+<p align="justify">One more thing on 'alGenBuffers' and 'alGenSources'. In some
+ example code I have seen these functions will return an integer value for the
+ number of buffers/sources created. I suppose this was meant as an error checking
+ feature that was left out in a later version. If you see this done in other
+ code don't use it yourself. If you want to do this check, use 'alGetError' instead
+ (like we have done above).</p>
<pre class=code>
<span class=codeComment><font color="#006600"> </font></span><span class=codeComment><font color="#006600"> </font></span><font color="#006600">// Do another error check and return.</font>
@@ -203,11 +206,11 @@ all the memory and audio devices that our program may be using.</p>
<span class=codeComment><font color="#006600"> </font></span><span class=codeComment><font color="#006600"> </font></span>al.alGetError();
</pre>
-<p>The function 'alutInit' will setup everything that the Alc needs to do for
-us. Basically Alut creates a single OpenAL context through Alc and sets it to
-current. On the Windows platform it initializes DirectSound. We also do an
-initial call to the error function to clear it. Every time we call 'glGetError'
-it will reset itself to 'AL_NO_ERROR'.</p>
+<p align="justify">The function 'alutInit' will setup everything that the Alc
+ needs to do for us. Basically Alut creates a single OpenAL context through Alc
+ and sets it to current. On the Windows platform it initializes DirectSound.
+ We also do an initial call to the error function to clear it. Every time we
+ call 'glGetError' it will reset itself to 'AL_NO_ERROR'.</p>
<pre class=code>
<span class=codeComment><font color="#006600"> </font><font color="#006600"> </font><font color="#006600">// Load the wav data.</font></span>
@@ -229,9 +232,9 @@ it will reset itself to 'AL_NO_ERROR'.</p>
<span class=codeComment><font color="#006600"> </font></span><span class=codeComment><font color="#006600"> </font></span><span class=codeComment><font color="#006600"> </font></span>)
<span class=codeComment><font color="#006600"> </font></span><span class=codeComment><font color="#006600"> </font></span>);
</pre>
-<p>We will check to see if the wav files loaded correctly. If not we must exit
-the program. Then we update the listener values, and finally we set our exit
-procedure.</p>
+<p align="justify">We will check to see if the wav files loaded correctly. If
+ not we must exit the program. Then we update the listener values, and finally
+ we set our exit procedure.</p>
<pre class=code><font color="#0000FF"> char</font>[] c = new <font color="#0000FF">char</font>[1];
<font color="#0000FF"> </font><font color="#0000FF"> while</font>(c[0] != 'q') {
<font color="#0000FF"> </font><font color="#0000FF"> </font><font color="#0000FF">try</font> {
@@ -261,13 +264,14 @@ procedure.</p>
}
</pre>
-<p>This is the interesting part of the tutorial. It's a very basic loop that
-lets us control the playback of the audio sample. Pressing 'p' will replay the
-sample, pressing 's' will stop the sample, and pressing 'h' will pause the
-sample. Pressing 'q' will exit the program.</p>
-<p>Well there it is. Your first delve into OpenAL. I hope it was made simple
-enough for you. It may have been a little too simple for the 1337 h4X0r, but we
-all got to start somewhere. Things will get more advanced as we go along.</p>
+<p align="justify">This is the interesting part of the tutorial. It's a very basic
+ loop that lets us control the playback of the audio sample. Pressing 'p' will
+ replay the sample, pressing 's' will stop the sample, and pressing 'h' will
+ pause the sample. Pressing 'q' will exit the program.</p>
+<p align="justify">Well there it is. Your first delve into OpenAL. I hope it was
+ made simple enough for you. It may have been a little too simple for the 1337
+ h4X0r, but we all got to start somewhere. Things will get more advanced as we
+ go along.</p>
<p> <a href="lesson1.zip">Download
the Java Source and Ant Build File</a></p>
<table border="0" cellspacing="1" style="border-collapse: collapse" width="100%" id="AutoNumber2" bgcolor="#666699">
diff --git a/www/devmaster/lesson2.html b/www/devmaster/lesson2.html
index a70ef71..68c05e1 100644
--- a/www/devmaster/lesson2.html
+++ b/www/devmaster/lesson2.html
@@ -37,7 +37,7 @@ Fade-away</font></span><font size="4"><br>
Maurais<br>
</font></a></span><span class="author">Adapted for Java By: <a href="mailto:[email protected]"><font color="#888888">Athomas
Goldberg </font></a> </span></p>
-<p>Hope you found the last tutorial of some use. I know I did. This will be a
+<p align="jusify">Hope you found the last tutorial of some use. I know I did. This will be a
real quick and easy tutorial. It won't get too much more complicated at this
point.</p>
<pre >
@@ -58,8 +58,9 @@ point.</p>
<font color="#0000FF">static</font> <font color="#0000FF">float</font>[] listenerOri = { 0.0f, 0.0f, -1.0f, 0.0f, 1.0f, 0.0f };
<font color="#0000FF">static</font> AL al;
<font color="#0000FF">static</font> ALC alc;</p></pre>
-<p>There is only one change in the code since the last tutorial in this fist
-section. It is that we altered the sources velocity. It's 'z' field is now 0.1.</p>
+<p align="justify">There is only one change in the code since the last tutorial
+ in this fist section. It is that we altered the sources velocity. It's 'z' field
+ is now 0.1.</p>
<pre class=code>
<font color="#0000FF">static</font> <font color="#0000FF">int</font> loadALData() {
<font color="#0000FF">if</font> (al.alGetError() != AL.AL_NO_ERROR) {
@@ -99,10 +100,11 @@ section. It is that we altered the sources velocity. It's 'z' field is now 0.1.<
}
<font color="#0000FF">return</font> AL.AL_TRUE;
}</pre>
-<p>Two changes in this section. First we are loading the file &quot;Footsteps.wav&quot;.
- We are also explicitly setting the sources 'AL_LOOPING' value to 'AL_TRUE'.
- What this means is that when the source is prompted to play it will continue
- to play until stopped. It will play over again after the sound clip has ended.</p>
+<p align="justify">Two changes in this section. First we are loading the file
+ &quot;Footsteps.wav&quot;. We are also explicitly setting the sources 'AL_LOOPING'
+ value to 'AL_TRUE'. What this means is that when the source is prompted to play
+ it will continue to play until stopped. It will play over again after the sound
+ clip has ended.</p>
<pre class=code>
<font color="#0000FF">static <span class=codeKeyword>void</span> </font>setListenerValues() {
al.alListenerfv(AL.AL_POSITION, listenerPos);
@@ -149,12 +151,13 @@ section. It is that we altered the sources velocity. It's 'z' field is now 0.1.<
ALut.alutExit();
}
}</pre>
-<p>The only thing that has changed in this code is the loop. Instead of playing
-and stopping the audio sample it will slowly get quieter as the sources position
-grows more distant. We do this by slowly incrementing the position by it's
-velocity over time. The time is sampled by checking the system clock which gives
-us a tick count. It shouldn't be necessary to change this, but if the audio clip
-fades too fast you might want to change 100 to some higher number. </p>
+<p align="justify">The only thing that has changed in this code is the loop. Instead
+ of playing and stopping the audio sample it will slowly get quieter as the sources
+ position grows more distant. We do this by slowly incrementing the position
+ by it's velocity over time. The time is sampled by checking the system clock
+ which gives us a tick count. It shouldn't be necessary to change this, but if
+ the audio clip fades too fast you might want to change 100 to some higher number.
+</p>
<p><a href="lesson2.zip">Download the Java
Source and Ant Build file.</a></p>
<table border="0" cellspacing="1" style="border-collapse: collapse" width="100%" id="AutoNumber2" bgcolor="#666699">