===================================================================
RCS file: /cvsrepo/anoncvs/cvs/www/Attic/audio-port.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -c -r1.9 -r1.10
*** www/Attic/audio-port.html	2004/11/05 21:57:05	1.9
--- www/Attic/audio-port.html	2007/06/01 19:54:48	1.10
***************
*** 102,122 ****
    <p>
    This is about the smallest code fragment that will deal with most issues.
  
!   	<h3><font color="#0000e0">16 bit formats and endianess</font></h3>
  	In normal usage, you just ask for an encoding type (e.g.,
  	<code>AUDIO_ENCODING_SLINEAR</code>), and you retrieve
! 	an encoding with endianess (e.g., <code>AUDIO_ENCODING_SLINEAR_LE</code>).
! 	Considering that a soundcard does not have to use the same endianess
  	as your platform, you should be prepared to deal with that. 
  	The easiest way is probably to prepare a full audio buffer, and to use
! 	<code>swab(3)</code> if an endianess change is required. 
  	Dealing with external samples usually amounts to:
  	<ol>
  		<li>Parsing the sample format,
  		<li>Getting the sample in,
! 		<li>Swapping endianess if it is not your native format,
  		<li>Computing what you want to output into a buffer,
! 		<li>Swapping endianess if the sound card is not in your native format,
  		<li>Playing the buffer.
  	</ol>
  	Obviously, you may be able to remove steps 3 and 5 if you are simply
--- 102,122 ----
    <p>
    This is about the smallest code fragment that will deal with most issues.
  
!   	<h3><font color="#0000e0">16 bit formats and endianness</font></h3>
  	In normal usage, you just ask for an encoding type (e.g.,
  	<code>AUDIO_ENCODING_SLINEAR</code>), and you retrieve
! 	an encoding with endianness (e.g., <code>AUDIO_ENCODING_SLINEAR_LE</code>).
! 	Considering that a soundcard does not have to use the same endianness
  	as your platform, you should be prepared to deal with that. 
  	The easiest way is probably to prepare a full audio buffer, and to use
! 	<code>swab(3)</code> if an endianness change is required. 
  	Dealing with external samples usually amounts to:
  	<ol>
  		<li>Parsing the sample format,
  		<li>Getting the sample in,
! 		<li>Swapping endianness if it is not your native format,
  		<li>Computing what you want to output into a buffer,
! 		<li>Swapping endianness if the sound card is not in your native format,
  		<li>Playing the buffer.
  	</ol>
  	Obviously, you may be able to remove steps 3 and 5 if you are simply
***************
*** 271,276 ****
    <a href="porting.html"><img height=24 width=24 src=back.gif
     border=0 alt=Porting></a> 
    <a href="mailto:www@openbsd.org">www@openbsd.org</a>
! <br><small>$OpenBSD: audio-port.html,v 1.9 2004/11/05 21:57:05 saad Exp $</small>
   </body>
  </html>
--- 271,276 ----
    <a href="porting.html"><img height=24 width=24 src=back.gif
     border=0 alt=Porting></a> 
    <a href="mailto:www@openbsd.org">www@openbsd.org</a>
! <br><small>$OpenBSD: audio-port.html,v 1.10 2007/06/01 19:54:48 aanriot Exp $</small>
   </body>
  </html>