Bugs item #1169212, was opened at 2005-03-23 11:10 Message generated for change (Comment added) made by gward You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1169212&group_id=5470
Category: Documentation Group: Python 2.4 >Status: Closed >Resolution: Fixed Priority: 5 Submitted By: hiower (hiower) Assigned to: Greg Ward (gward) Summary: small change in ossaudiodev module doc. Initial Comment: from http://docs.python.org/lib/ossaudio-device-objects.html: AFMT_U8 Unsigned, 8-bit audio AFMT_S16_LE Unsigned, 16-bit audio, little-endian byte order (as used by Intel processors) AFMT_S16_BE Unsigned, 16-bit audio, big-endian byte order (as used by 68k, PowerPC, Sparc) AFMT_S8 Signed, 8 bit audio AFMT_U16_LE Signed, 16-bit little-endian audio AFMT_U16_BE Signed, 16-bit big-endian audio Note how the U:s and S:s are switched compared to signed and unsigned, this should surely not be like this? Perhaps AFMT_AC3 and AFMT_S16_NE should be included as well? (if anyone uses it?) also, maybe this line: write( data) Write the Python string data to the audio device and return the number of bytes written. could be subtituted with something like this: write( data) Write the Python data to the audio device and return the number of bytes written. The data should be a string or a list (of amplitude values...something) ---------------------------------------------------------------------- >Comment By: Greg Ward (gward) Date: 2005-03-27 21:41 Message: Logged In: YES user_id=14422 Oops, good catch on the signed/unsigned thing. Thanks! Fixed on release24-maint branch: Doc/lib/libossaudiodev.tex rev 1.12.4.4. Merged to trunk: Doc/lib/libossaudiodev.tex rev 1.15. As for explaining the write() method: the ossaudiodev docs are no place for a tutorial on audio encoding formats. If it's not immediately obvious what the string passed to write() should be, the reader should consult OSS docs. Hmmm... since AFMT_S16_NE may be defined by ossaudiodev, but AFMT_U16_NE is not, I'll just leave the missing AFMT_*'s out of the 2.4 docs and straighten things out on the trunk (for 2.5). Specifically, I'll make ossaudiodev conditionally define all AFMT_* macros currently documented by OSS. Won't bother adding everything to the docs, since the OSS ref should be definitive. ---------------------------------------------------------------------- You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1169212&group_id=5470 _______________________________________________ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
