Merge branch 'master' into 0.11
[platform/upstream/gstreamer.git] / tools / gst-visualise.1.in
1 .TH "GStreamer" "1" "February 2002" "" ""
2 .SH "NAME"
3 gst\-visualise \- Run a GStreamer pipeline to display an audio visualisation
4 .SH "SYNOPSIS"
5 \fBgst\-visualise\fR \fI[visualiser]\fR
6 .SH "DESCRIPTION"
7 .LP 
8 \fIgst\-visualise\fP is a tool that is used to run a basic \fIGStreamer\fP pipeline, to display a graphical visualisation of an audio stream.
9
10 By default, the audio stream is read from ESD (the Enlightened Sound Daemon),
11 but this can be changed by setting the AUDIOSRC parameter in ~/.gst.  For
12 example, you might set "AUDIOSRC=osssrc" to display a visualisation of the
13 sound input to your soundcard.
14
15 You can select a visualiser by providing a parameter naming the visualiser.
16 For example:
17
18  gst\-visualise synaesthesia
19
20 will use the synaesthesia plugin.  If no visualiser is named, the VISUALIZER
21 property in ~/.gst will be used.  If this is not specified either, the goom
22 visualiser will be used.
23
24 The videosink to use to display the visualisation will be read from the
25 VIDEOSINK parameter in ~/.gst, defaulting to sdlvideosink.
26
27 .SH "SEE ALSO"
28 .BR gst\-launch\-ext (1),
29 .BR gst\-inspect (1),
30 .BR gst\-launch (1),
31 .SH "AUTHOR"
32 The GStreamer team at http://gstreamer.net/