1-- What is libvisual -- 2Libvisual is a library that acts as a middle layer between 3applications that want audio visualisation and audio visualisation 4plugins. 5 6Libvisual is aimed at developers who, have a need for audio 7visualisation and those who actually write the visualisation 8plugins. 9 10By writing an audio visualisation plugin for libvisual 11every application that uses libvisual is capable of using 12this plugin. The application handles the end drawing of 13the graphics and thus rendering done by plugins using 14libvisual can be drawn everywhere. That is but not limited 15to: ascii art, sdl, on gl object as a surface , alpha blended 16or just, anywhere. 17 18Libvisual also provides complete easy to use transparant 19depth transformation, so that even when the display 20isn't supported by the plugin, libvisual will make 21it suite. Besides using libvisual for rendering your 222d buffers, you can also render openGL when an openGL 23context is open. Besides you don't have to render 24to a buffer. You can also make hardware hacks 25that do visualisation using libvisual. There are simply no borders 26 27 28-- Why should you use libvisual -- 29As an application writer, using libvisual provides you an easy 30way to do audio visualisation. Also when using libvisual you'll 31have easy access to all the plugins that are written for libvisual. 32 33As an plugin writer, libvisual provides a nice host for your plugin. 34It runs analyzes over the audio input for easy usage and it handles 35all the displaying stuff through the library and application. And 36mainly your plugin will be accessible to all the applications. 37 38 39-- License -- 40The libvisual library that is in libvisual/ is licensed under the LGPL. 41 42The example applications in examples/ are licensed under the GPL. 43 44The tests in tests/ are licensed under the GPL. 45 46 47-- Development -- 48If you'd like to use libvisual for your applications, write plugins 49or hack on the core. Please read HACKING. It contains some very 50useful information regarding to policies and such. 51 52 53-- Requirement -- 54The library is quite self containing and there is almost no depency 55at all to get it working. Libvisual it self does not depend on 56anything besides glibc ofcourse. 57 58Examples/Tests: To compile the examples and most tests libSDL is 59 required. 60 61 62-- Compiling and installing -- 63Configuration: 64 ./configure 65 To set a prefix use --prefix, other options can be seen by 66 using ./configure --help 67 68Building: 69 make 70 This will compile the library. 71 72 If you want to compile the examples, reconfigure the package 73 with --enable-examples AFTER installing the library. 74 75Installing: 76 make install 77 This will install the library. 78 79