<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY appversion "2.2.2">
  <!ENTITY manrevision "2.5">
  <!ENTITY date "June 2010">
  <!ENTITY app "GStreamer Properties">
]>
<!-- 
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.gnome.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Apr 11, 2002
  
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
    <title>&app; Manual V&manrevision;</title>       

    <copyright>
      <year>2003</year> 
      <holder>Christian Fredrik Kalager Schaller</holder> 
    </copyright> 

    <abstract role="description">
      <para>&app; lets you configure parameters related to the hardware and multimedia</para>
    </abstract>

<!-- translators: uncomment this:

  <copyright>
   <year>2003</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>

   -->
    <publisher> 
      <publishername> GNOME Documentation Project </publishername> 
    </publisher> 

   &legal;

    <authorgroup> 
      <author role="maintainer"> 
	<firstname>Christian Fredrik</firstname> 
	<surname>Kalager Schaller</surname> 
	<affiliation> 
	  <orgname>gnome.org</orgname> 
	  <address></address> 
	</affiliation> 
      </author> 

<!-- This is appropriate place for other contributors: translators,
      maintainers,  etc. Commented out by default.
       <othercredit role="translator">
	<firstname>Latin</firstname> 
	<surname>Translator 1</surname> 
	<affiliation> 
	  <orgname>Latin Translation Team</orgname> 
	  <address> <email>translator@gnome.org</email> </address> 
	</affiliation>
	<contrib>Latin translation</contrib>
      </othercredit>
-->
    </authorgroup>

    <revhistory>
      <revision> 
			<revnumber>&app; Manual V&manrevision;</revnumber> 
			<date>&date;</date> 
			<revdescription> 
	  			<para role="author">Marc-Andre Lureau</para>
	  			<para role="publisher">GNOME Documentation Project</para>
			</revdescription> 
      </revision>
      <revision> 
			<revnumber>&app; Manual V2.4</revnumber> 
			<date>December 2003</date> 
			<revdescription> 
	  			<para role="author">Christian Fredrik Kalager Schaller</para>
	  			<para role="publisher">GNOME Documentation Project</para>
			</revdescription> 
      </revision>
      <revision> 
			<revnumber>GStreamer Properties Manual V1.0</revnumber> 
			<date>September 2003</date> 
			<revdescription> 
	  			<para role="author">Christian Fredrik Kalager Schaller</para>
	  			<para role="publisher">GNOME Documentation Project</para>
			</revdescription> 
      </revision>
         </revhistory> 

    <releaseinfo>This manual describes version &appversion; of &app;.
    </releaseinfo> 
    <legalnotice> 
      <title>Feedback</title> 
      <para>To report a bug or make a suggestion regarding the &app; application or
	this manual, follow the directions in the 
	<ulink url="ghelp:gnome-feedback"
	  type="help">GNOME Feedback Page</ulink>. 
      </para>
<!-- Translators may also add here feedback address for translations -->
    </legalnotice> 
  </articleinfo> 

  <indexterm> 
    <primary>GStreamer properties</primary> 
  </indexterm> 

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->

  <sect1 id="gstreamer-properties-introduction"> 
    <title>Introduction</title> 
    <para>The <application>&app;</application> application enables you
    to configure parameters related to the hardware and multimedia
    systems on your system.</para>
    <note><para>Only advanced users should normally need
    this as your OS vendor should be shipping the system with the
    correct defaults.</para></note>
  </sect1>

  <sect1 id="gstreamer-properties-getting-started">
    <title>Getting Started</title> 

    <para>You can start <application>&app;</application> in the following ways:
    </para> 
    <variablelist>
    	<varlistentry>
    		<term><guimenu>Applications</guimenu> menu</term>
    		<listitem>
    		<para>Choose <menuchoice><guisubmenu>Preferences</guisubmenu>
			<guimenuitem>Gstreamer Properties</guimenuitem></menuchoice>.</para>
    		</listitem>
    	</varlistentry>
    	<varlistentry>
    		<term>Command line</term>
    		<listitem>
    		<para>Type <command>gstreamer-properties</command>, then press <keycap>Return</keycap>.</para>
    		<para> 		 
    		</para> 
    		</listitem>
    	</varlistentry>
    </variablelist>

    <para>When you start <application>&app;</application>, the following window is displayed.</para>

    <!-- ==== Figure ==== -->
      <figure id="gstreamer-properties-fig"> 
	<title>&app; Window</title> 
	<screenshot> 
	  <mediaobject> 
	    <imageobject>
	    <imagedata fileref="figures/gstreamer_properties_window.png" format="PNG"/> 
	    </imageobject>
	    <textobject> 
	      <phrase>Shows &app; main window. Contains menubar, toolbar, drop-down menus for the input and output audio options. </phrase> 
	    </textobject> 
	  </mediaobject> 
	</screenshot> 
      </figure>
    <!-- ==== End of Figure ==== -->

  </sect1>

<!-- ================ Usage ================================ -->

  <sect1 id="gstreamer-properties-usage"> 
    <title>Usage</title>
	<para>The GStreamer properties applet offers four drop down
	menus spread over two tabs.  There are two drop-menues for
	audio and two for video. These choices set the default for
	most GNOME applications for output and input of Sound and
	Video.</para>

    <sect2 id="gstreamer-properties-concepts">
    	<title>Understanding the menu options</title>

    	<para>Looking at the screen for setting audio options you
    	notice that the two sections are called Default Sink and
    	Default Source. These are terms used in the GStreamer
    	framework that GNOME uses to describe where data is sent and
    	where it comes from. The Default sink is in other words where
    	GNOME apps should output their sound, while Default source is
    	where the sound comes from.</para>

	<para>The reason you might want to alter these settings is
	because under Unix there are many different audio systems and
	sound server which you might want to output to. For instance
	on Linux popular alternatives are the PulseAudio sound server
	or ALSA.</para>

	<para>If you wish that your GNOME applcations output their
	sound to the PulseAudio sound server you set the Default Sink
	to use PulseAudio. And if you wish that your GNOME
	applications which has sound recording capabilities use the
	ALSA sound system, choose ALSA as the Default Source.</para>

	<note><para>As mentioned elsewhere in this user guide. These setting
	are meant for as a tool for advanced users who have
	specialized need. As an ordinary user, you should not need to
	set these as the vendor of your distribution should have set
	them to sensible defaults for you.
        </para></note>
    	
    </sect2>
  </sect1>  


</article>
