=?UTF-8?Q?Andr=C3=A9=20Hentschel=20?=: winedev: Cleanup multimedia documentation.
Alexandre Julliard
julliard at winehq.org
Mon Jan 23 09:17:27 CST 2012
Module: docs
Branch: master
Commit: 9ffbd7c28b48f76a6630f613398865fb02a9479a
URL: http://source.winehq.org/git/docs.git/?a=commit;h=9ffbd7c28b48f76a6630f613398865fb02a9479a
Author: André Hentschel <nerv at dawncrow.de>
Date: Mon Jan 16 23:02:50 2012 +0100
winedev: Cleanup multimedia documentation.
---
en/winedev-multimedia.sgml | 168 ++------------------------------------------
1 files changed, 6 insertions(+), 162 deletions(-)
diff --git a/en/winedev-multimedia.sgml b/en/winedev-multimedia.sgml
index 29936f7..3ba4de3 100644
--- a/en/winedev-multimedia.sgml
+++ b/en/winedev-multimedia.sgml
@@ -227,8 +227,8 @@ Kernel space | Client applications
<para>
The low level drivers abstract the hardware specific features
- from the rest of the multimedia code. Those are implemented with a
- well defined set of APIs, as windows do.
+ from the rest of the multimedia code. Those are implemented on top
+ of mmdevapi, as new versions of windows do.
</para>
<para>
@@ -267,49 +267,6 @@ Kernel space | Client applications
<sect2>
<title>Hardware-bound low level drivers</title>
-
- <para>
- Each low lever driver has to implement at least one of the
- following functionality, through the named function:
- <itemizedlist>
- <listitem>
- <para>
- Waveform audio: out for playback, and in for
- recording. MMSYSTEM and WINMM call the real low level
- audio driver using the driver's
- <function>wodMessage</function> and
- <function>widMessage</function> functions which handle
- the different requests.
- </para>
- </listitem>
- <listitem>
- <para>
- MIDI (Musical Instrument Digital Interface): out for
- playback, and in for recording. MMSYSTEM and WINMM
- call the low level driver functions using the driver's
- <function>midMessage</function> and the
- <function>modMessage</function> functions.
- </para>
- </listitem>
- <listitem>
- <para>
- Mixer: this allows setting the volume for each one of
- the other functionnality (and also some specific
- attributes, like left/right balance for stereo
- streams...). MMSYSTEM and WINMM call the low level
- driver functions using the
- <function>mxdMessage</function> function.
- </para>
- </listitem>
- <listitem>
- <para>
- Aux: this is the predecessor of the mixer
- functionnality (introduced in Win 95). Its usage has
- been deprecated in favor of mixer interfaces.
- </para>
- </listitem>
- </itemizedlist>
- </para>
<para>
Wine currently supports the following (kernel) multimedia
@@ -323,7 +280,7 @@ Kernel space | Client applications
Technologies</ulink>. The presence of this driver is
checked by configure (depends on the
<sys/soundcard.h> file). Source code resides in
- <filename>dlls/winmm/wineoss</filename>.
+ <filename>dlls/wineoss.drv</filename>.
</para>
</listitem>
<listitem>
@@ -331,131 +288,18 @@ Kernel space | Client applications
Advanced Linux Sound Architecture (<ulink
url="http://www.alsa-project.org/">ALSA</ulink>) as
supplied in the Linux kernel. Source code resides in
- <filename>dlls/winmm/winealsa</filename>.
- </para>
- </listitem>
- <listitem>
- <para>
- Analog RealTime Synthetizer (<ulink
- url="http://www.arts-project.org/">aRts</ulink>): a
- network server (and virtual mixer) used in the KDE project.
- </para>
- </listitem>
- <listitem>
- <para>
- Enlightenment Sound Daemon (<ulink
- url="http://www.tux.org/~ricdude/EsounD.html">EsounD</ulink>):
- a network server used in the GNOME project.
- </para>
- </listitem>
- <listitem>
- <para>
- Network Audio Server (<ulink
- url="http://radscan.com/nas.html">NAS</ulink>): an
- audio server.
+ <filename>dlls/winealsa.drv</filename>.
</para>
</listitem>
<listitem>
<para>
- <ulink
- url="http://jackit.sourceforge.net/">Jack</ulink>: a
- low latency audio server.
- </para>
- </listitem>
- <listitem>
- <para>
- AudioIO: the native Solaris audio interface.
+ Core Audio as introduced in Mac OS X 10.3. Source code resides in
+ <filename>dlls/winecoreaudio.drv</filename>.
</para>
</listitem>
</itemizedlist>
</para>
- <para>
- The supported functionnalities per driver is as follows
- (this table lists the available features of the products,
- not exactly what's actually implemented on Wine):
- <table frame="all">
- <title>Wine multimedia drivers' functionalities</title>
- <tgroup cols="6" align="left" colsep="1" rowsep="1">
- <thead>
- <row>
- <entry>Driver</entry>
- <entry>Wave Out</entry>
- <entry>Wave In</entry>
- <entry>Midi Out</entry>
- <entry>Midi In</entry>
- <entry>Mixer (and Aux)</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>OSS</entry>
- <entry>Yes</entry>
- <entry>Yes</entry>
- <entry>Yes</entry>
- <entry>Yes</entry>
- <entry>Yes</entry>
- </row>
- <row>
- <entry>ALSA</entry>
- <entry>Yes</entry>
- <entry>Yes</entry>
- <entry>Yes</entry>
- <entry>Yes</entry>
- <entry>Yes</entry>
- </row>
- <row>
- <entry>aRts</entry>
- <entry>Yes</entry>
- <entry>Yes</entry>
- <entry>No</entry>
- <entry>No</entry>
- <entry>Yes</entry>
- </row>
- <row>
- <entry>ESD</entry>
- <entry>Yes</entry>
- <entry>Yes</entry>
- <entry>No</entry>
- <entry>No</entry>
- <entry>No</entry>
- </row>
- <row>
- <entry>NAS</entry>
- <entry>Yes</entry>
- <entry>Yes</entry>
- <entry>No</entry>
- <entry>No</entry>
- <entry>Yes</entry>
- </row>
- <row>
- <entry>AudioIO</entry>
- <entry>Yes</entry>
- <entry>Yes</entry>
- <entry>No</entry>
- <entry>No</entry>
- <entry>Yes</entry>
- </row>
- <row>
- <entry>Jack</entry>
- <entry>Yes</entry>
- <entry>Yes</entry>
- <entry>No</entry>
- <entry>No</entry>
- <entry>Yes</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- </para>
-
- <para>
- Lots of listed drivers won't support Midi (in a short time)
- because the exposed "Un*x" native interfaces don't. This
- would require using some kind as software synthesis (as
- Timidity), but we cannot incorporate as it's GPL'ed.
- </para>
-
</sect2>
<sect2>
More information about the wine-cvs
mailing list