Debian Codegraph @

README

raw
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