Home | History | Annotate | Download | only in man3
      1 <!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
      2 <!--ArborText, Inc., 1988-1999, v.4002-->
      3 <!--ARC : LSARC 2001/201 GNOME 2.X on Solaris-->
      4 <!ENTITY cmd "libesd">
      5 <!ENTITY % commonents SYSTEM "smancommon.ent">
      6 %commonents;
      7 <!ENTITY % booktitles SYSTEM "booktitles.ent">
      8 %booktitles;
      9 <!ENTITY suncopy "Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved.">
     10 ]>
     11 <?Pub UDT _bookmark _target>
     12 <?Pub Inc>
     13 <refentry id="libesd-3">
     14 <!-- %Z%%M% %I% %E% SMI; -->
     15 <refmeta><refentrytitle>&cmd;</refentrytitle><manvolnum>3</manvolnum>
     16 <refmiscinfo class="date">10 Jan 2003</refmiscinfo>
     17 <refmiscinfo class="sectdesc">&man3;</refmiscinfo>
     18 <refmiscinfo class="software">&release;</refmiscinfo>
     19 <refmiscinfo class="arch">generic</refmiscinfo>
     20 <refmiscinfo class="copyright">&suncopy;</refmiscinfo>
     21 </refmeta>
     22 <indexterm><primary>&cmd;</primary></indexterm><indexterm><primary>GNOME
     23 Enlightenment Sound Daemon Interface library</primary></indexterm><refnamediv
     24 id="libesd-3-name"><refname>&cmd;</refname><refpurpose>GNOME Enlightenment
     25 Sound Daemon Interface library </refpurpose></refnamediv>
     26 <refsect1 id="libesd-3-desc"><title>&desc-tt;</title>
     27 <para>The <filename>&cmd;</filename> library provides access to the Enlightened
     28 Sound Daemon (<filename>esd</filename>).  The Enlightened Sound Daemon is
     29 launched automatically by <filename>&cmd;</filename> if the daemon is not
     30 already present. A sockets connection is managed with the daemon by this API.
     31 The connection allows sound data to be written to the daemon for playback,
     32 or read from the daemon for recording purposes.</para>
     33 <para>The daemon will automatically sample an incoming stream from a client
     34 to the best format that is supported by the sound device. Therefore, client
     35 programs do not have to be concerned with writing platform-specific code for
     36 handling sound data.</para>
     37 <para>The daemon supports caching. Each sample is given an ID tag, and sound
     38 data can then be accessed via this API with this ID tag.</para>
     39 <para>If the audio device supports simultaneous record and playback at the
     40 same bit resolution, bit rate, and number of channels (in other words, is
     41 full duplex), then the daemon and API also supports simultaneous reading
     42 and writing from the audio device.</para>
     43 </refsect1>
     44 <refsect1 id="libesd-3-file"><title>&file-tt;</title>
     45 <para>The following files are used by this application:</para>
     46 <variablelist termlength="medium"><varlistentry><term><filename>/usr/lib/&cmd;.so
     47 </filename> </term><listitem><para>GNOME Enlightened Sound Daemon Interface
     48 shared library</para>
     49 </listitem></varlistentry>
     50 </variablelist></refsect1>
     51 <refsect1 id="libesd-3-attr"><title>&attr-tt;</title>
     52 <para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>
     53 <refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>
     54 for descriptions of the following attributes:</para>
     55 <informaltable frame="all">
     56 <tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">
     57 <colspec colname="COLSPEC1" colwidth="1*">
     58 <thead>
     59 <row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"
     60 valign="middle">ATTRIBUTE VALUE</entry></row>
     61 </thead>
     62 <tbody>
     63 <row><entry><para>Availability</para></entry><entry><para>SUNWgnome-audio
     64 </para></entry></row>
     65 <row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry
     66 colname="COLSPEC1"><para>Volatile</para></entry></row>
     67 </tbody>
     68 </tgroup>
     69 </informaltable>
     70 </refsect1>
     71 <refsect1 id="libesd-3-also"><title>&also-tt;</title>
     72 <!--Reference to another man page-->
     73 <!--Reference to a Help manual-->
     74 <!--Reference to a book.-->
     75 <para>
     76 <citerefentry><refentrytitle>esdcat</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
     77 <citerefentry><refentrytitle>esdplay</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
     78 <citerefentry><refentrytitle>esdrec</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
     79 <citerefentry><refentrytitle>esdsample</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
     80 <citerefentry><refentrytitle>esdmon</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
     81 <citerefentry><refentrytitle>esdctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
     82 <citerefentry><refentrytitle>esd-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
     83 <citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>
     84 </para>
     85 </refsect1>
     86 <refsect1 id="libesd-3-note"><title>&note-tt;</title>
     87 <para>Written by Brian Cameron, Sun Microsystems Inc., 2003.</para>
     88 </refsect1>
     89 </refentry>
     90