<?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.4">
  <!ENTITY date "September 2003">
  <!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">Christian Fredrik Kalager Schaller</para>
	  			<para role="publisher">GNOME Documentation Project</para>
			</revdescription> 
      </revision>
      <revision> 
			<revnumber>GStreamer Properties Manual V1.0</revnumber> 
			<date>December 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. Only advanced users should normally need this as your OS vendor should be shipping the system with the correct defaults.</para> 
  </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 capplet 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 		says 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	
	for instance on Linux popular alternatives are the OSS sound system, the ALSA sound 
	system, the ESD sound server and the ARTSd sound server.</para>
	<para>For instance if you wish that your GNOME applcations output their sound to the 
	ESD sound server you set the Default Sink to use ESD. And if you wish that your GNOME 
	applications which has sound recording capabilities use the OSS sound system to do this 
	you choose OSS as the Default Source.</para>
	<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 of Linux or Unix should have set them 
	for you and sensible defaults.</para> 
    	
    </sect2>
  </sect1>  


</article>
