From: Thomas V. S. <tho...@us...> - 2002-10-26 15:18:16
|
CVS Root: /cvsroot/gstreamer Module: gstreamer Changes by: thomasvs Date: Sat Oct 26 2002 08:18:15 PDT Log message: add cvs section Modified files: docs/faq : cvs.xml gstreamer-faq.xml start.xml using.xml Links: http://cvs.sf.net/cgi-bin/viewcvs.cgi/gstreamer/gstreamer/docs/faq/cvs.xml.diff?r1=1.1&r2=1.2 http://cvs.sf.net/cgi-bin/viewcvs.cgi/gstreamer/gstreamer/docs/faq/gstreamer-faq.xml.diff?r1=1.1&r2=1.2 http://cvs.sf.net/cgi-bin/viewcvs.cgi/gstreamer/gstreamer/docs/faq/start.xml.diff?r1=1.1&r2=1.2 http://cvs.sf.net/cgi-bin/viewcvs.cgi/gstreamer/gstreamer/docs/faq/using.xml.diff?r1=1.2&r2=1.3 ====Begin Diffs==== Index: cvs.xml =================================================================== RCS file: /cvsroot/gstreamer/gstreamer/docs/faq/cvs.xml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -d -r1.1 -r1.2 --- cvs.xml 26 Oct 2002 15:16:12 -0000 1.1 +++ cvs.xml 26 Oct 2002 15:18:03 -0000 1.2 @@ -13,6 +13,7 @@ aclocal failed </programlisting> What's wrong ? + </para> </question> <answer> @@ -29,11 +30,11 @@ <para> You can do three things to fix this : <orderedlist> -<listitem>install automake in the same prefix as libtool +<listitem>install automake in the same prefix as libtool</listitem> <listitem>force use of the automake installed in the same prefix as libtool -by using the --with-automake option +by using the --with-automake option</listitem> <listitem>figure out what prefix libtool has been installed to and point -aclocal to the right location by running +aclocal to the right location by running</listitem> <programlisting> export ACLOCAL_FLAGS="-I $(prefix)/share/aclocal" </programlisting> Index: gstreamer-faq.xml =================================================================== RCS file: /cvsroot/gstreamer/gstreamer/docs/faq/gstreamer-faq.xml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -d -r1.1 -r1.2 --- gstreamer-faq.xml 19 Oct 2002 09:15:52 -0000 1.1 +++ gstreamer-faq.xml 26 Oct 2002 15:18:03 -0000 1.2 @@ -5,11 +5,14 @@ <!ENTITY START SYSTEM "start.xml"> <!ENTITY GENERAL SYSTEM "general.xml"> <!ENTITY DEPENDENCIES SYSTEM "dependencies.xml"> + <!ENTITY GETTING SYSTEM "getting.xml"> <!ENTITY USING SYSTEM "using.xml"> -<!ENTITY DEVELOPING SYSTEM "developing.xml"> <!ENTITY TROUBLESHOOTING SYSTEM "troubleshooting.xml"> +<!ENTITY CVS SYSTEM "cvs.xml"> +<!ENTITY DEVELOPING SYSTEM "developing.xml"> + ]> <article class="faq"> @@ -36,9 +39,12 @@ &START; &GENERAL; &DEPENDENCIES; + &GETTING; &USING; - &DEVELOPING; &TROUBLESHOOTING; + + &CVS; + &DEVELOPING; </article> Index: start.xml =================================================================== RCS file: /cvsroot/gstreamer/gstreamer/docs/faq/start.xml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -d -r1.1 -r1.2 --- start.xml 19 Oct 2002 09:15:52 -0000 1.1 +++ start.xml 26 Oct 2002 15:18:03 -0000 1.2 @@ -10,6 +10,10 @@ If you'd rather learn by trying it out, start with <xref linkend="title-getting" endterm="title-getting"/> </listitem> +<listitem> +If you want to live on the bleeding edge and develop and use CVS, see +<xref linkend="title-cvs" endterm="title-cvs"/> +</listitem> </itemizedlist> </para> </sect1> Index: using.xml =================================================================== RCS file: /cvsroot/gstreamer/gstreamer/docs/faq/using.xml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -d -r1.2 -r1.3 --- using.xml 24 Oct 2002 10:48:21 -0000 1.2 +++ using.xml 26 Oct 2002 15:18:03 -0000 1.3 @@ -3,8 +3,59 @@ <qandaset> <qandaentry> + <question id="using-getting-started"> + <para>Ok, I've installed GStreamer. What can I do next ?</para> + </question> + + <answer> + <para> +First of all, verify that you have a working registry and that you can +inspect them by typing +<programlisting> +$ gst-inspect fakesrc +</programlisting> +This should print out a bunch of information about this particular element. +If this tells you that there is "no such element or plugin", you haven't +installed GStreamer correctly. Please check +<link linkend="chapter-getting">how to get GStreamer</link> +If this fails with any other message, we would appreciate a +<link linkend="using-bugs-where">bug report</link>. + </para> + <para> +It's time to try out a few things. Start with gst-launch and two plug-ins +that you really should have : fakesrc and fakesink. They do nothing except +pass empty buffers. Type this at the command-line : +<programlisting> +$ gst-launch fakesrc num-buffers=3 ! fakesink +</programlisting> +This will print out output that looks similar to this : +<programlisting> +RUNNING pipeline +fakesrc0: last-message = "get ******* (fakesrc0:src)gt; (0 bytes, 0) 0x8057510" +fakesink0: last-message = "chain ******* (fakesink0:sink)lt; (0 bytes, 0) 0x8057510" +fakesrc0: last-message = "get ******* (fakesrc0:src)gt; (0 bytes, 1) 0x8057510" +fakesink0: last-message = "chain ******* (fakesink0:sink)lt; (0 bytes, 1) 0x8057510" +fakesrc0: last-message = "get ******* (fakesrc0:src)gt; (0 bytes, 2) 0x8057510" +fakesink0: last-message = "chain ******* (fakesink0:sink)lt; (0 bytes, 2) 0x8057510" +execution ended after 5 iterations (sum 301479000 ns, average 60295800 ns, min 3000 ns, max 105482000 ns) +</programlisting> +(Some parts of output have been removed for clarity) If it looks similar, then +GStreamer itself is running correctly. + </para> + <para> +After this, you might want to try and see if GStreamer can play audio on your +system. You need to combine two plug-ins for this test : sinesrc (which +produces a pure tone) and an audio output plug-in. You should choose one +that matches your current sound output and you should make sure you have +it installed. + </para> + + </answer> + </qandaentry> + + <qandaentry> <question id="using-gst-inspect"> - <para>How do I tell what GStreamer plugins I have on my system ?</para> + <para>How can I see what GStreamer plugins I have on my system ?</para> </question> <answer> |