From 2ae5d551c7b67fe5ff413e85d1e68eb1a063993a Mon Sep 17 00:00:00 2001 From: Hans-Christoph Steiner Date: Sat, 30 Jul 2011 20:40:34 +0000 Subject: added template-style README and LICENSE and purged cruft in prep for porting to the library template svn path=/trunk/externals/unauthorized/; revision=15171 --- README.txt | 301 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 301 insertions(+) create mode 100644 README.txt (limited to 'README.txt') diff --git a/README.txt b/README.txt new file mode 100644 index 0000000..c35e06e --- /dev/null +++ b/README.txt @@ -0,0 +1,301 @@ + +unauthorized is a library of GUI objects and a handful of objects for +working with streaming and mp3s. Its home page is here: + +http://puredata.info/community/projects/software/unauthorized + +unauthorized has split into two versions because of a change of +licensing. This version, maintained in the pure-data SVN, remains GPLv2 +while the original author Yves Degoyon has split off a version with a +non-free license. + +To get the new non-free version, download it from its new CVS repository: + + export CVSROOT=:pserver:anonymous at giss.tv:/home/cvs + cvs co pidip + cvs co unauthorized + +original sources available from http://ydegoyon.free.fr + +Installing +---------- + +there is no configure scripts, you need to install : + + * pd headers in /usr/include ( m_pd.h and g_canvas.h ) + * libmp3lame-dev for the mp3 externals + * libspeex-dev for the speex external + * sources of stk in /usr/src/stk for stk externals ( optional ) + +have fun! +sevy ( ydegoyon@gmail.com ) +Copyright 2002 Yves Degoyon + +Included Objects +------------- + +audience~ : 2-dimensional audience simulation ( also called 2 dollars spatialization !!! ) + +beatify~ : modulate amplitude of a sound + the idea was borrowed from musicscript, + an excellent sound generation tool. + ( http://musicscript.sourceforge.net, author : David Piott ) + +blinkenlight : a blinken lights films player ( but also a pixel grid ) + This object displays blinken lights movies, and lets you handle a + grid of pixels. It is also a "Telecran" !! There is a movies + archive @ http://www.blinkenlights.de/gallery/index.en.html + +compressor~ : a compressor of audio signals + +cooled : a micro sound editor + This object displays a sound, lets you play a part of it and do + some cut and paste operations. + +disto~ : a kind of effect used in pop music, use it elsewhere + the algorithm was taken from Digital Effects (DISTORT3), a guitar + effects software for DOS which rocks, written by Alexey Smoli + http://st.karelia.ru/~smlalx/ + +exciter : a bang-events sequencer + the need for it sprung out of a talking with Nicolas Lhommet. + +filterbank~ : filterbank outputs frequency response for a range of filters + +formant~ is a formant synthesis generator external for pd + +grid : 2-dimensional control object, ala "kaospad" + +mp3amp~ is a MPEG I Layer III (mp3) icecast/shoutcast client for Pure Data + mp3amp~ has been compiled for Linux using LAME 3.92. + The newest version of LAME can be found at sourceforge.net + + PLEASE NOTE: This software may contain patented alogrithm (at + least patented in some countries). It may be not allowed to + sell/use products based on this source code in these + countries. Check this out first! + + COPYRIGHT of MP3 music: Please note, that the duplicating of + copyrighted music without explicit permission violates the rights + of the owner. + + Using mp3amp~ external for Pure Data + + Open the help-mp3amp~.pd to understand how it works. Open the + help-graphic-mp3amp~.pd if you want to see the status of the + incoming stream. + + BUGS : + a/ certainly, not all bitrates will work, + that's too tedious to test, 128, 256, 320 are ok. + + b/ cannot instantiate more than 10 decoders, if needed change + MAX_DECODERS in the code + +mp3cast~ is a MPEG I Layer III (mp3) streaming external for pd (by Miller +Puckette) that connects to a SHOUTcast or IceCast server. + + Using mp3cast~ external for Pure Data + + Open the help-mp3cast~.pd to understand how it works. + In this patch, you must send the messages to mp3cast~ + in the following order : + + 1/ password ***** + 2/ icecast | mp3cast + 3/ connect host port + 4/ pd dsp 1 + + Parameters sent to mp3cast~ object : + + Sampling Rate (Hz): Possible values are 48000, 44100 and 32000. If + Pd runs at a different sampling rate, LAME will resample the + signal. Default value for mp3 sampling rate is Pd's sampling rate. + + Bitrate (kbit/s): Possible values are 32, 40, 48, 56, 64, 80, 96, + 112, 128, 160, 192, 224, 256 and 320. Default is 224. + + Mode: Possible values are 0 (stereo), 1 (joint stereo, the + default), 2 (dual channel) and 3 (mono). + + Password: The default is 'pd', can be changed with a message + "passwd yourpassword". + + Server: Use message "connect name_of_your_server.com port" to + connect (same as with Pd's netsend). 'port' is the number + specified in the server's config file. Attention (for SHOUTcast + users): The actual port number used is one higher! Standard would + be 8000 resulting in a socket at port 8001!!! Bare this in mind + when configuring proxys or using mp3cast~ in connection with + netsend / netreceive. For IceCast, the port number used is the + same as specified. + + Outlet: The outlet outputs an int, 1 if connected to SHOUTcast + server, 0 if not. This could be used to build an automatic + reconnect mechanism. + + Other things: mp3cast~ prints the current status (connection, + login, LAME status) to the pd window. To see the current settings, + send it a message "print" and mp3 settings will be displayed. + Note that changing any mp3 settings will require to disconnect and + reconnect again! This has to be done manually. + + Known problems: If you turn off audio processing when you are + connected with the server, no data will be sent to it. This will + make the server disconnect after a certain time ('no data' error + in server log). mp3cast~ does not recongnise this and attempts to + keep on streaming. To avoid this set 'AutoDumpSourceTime' in the + servers config file to a fairly high value preventing the server + from closing the socket to fast. + + ALLOWED QUALITY FACTOR : + + -q = 0...9. Default -q 5 + -q 0: Highest quality, very slow + -q 9: Poor quality, but fast + -h Same as -q 2. Recommended. + -f Same as -q 7. Fast, ok quality + + ALLOWED SAMPLERATE/BITRATES + + MPEG-1 layer III sample frequencies (kHz): 32 48 44.1 + bitrates (kbps): 32 40 48 56 64 80 96 112 128 160 192 224 256 320 + + MPEG-2 layer III sample frequencies (kHz): 16 24 22.05 + bitrates (kbps): 8 16 24 32 40 48 56 64 80 96 112 128 144 160 + + MPEG-2.5 layer III sample frequencies (kHz): 8 12 11.025 + bitrates (kbps): 8 16 24 32 40 48 56 64 80 96 112 128 144 160 + +mp3live~ is a peer-to-peer mp3 streamer package consisting of three + objects : mp3streamout~, mp3fileout~ and mp3streamin~. + + using mp3live~ external for Pure Data + + Open the mp3live~-help.pd to understand how it works. + + A note about MPEG encoding : + + ALLOWED QUALITY FACTOR : + + -q = 0...9. Default -q 5 + -q 0: Highest quality, very slow + -q 9: Poor quality, but fast + -h Same as -q 2. Recommended. + -f Same as -q 7. Fast, ok quality + + ALLOWED BITRATES : + + bitrates (kbps): 32 40 48 56 64 80 96 112 128 160 192 224 256 320 + + BUGS : + + 1. You cannot create more than MAX_DECODERS mp3streamin~ + objects. The actual value is 100. + + 2. Current version of lame ( 3.92 ) produces a lot of errors for + quality < 5. Blame it on lame !!!! + + 3. Mono is not supported. Some additional code should be added for + mp3streamin~. Blame it on me !!! + + 4. Resampling is not supported. Blame it on me !!! + +mp3write~ is a MPEG I Layer III (mp3) file writer. + + using mp3write~ external for Pure Data + + Open the help-mp3write~.pd to understand how it works. + In this patch, you must send the messages to mp3write~ + in the following order : + + 1/ append|truncate if you wish to change file creation options ( default is append ) + 2/ open /my/file + 3/ start + 5/ pd dsp 1 + 4/ stop : the tag is written at this stage + + Parameters sent to mp3write~ object : + + Sampling Rate (Hz): Possible values are 48000, 44100 and 32000. If + Pd runs at a different sampling rate, LAME will resample the + signal. Default value for mp3 sampling rate is Pd's sampling rate. + + Bitrate (kbit/s): Possible values are 32, 40, 48, 56, 64, 80, 96, + 112, 128, 160, 192, 224, 256 and 320. Default is 224. + + Mode: Possible values are 0 (stereo), 1 (joint stereo, the + default), 2 (dual channel) and 3 (mono). + + Outlet: The outlet outputs an int, which the number of bytes + written in this session. this might be different from file size + if you're using append mode. + + Known Problems : All combinations of samplerate, bitrate, quality + factor will not be accepted. + + ALLOWED QUALITY FACTOR : + + -q = 0...9. Default -q 5 + -q 0: Highest quality, very slow + -q 9: Poor quality, but fast + -h Same as -q 2. Recommended. + -f Same as -q 7. Fast, ok quality + + ALLOWED SAMPLERATE/BITRATES + + MPEG-1 layer III sample frequencies (kHz): 32 48 44.1 + bitrates (kbps): 32 40 48 56 64 80 96 112 128 160 192 224 256 320 + + MPEG-2 layer III sample frequencies (kHz): 16 24 22.05 + bitrates (kbps): 8 16 24 32 40 48 56 64 80 96 112 128 144 160 + + MPEG-2.5 layer III sample frequencies (kHz): 8 12 11.025 + bitrates (kbps): 8 16 24 32 40 48 56 64 80 96 112 128 144 160 + + Furthermore, it seems that high quality factors will not work with + this release of lame ( 3.92 ). The same errors can be obtained + with the command line : lame -q 1 file.wav outputs errors and + mp3write can't do better. + +pianoroll : a graphical sequencer controller + +playlist : choose a file in 1 click with space, numeric, characters + you can also send a seek message to select a file automatically. + +probalizer : outputs integer values according to a drawn probability curve + +samplebox~ : an opaque box to record and playback a sound ( with speed variations ) + +scratcher~ : records a sound and, then, let's you scratch it with your mouse. + +scrolllist : displays and scrolls a text in a patch window + +sonogram~ : displays, plays back and lets you modify a recorded sonogram. + + The real and imaginery part of an fft~ is stored in a sonogram~ + and, then, you can apply modifications to it or do mouse-based + graphic modifications. The set of modifications provided for now + consists of matrix operations but it will be improved soon. + +speex~ is a voice quality streamer using Speex library consisting of + two objects : speexin~ and speexout~. A big thanx to Jean-Marc + Valin, author of Speex who helped me fixing encoding/decoding + problems. + + PLEASE NOTE: The speex codec is patent free unlike GSM codecs. + that's the main reason why it's been choosen. ( + it allows very + low throughputs like 8kbits/s ). + +spigot~ : a signal router. + +vocoder~ : vocoder filter for PD inspired by xvox ( http://simon.morlat.free.fr ) +i used xvox version 0.2.1, but you don't need to install it, +everything needed is bundled here. + +wahwah~ : a kind of effect used in psychedelic music, use it elsewhere + + the algorithm was taken from Digital Effects, a guitar effects + software for DOS which rocks, written by Alexey Smoli ( + http://st.karelia.ru/~smlalx/ ) + -- cgit v1.2.1