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