ó
|
M\¬Qc @ sÖ d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d
|
Z
|
d Z d Z d Z d Z e e e e e e g Z d e f d YZ d Z d Z d d d YZ d d d YZ d d Z e Z d S( sÔ Stuff to parse Sun and NeXT audio files.
|
|
An audio file consists of a header followed by the data. The structure
|
of the header is as follows.
|
|
+---------------+
|
| magic word |
|
+---------------+
|
| header size |
|
+---------------+
|
| data size |
|
+---------------+
|
| encoding |
|
+---------------+
|
| sample rate |
|
+---------------+
|
| # of channels |
|
+---------------+
|
| info |
|
| |
|
+---------------+
|
|
The magic word consists of the 4 characters '.snd'. Apart from the
|
info field, all header fields are 4 bytes in size. They are all
|
32-bit unsigned integers encoded in big-endian byte order.
|
|
The header size really gives the start of the data.
|
The data size is the physical size of the data. From the other
|
parameters the number of frames can be calculated.
|
The encoding gives the way in which audio samples are encoded.
|
Possible values are listed below.
|
The info field currently consists of an ASCII string giving a
|
human-readable description of the audio file. The info field is
|
padded with NUL bytes to the header size.
|
|
Usage.
|
|
Reading audio files:
|
f = sunau.open(file, 'r')
|
where file is either the name of a file or an open file pointer.
|
The open file pointer must have methods read(), seek(), and close().
|
When the setpos() and rewind() methods are not used, the seek()
|
method is not necessary.
|
|
This returns an instance of a class with the following public methods:
|
getnchannels() -- returns number of audio channels (1 for
|
mono, 2 for stereo)
|
getsampwidth() -- returns sample width in bytes
|
getframerate() -- returns sampling frequency
|
getnframes() -- returns number of audio frames
|
getcomptype() -- returns compression type ('NONE' or 'ULAW')
|
getcompname() -- returns human-readable version of
|
compression type ('not compressed' matches 'NONE')
|
getparams() -- returns a tuple consisting of all of the
|
above in the above order
|
getmarkers() -- returns None (for compatibility with the
|
aifc module)
|
getmark(id) -- raises an error since the mark does not
|
exist (for compatibility with the aifc module)
|
readframes(n) -- returns at most n frames of audio
|
rewind() -- rewind to the beginning of the audio stream
|
setpos(pos) -- seek to the specified position
|
tell() -- return the current position
|
close() -- close the instance (make it unusable)
|
The position returned by tell() and the position given to setpos()
|
are compatible and have nothing to do with the actual position in the
|
file.
|
The close() method is called automatically when the class instance
|
is destroyed.
|
|
Writing audio files:
|
f = sunau.open(file, 'w')
|
where file is either the name of a file or an open file pointer.
|
The open file pointer must have methods write(), tell(), seek(), and
|
close().
|
|
This returns an instance of a class with the following public methods:
|
setnchannels(n) -- set the number of channels
|
setsampwidth(n) -- set the sample width
|
setframerate(n) -- set the frame rate
|
setnframes(n) -- set the number of frames
|
setcomptype(type, name)
|
-- set the compression type and the
|
human-readable compression type
|
setparams(tuple)-- set all parameters at once
|
tell() -- return current position in output file
|
writeframesraw(data)
|
-- write audio frames without pathing up the
|
file header
|
writeframes(data)
|
-- write audio frames and patch up the file header
|
close() -- patch up the file header and close the
|
output file
|
You should set the parameters before the first writeframesraw or
|
writeframes. The total number of frames does not need to be set,
|
but when it is set to the correct value, the header does not have to
|
be patched up.
|
It is best to first set all parameters, perhaps possibly the
|
compression type, and then write audio frames using writeframesraw.
|
When all frames have been written, either call writeframes('') or
|
close() to patch up the sizes in the header.
|
The close() method is called automatically when the class instance
|
is destroyed.
|
idns.i i i i i i i i i i i i l ÿÿ t Errorc B s e Z RS( ( t __name__t
|
__module__( ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyR s c C sY d } xL t d D]> } | j d } | d k r= t n | d t | } q W| S( Nl i i t i ( t ranget readt EOFErrort ord( t filet xt it byte( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt _read_u32 s c C s g } x? t d D]1 } t | d \ } } | j d | | } q Wx1 t d D]# } | j t t | | qU Wd S( Ni i i ( R t divmodt insertt writet chrt int( R R t dataR
|
t dt m( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt
|
_write_u32 s
|
t Au_readc B sª e Z d Z d Z d Z d Z d Z d Z d Z d Z d Z
|
d Z d
|
Z d Z d Z d Z d Z d Z d Z d Z RS( c C sJ t | t d k r9 d d l } | j | d } n | j | d S( NR iÿÿÿÿt rb( t typet __builtin__t opent initfp( t selft fR ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt __init__ s c C s | j r | j n d S( N( t _filet close( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt __del__ s c C sa | | _ d | _ t t | } | t k r< t d n t t | | _ | j d k rl t d n | j d k r t d n t | | _ | j t k rº t | j | _ n t t | | _ | j t
|
k rê t d n | j t t f k rd | _ d | _ n | j t k r6d | _ | _ no | j t k rXd | _ | _ nM | j t k rzd
|
| _ | _ n+ | j t k rd | _ | _ n t d t t | | _ t t | | _ | j | j | _ | j d k rT| j | j d | _ xP t t | j D]- } | j | d k r | j | | _ Pq q Wn d | _ d S( Ni s bad magic numberi s header size too smallid s header size ridiculously larges encoding not (yet) supportedi i i i s unknown encodingt R ( R t _soundposR R t AUDIO_FILE_MAGICR t _hdr_sizet
|
_data_sizet AUDIO_UNKNOWN_SIZEt _encodingt _simple_encodingst AUDIO_FILE_ENCODING_MULAW_8t AUDIO_FILE_ENCODING_ALAW_8t
|
_sampwidtht
|
_framesizet AUDIO_FILE_ENCODING_LINEAR_8t AUDIO_FILE_ENCODING_LINEAR_16t AUDIO_FILE_ENCODING_LINEAR_24t AUDIO_FILE_ENCODING_LINEAR_32t
|
_frameratet
|
_nchannelsR t _infoR t len( R R t magicR
|
( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyR ¤ sN c C s | j S( N( R ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt getfpÏ s c C s | j S( N( R3 ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt getnchannelsÒ s c C s | j S( N( R, ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt getsampwidthÕ s c C s | j S( N( R2 ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt getframerateØ s c C s4 | j t k r t S| j t k r0 | j | j Sd S( Ni ( R& R' R( R) R- ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt
|
getnframesÛ s
|
c C s. | j t k r d S| j t k r& d Sd Sd S( Nt ULAWt ALAWt NONE( R( R* R+ ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt getcomptypeâ s
|
c C s. | j t k r d S| j t k r& d Sd Sd S( Ns CCITT G.711 u-laws CCITT G.711 A-laws not compressed( R( R* R+ ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt getcompnameê s
|
c C s: | j | j | j | j | j | j f S( N( R8 R9 R: R; R? R@ ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt getparamsò s c C s d S( N( t None( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt
|
getmarkers÷ s c C s t d d S( Ns no marks( R ( R t id( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt getmarkú s c C s | j t k r | t k r- | j j } n | j j | | j | j } | j t k r d d l } | j | | j
|
} n | Sd S( Niÿÿÿÿ( R( R) R' R R R- R3 R* t audioopt ulaw2linR, RB ( R t nframesR RF ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt
|
readframesý s c C s d | _ | j j | j d S( Ni ( R# R t seekR% ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt rewind s c C s | j S( N( R# ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt tell s c C sU | d k s | | j k r* t d n | j j | | j | j | | _ d S( Ni s position not in range( R; R R RJ R- R% R# ( R t pos( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt setpos s c C s d | _ d S( N( RB R ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyR s ( R R R R! R R7 R8 R9 R: R; R? R@ RA RC RE RI RK RL RN R ( ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyR s$ + t Au_writec B s× e Z d Z d Z d Z d Z d Z d Z d Z d Z d Z
|
d Z d
|
Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z RS( c C sJ t | t d k r9 d d l } | j | d } n | j | d S( NR iÿÿÿÿt wb( R R R R ( R R R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyR s c C s | j r | j n d S( N( R R ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyR! ! s c C sg | | _ d | _ d | _ d | _ d | _ t | _ d | _ d | _ d | _ d | _
|
d | _ d S( Ni R R< ( R R2 R3 R, R- R' t _nframest _nframeswrittent _datawrittent _datalengthR4 t _comptype( R R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyR % s c C s: | j r t d n | d k r- t d n | | _ d S( Ns0 cannot change parameters after starting to writei i i s" only 1, 2, or 4 channels supported( i i i ( RR R R3 ( R t nchannels( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt setnchannels2 s
|
c C s | j s t d n | j S( Ns number of channels not set( R3 R ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyR8 9 s c C s: | j r t d n | d k r- t d n | | _ d S( Ns0 cannot change parameters after starting to writei i i s bad sample width( i i i ( RR R R, ( R t sampwidth( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt setsampwidth> s
|
c C s | j s t d n | j S( Ns sample width not specified( R2 R R, ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyR9 E s c C s" | j r t d n | | _ d S( Ns0 cannot change parameters after starting to write( RR R R2 ( R t framerate( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt setframerateJ s c C s | j s t d n | j S( Ns frame rate not set( R2 R ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyR: O s c C s: | j r t d n | d k r- t d n | | _ d S( Ns0 cannot change parameters after starting to writei s # of frames cannot be negative( RR R RQ ( R RH ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt
|
setnframesT s
|
c C s | j S( N( RR ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyR; [ s c C s% | d k r | | _ n t d d S( NR> R< s unknown compression type( s NONEs ULAW( RU R ( R R t name( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt setcomptype^ s c C s | j S( N( RU ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyR? d s c C s. | j d k r d S| j d k r& d Sd Sd S( NR< s CCITT G.711 u-lawR= s CCITT G.711 A-laws not compressed( RU ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyR@ g s
|
c C s` | \ } } } } } } | j | | j | | j | | j | | j | | d S( N( RW RY R[ R\ R^ ( R t paramsRV RX RZ RH t comptypet compname( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt setparamso s c C s: | j | j | j | j | j | j f S( N( R8 R9 R: R; R? R@ ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyRA w s c C s | j S( N( RR ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyRL | s c C s | j t | | j } | j d k rP d d l } | j | | j } n | j j | | j | | _ | j
|
t | | _
|
d S( NR< iÿÿÿÿ( t _ensure_header_writtenR5 R- RU RF t lin2ulawR, R R RR RS ( R R RH RF ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt writeframesraw s
|
c C sB | j | | j | j k s1 | j | j k r> | j n d S( N( Re RR RQ RT RS t _patchheader( R R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt writeframes s c C sU | j | j | j k s. | j | j k r; | j n | j j d | _ d S( N( Rc RR RQ RT RS Rf R t flushRB ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyR s
|
c C sY | j sU | j s t d n | j s3 t d n | j sH t d n | j n d S( Ns # of channels not specifieds sample width not specifieds frame rate not specified( RR R3 R R, R2 t _write_header( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyRc s c C s¯ | j d k r~ | j d k r0 t } d | _ q¨ | j d k rQ t } d | _ q¨ | j d k rr t } d | _ q¨ t d n* | j d k r t } d | _ n t d | j | j | _ t | j
|
t d t | j } | d d @} t | j
|
| | j t k rt } n | j | j } t | j
|
| | | _ t | j
|
| t | j
|
| j t | j
|
| j | j
|
j | j | j
|
j d | t | j d
|
d S( NR> i i i s internal errorR< i i R" i iøÿÿÿ( RU R, R. R- R/ R1 R R* R3 R R R$ R5 R4 RQ R' RT R2 R ( R t encodingt header_sizet length( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyRi ¥ s< c C sF | j j d t | j | j | j | _ | j j d d d S( Ni i i ( R RJ R RS RT ( R ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyRf È s ( R R R R! R RW R8 RY R9 R[ R: R\ R; R^ R? R@ Rb RA RL Re Rg R Rc Ri Rf ( ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyRO s.
|
|
#c C si | d k r0 t | d r' | j } q0 d } n | d k rF t | S| d k r\ t | St d d S( Nt modeR t rt wRP s$ mode must be 'r', 'rb', 'w', or 'wb'( Rn s rb( Ro s wb( RB t hasattrRm R RO R ( R Rm ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyR Î s
|
|
N( ( ( t __doc__R$ R* R. R/ R0 R1 t AUDIO_FILE_ENCODING_FLOATt AUDIO_FILE_ENCODING_DOUBLEt AUDIO_FILE_ENCODING_ADPCM_G721t AUDIO_FILE_ENCODING_ADPCM_G722t AUDIO_FILE_ENCODING_ADPCM_G723_3t AUDIO_FILE_ENCODING_ADPCM_G723_5R+ R' R) t ExceptionR R R R RO RB R t openfp( ( ( sM /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/sunau.pyt <module>h s6 µ
|
