<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <HTML ><HEAD ><TITLE >artsdsp</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.61 "><LINK REL="HOME" TITLE="The aRts Handbook" HREF="index.html"><LINK REL="UP" TITLE="aRts Tools" HREF="arts-tools.html"><LINK REL="PREVIOUS" TITLE="artsplay" HREF="artsplay.html"><LINK REL="NEXT" TITLE="artscat" HREF="artscat.html"><META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css"><LINK REL="stylesheet" HREF="common/kde-common.css" TYPE="text/css"><META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"><META HTTP-EQUIV="Content-Language" CONTENT="en"><LINK REL="stylesheet" HREF="common/kde-localised.css" TYPE="text/css" TITLE="KDE-English"><LINK REL="stylesheet" HREF="common/kde-default.css" TYPE="text/css" TITLE="KDE-Default"></HEAD ><BODY CLASS="SECT1" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#AA0000" VLINK="#AA0055" ALINK="#AA0000" STYLE="font-family: sans-serif;" ><DIV CLASS="logoheader" ><A HREF="http://www.kde.org/" ><IMG SRC="common/logotp3.png" BORDER="0" ALT="The K Desktop Environment" HEIGHT="62" WIDTH="229"></A ></DIV ><DIV CLASS="NAVHEADER" ><TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >The <SPAN CLASS="APPLICATION" >aRts</SPAN > Handbook</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="artsplay.html" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" >Chapter 2. <SPAN CLASS="APPLICATION" >aRts</SPAN > Tools</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="artscat.html" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="SECT1" ><H1 CLASS="SECT1" ><A NAME="ARTSDSP" >2.6. <SPAN CLASS="APPLICATION" >artsdsp</SPAN ></A ></H1 ><P >The sound server only supports applications that are <SPAN CLASS="APPLICATION" >aRts</SPAN >-aware. Many legacy applications want to access the sound device directly. The <B CLASS="COMMAND" >artsdsp</B > command provides an interim solution that allows most of these applications to run unchanged.</P ><P >When an application is run under <SPAN CLASS="APPLICATION" >artsdsp</SPAN > all accesses to the <TT CLASS="FILENAME" >/dev/dsp</TT > audio device are intercepted and mapped into <SPAN CLASS="APPLICATION" >aRts</SPAN > <SPAN CLASS="ACRONYM" >API</SPAN > calls. While the device emulation is not perfect, most applications work this way, albeit with some degradation in performance and latency.</P ><P >The <B CLASS="COMMAND" >artsdsp</B > command follows the format:</P ><P >artsdsp [<TT CLASS="REPLACEABLE" ><I >options</I ></TT >] <TT CLASS="REPLACEABLE" ><I >application arguments</I ></TT ></P ><P >The following options are recognized:</P ><DIV CLASS="VARIABLELIST" ><DL ><DT ><TT CLASS="OPTION" >-h</TT >, <TT CLASS="OPTION" >--help</TT ></DT ><DD ><P >Show brief help.</P ></DD ><DT ><TT CLASS="OPTION" >-n</TT > <TT CLASS="OPTION" >--name</TT > = <TT CLASS="REPLACEABLE" ><I >name</I ></TT ></DT ><DD ><P >Use <TT CLASS="REPLACEABLE" ><I >name</I ></TT > to identify player to <B CLASS="COMMAND" >artsd</B >.</P ></DD ><DT ><TT CLASS="OPTION" >-m</TT > <TT CLASS="OPTION" >--mmap</TT ></DT ><DD ><P >Emulate memory mapping (<SPAN CLASS="ABBREV" >i.e.</SPAN > for <SPAN CLASS="APPLICATION" >Quake</SPAN >).</P ></DD ><DT ><TT CLASS="OPTION" >-v</TT > <TT CLASS="OPTION" >--verbose</TT ></DT ><DD ><P >Show parameters.</P ></DD ></DL ></DIV ><P >A typical invocation is:</P ><P ><TT CLASS="USERINPUT" ><B ><B CLASS="COMMAND" >artsdsp</B > <TT CLASS="OPTION" >-v</TT > <TT CLASS="OPTION" >-m realplay <TT CLASS="REPLACEABLE" ><I >song.mp3</I ></TT ></TT ></B ></TT ></P ><P >Some applications work better with the <TT CLASS="OPTION" >--mmap</TT > option. Not all features of the sound device are fully emulated, but most applications should work. If you find one that does not, submit a detailed bug report and the developers may be able to fix it. Again, remember this is an interim solution and something of an ugly hack; the best solution is to add native <SPAN CLASS="APPLICATION" >aRts</SPAN > support to the applications. If your favorite sound application does not have <SPAN CLASS="APPLICATION" >aRts</SPAN > support, ask the developer to provide it.</P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="artsplay.html" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="artscat.html" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><SPAN CLASS="APPLICATION" >artsplay</SPAN ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="arts-tools.html" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><SPAN CLASS="APPLICATION" >artscat</SPAN ></TD ></TR ></TABLE ></DIV ></BODY ></HTML >