diff src/sndarray.doc @ 711:48d403fff022

more doc updates from Dan Richter
author pygame
date Thu, 01 Jun 2006 07:00:27 +0000
parents 85f2ac863647
children
line wrap: on
line diff
--- a/src/sndarray.doc	Mon May 29 03:57:59 2006 +0000
+++ b/src/sndarray.doc	Thu Jun 01 07:00:27 2006 +0000
@@ -4,9 +4,13 @@
 Functions to convert between Numeric arrays and Sound objects. This
 module will only be available when pygame can use the external Numeric package.
 
-Sound data is made of thousands of samples per second. Each sample is an 8-bit
-or 16-bit integer, depending on the data format. A stereo sound file has two
-values per sample, while a mono sound file only has one.
+Sound data is made of thousands of samples per second, and each sample is the
+amplitude of the wave at a particular moment in time. For example, in
+22-kHz format, element number 5 of the array is the amplitude of the wave
+after 5/22000 seconds.
+
+Each sample is an 8-bit or 16-bit integer, depending on the data format.
+A stereo sound file has two values per sample, while a mono sound file only has one.
 
 Numeric does not use unsigned 16-bit integers; they will be converted to
 signed 16-bit arrays.