# translation of artsbuilder_tools.po to 
# translation of artsbuilder_tools.po to
# translation of artsbuilder_tools.po to
# Copyright (C) 2002 Free Software Foundation, Inc.
# Lwandle Mgidlana <lwandle@translate.org.za>, 2002
#
msgid ""
msgstr ""
"Project-Id-Version: artsbuilder_tools\n"
"POT-Creation-Date: 2001-02-09 01:25+0100\n"
"PO-Revision-Date: 2002-09-26 12:34+0200\n"
"Last-Translator: Lwandle Mgidlana <lwandle@translate.org.za>\n"
"Language-Team:  <xh@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: application/x-xml2pot; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"X-Generator: KBabel 1.0beta2\n"

#: index.docbook:9
#, no-c-format
msgid "&arts; Tools"
msgstr ""

#: index.docbook:11
#, no-c-format
msgid ""
"Included with &arts; is a number of utilities for controlling and "
"configuring its behavior. You need to have some familiarity with most of "
"these tools in order to use &arts; effectively. This section describes each "
"of the utilities and their command options."
msgstr ""

#: index.docbook:19
#, no-c-format
msgid "&kcontrol;"
msgstr "&kcontrol;"

#: index.docbook:21
#, no-c-format
msgid ""
"When running &arts; under &kde;, the &kcontrolcenter; provides a group of "
"control panel settings under the <guilabel>Sound</guilabel> category. Some "
"of these settings are used by &arts;. You can also associate sounds with "
"various window manager and &kde; events using the <menuchoice><guilabel>"
"Look &amp; Feel</guilabel><guilabel>System "
"Notifications</guilabel></menuchoice> panel. See the &kcontrol; manual for "
"information on using the panel settings."
msgstr ""

#: index.docbook:34
#, no-c-format
msgid "&artsd;"
msgstr ""

#: index.docbook:36
#, no-c-format
msgid ""
"Access to the sound hardware resources is controlled by &artsd;, the &arts; "
"daemon. This allows different applications to simultaneously send requests "
"to the server, where they can be mixed together and played. Without a "
"centralized sound server a single application using a sound device would "
"prevent other applications from using it."
msgstr ""

#: index.docbook:44
#, no-c-format
msgid ""
"To use &arts; there should be one and only one copy of &artsd; running. It "
"is typically run when &kde; starts up if it is enabled in the &kcontrol; "
"<guilabel>Sound Server</guilabel> panel."
msgstr ""

#: index.docbook:50
#, no-c-format
msgid "The program accepts the following arguments:"
msgstr ""

#: index.docbook:82
#, no-c-format
msgid "-r <replaceable>sampling rate</replaceable>"
msgstr ""

#: index.docbook:82
#, no-c-format
msgid "Set sampling rate to use."
msgstr ""

#: index.docbook:82 index.docbook:271 index.docbook:498
#, no-c-format
msgid "<option>-h</option>"
msgstr "<option>-h</option>"

#: index.docbook:82 index.docbook:271
#, no-c-format
msgid "Display command usage."
msgstr ""

#: index.docbook:82
#, no-c-format
msgid "<option>-n</option>"
msgstr "<option>-n</option>"

#: index.docbook:82
#, no-c-format
msgid "Enable network transparency."
msgstr ""

#: index.docbook:82
#, no-c-format
msgid "-p <replaceable>port</replaceable>"
msgstr ""

#: index.docbook:82
#, no-c-format
msgid "Set <acronym>TCP</acronym> port to use (implies <option>-n</option>)."
msgstr ""

#: index.docbook:82
#, no-c-format
msgid "<option>-u</option>"
msgstr ""

#: index.docbook:82
#, no-c-format
msgid "Public, no authentication (dangerous)."
msgstr ""

#: index.docbook:82
#, no-c-format
msgid "<option>-d</option>"
msgstr "<option>-d</option>"

#: index.docbook:82
#, no-c-format
msgid "Enable full duplex operation."
msgstr ""

#: index.docbook:82
#, no-c-format
msgid "-D <replaceable>device name</replaceable>"
msgstr ""

#: index.docbook:82
#, no-c-format
msgid "Specify audio device (usually <filename>/dev/dsp</filename>)."
msgstr ""

#: index.docbook:82
#, no-c-format
msgid "-F <replaceable>fragments</replaceable>"
msgstr ""

#: index.docbook:82
#, no-c-format
msgid "Set number of fragments."
msgstr ""

#: index.docbook:82
#, no-c-format
msgid "-S <replaceable>size</replaceable>"
msgstr ""

#: index.docbook:82
#, no-c-format
msgid "Set fragment size, in bytes."
msgstr ""

#: index.docbook:82
#, no-c-format
msgid "-s <replaceable>seconds</replaceable>"
msgstr ""

#: index.docbook:82
#, no-c-format
msgid ""
"Set server auto-suspend time, in seconds. A value of zero disables "
"auto-suspend."
msgstr ""

#: index.docbook:82
#, no-c-format
msgid "-m <replaceable>appName</replaceable>"
msgstr ""

#: index.docbook:82
#, no-c-format
msgid ""
"Specify the name of an application to be used to display error, warning, and "
"informational messages. If you are running KDE you can use the "
"<application>artsmessage</application> utility for this."
msgstr ""

#: index.docbook:82
#, no-c-format
msgid "<option>-N</option>"
msgstr ""

#: index.docbook:82
#, no-c-format
msgid ""
"Increase the size of network buffers to a value suitable for running over a "
"10 mbps LAN. This is equivalent to using the -w 5 option (see below)."
msgstr ""

#: index.docbook:82
#, no-c-format
msgid "-w <replaceable>n</replaceable>"
msgstr ""

#: index.docbook:82
#, no-c-format
msgid ""
"When running <application>artsd</application> over a network connection to "
"another host you typically want to use a larger buffer size to avoid "
"dropouts. ARts provides applications with a suggested minimum buffer size. "
"Without this option the default size is based on the fragement size * "
"fragment count. Using this option you can increase the size from the default "
"by a factor of <replaceable>n</replaceable>."
msgstr ""

#: index.docbook:82
#, no-c-format
msgid "-l <replaceable>level</replaceable>"
msgstr ""

#: index.docbook:82
#, no-c-format
msgid "Set information level - 3 (quiet), 2 (warnings), 1 (info), 0 (debug)."
msgstr ""

#: index.docbook:82
#, no-c-format
msgid "<option>-v</option>"
msgstr "<option>-v</option>"

#: index.docbook:82
#, no-c-format
msgid "Display version level."
msgstr ""

#: index.docbook:203
#, no-c-format
msgid "In most cases simply running &artsd; will suffice."
msgstr ""

#: index.docbook:209
#, no-c-format
msgid "&artswrapper;"
msgstr ""

#: index.docbook:211
#, no-c-format
msgid ""
"To provide good real-time response, &artsd; is usually run as a real-time "
"process (on platforms where real-time priorities are supported). This "
"requires <systemitem class=\"username\">root</systemitem>"
" permissions, so to minimize the security implications, &artsd; can be "
"started using the small wrapper program &artswrapper; which simply sets "
"real-time priority (running as <systemitem "
"class=\"username\">root</systemitem>) and then executes &artsd; as a "
"non-<systemitem class=\"username\">root</systemitem> user."
msgstr ""

#: index.docbook:222
#, no-c-format
msgid ""
"If you make artswrapper SUID <systemitem "
"class=\"username\">root</systemitem>, it will likely improve the quality of "
"your audio playback by reducing gaps in the music. However, it also "
"increases the risk that a bug in the code or a malicious user can crash or "
"otherwise harm your machine. In addition, on multi-user machines, "
"prioritizing high-quality audio may result in deteriorated performance for "
"the users who are trying to make <quote>productive</quote> use of the "
"machine."
msgstr ""

#: index.docbook:234
#, no-c-format
msgid "&artsshell;"
msgstr ""

#: index.docbook:236
#, no-c-format
msgid ""
"The &artsshell; command is intended as a utility to perform miscellaneous "
"functions related to the sound server. It is expected that the utility will "
"be extended with new commands in the future (see the comments in the source "
"code for some ideas)."
msgstr ""

#: index.docbook:243
#, no-c-format
msgid "The command accepts the following format:"
msgstr ""

#: index.docbook:265
#, no-c-format
msgid ""
"artsshell [options] <replaceable>command</replaceable> "
"[<replaceable>command-options</replaceable>]"
msgstr ""

#: index.docbook:267
#, no-c-format
msgid "The following options are supported:"
msgstr ""

#: index.docbook:271
#, no-c-format
msgid "<option>-q</option>"
msgstr "<option>-q</option>"

#: index.docbook:271
#, no-c-format
msgid "Suppress all output."
msgstr ""

#: index.docbook:289
#, no-c-format
msgid "The following commands are supported:"
msgstr ""

#: index.docbook:291
#, no-c-format
msgid "suspend"
msgstr ""

#: index.docbook:291
#, no-c-format
msgid "Suspend the sound server."
msgstr ""

#: index.docbook:291
#, no-c-format
msgid "status"
msgstr "indawo engatshintshiyo"

#: index.docbook:291
#, no-c-format
msgid "Display sound server status information."
msgstr ""

#: index.docbook:291
#, no-c-format
msgid "terminate"
msgstr ""

#: index.docbook:291
#, no-c-format
msgid ""
"Terminate the sound server. This may confuse and/or crash any applications "
"that are currently using it."
msgstr ""

#: index.docbook:291
#, no-c-format
msgid "<option>autosuspend</option> <parameter>seconds</parameter>"
msgstr ""

#: index.docbook:291
#, no-c-format
msgid ""
"Set the autosuspend time to the specified number of seconds. The sound "
"server will suspend itself if idle for that period of time. A value of zero "
"disables auto-suspend."
msgstr ""

#: index.docbook:291
#, no-c-format
msgid "<option>networkbuffers</option> <parameter>n</parameter>"
msgstr ""

#: index.docbook:291
#, no-c-format
msgid ""
"Set the size of the nework buffers to be a factor of "
"<parameter>n</parameter> times the default size."
msgstr ""

#: index.docbook:291
#, no-c-format
msgid "<option>volume</option> [<replaceable>volume</replaceable>]"
msgstr ""

#: index.docbook:291
#, no-c-format
msgid ""
"Sets volume scaling for sound server audio output. The "
"<replaceable>volume</replaceable> argument is a floating point value. With "
"no argument the current volume is displayed."
msgstr ""

#: index.docbook:291
#, no-c-format
msgid "stereoeffect list"
msgstr ""

#: index.docbook:291
#, no-c-format
msgid "List all of the available stereo effect modules."
msgstr ""

#: index.docbook:291
#, no-c-format
msgid ""
"<option>stereoeffect insert [top|bottom]</option> "
"<replaceable>name</replaceable>"
msgstr ""

#: index.docbook:291
#, no-c-format
msgid ""
"Insert a stereo effect into the stereo effect stack. Returns an identifier "
"that can be used for later removing it. It can be installed at the top or "
"the bottom (the default)."
msgstr ""

#: index.docbook:291
#, no-c-format
msgid "<option>stereoeffect remove</option> <replaceable>id</replaceable>"
msgstr ""

#: index.docbook:291
#, no-c-format
msgid ""
"Removes the stereo effect with identifier <replaceable>id</replaceable>"
" from the effects stack."
msgstr ""

#: index.docbook:380
#, no-c-format
msgid "artsplay"
msgstr ""

#: index.docbook:382
#, no-c-format
msgid ""
"The <application>artsplay</application> command is a simple utility to play "
"a sound file. It accepts a single argument corresponding to the name of a "
"sound file which is sent to the sound server to be played. The sound file "
"can be any common sound file type such as <literal "
"role=\"extension\">wav</literal> or <literal "
"role=\"extension\">au</literal>. This utility is good for testing that the "
"sound server is working. By running two commands in parallel or in rapid "
"succession you can demonstrate how the sound servers mixes more than one "
"sound source."
msgstr ""

#: index.docbook:395
#, no-c-format
msgid "artsdsp"
msgstr ""

#: index.docbook:397
#, no-c-format
msgid ""
"The sound server only supports applications that are &arts;-aware. Many "
"legacy applications want to access the sound device directly. The &artsdsp; "
"command provides an interim solution that allows most of these applications "
"to run unchanged."
msgstr ""

#: index.docbook:404
#, no-c-format
msgid ""
"When an application is run under &artsdsp; all accesses to the <filename "
"class=\"devicefile\">/dev/dsp</filename> audio device are intercepted and "
"mapped into &arts; <acronym>API</acronym> calls. While the device emulation "
"is not perfect, most applications work this way, albeit with some "
"degradation in performance and latency."
msgstr ""

#: index.docbook:412
#, no-c-format
msgid "The &artsdsp; command follows the format:"
msgstr ""

#: index.docbook:416
#, no-c-format
msgid ""
"artsdsp [<replaceable>options</replaceable>] <replaceable>application "
"arguments</replaceable>"
msgstr ""

#: index.docbook:420
#, no-c-format
msgid "The following options are recognized:"
msgstr ""

#: index.docbook:424
#, no-c-format
msgid "<option>-h</option>, <option>--help</option>"
msgstr ""

#: index.docbook:424
#, no-c-format
msgid "Show brief help."
msgstr ""

#: index.docbook:424
#, no-c-format
msgid "<option>-n</option> <option>--name</option> = <replaceable>name</replaceable>"
msgstr ""

#: index.docbook:424
#, no-c-format
msgid ""
"Use <replaceable>name</replaceable> to identify player to "
"<command>artsd</command>."
msgstr ""

#: index.docbook:424
#, no-c-format
msgid "<option>-m</option> <option>--mmap</option>"
msgstr ""

#: index.docbook:424
#, no-c-format
msgid "Emulate memory mapping (&eg; for <application>Quake</application>)."
msgstr ""

#: index.docbook:424
#, no-c-format
msgid "<option>-v</option> <option>--verbose</option>"
msgstr ""

#: index.docbook:424
#, no-c-format
msgid "Show parameters."
msgstr ""

#: index.docbook:456
#, no-c-format
msgid "A typical invocation is:"
msgstr ""

#: index.docbook:460
#, no-c-format
msgid ""
"<command>artsdsp</command> <option>-v</option> <option>-m</option> "
"<parameter>realplay <replaceable>song.mp3</replaceable></parameter>"
msgstr ""

#: index.docbook:464
#, no-c-format
msgid ""
"Some applications work better with the <option>--mmap</option> 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 "
"&arts; support to the applications. If your favorite sound application does "
"not have &arts; support, ask the developer to provide it."
msgstr ""

#: index.docbook:478
#, no-c-format
msgid "artscat"
msgstr ""

#: index.docbook:480
#, no-c-format
msgid ""
"This is a simple utility to send raw audio data to the sound server. You "
"need to specify the data format (sampling rate, sample size, and number of "
"channels). This is probably not a utility that you will use often, but it "
"can be handy for testing purposes. The command syntax is:"
msgstr ""

#: index.docbook:489
#, no-c-format
msgid ""
"artscat [ <replaceable>options</replaceable> ] [ "
"<replaceable>filename</replaceable> ]"
msgstr ""

#: index.docbook:493
#, no-c-format
msgid ""
"If no file name is specified, it reads standard input. The following options "
"are supported:"
msgstr ""

#: index.docbook:498
#, no-c-format
msgid "<option>-r</option> <parameter>sampling rate</parameter>"
msgstr ""

#: index.docbook:498
#, no-c-format
msgid "Set the sampling rate to use."
msgstr ""

#: index.docbook:498
#, no-c-format
msgid "<option>-b</option> <parameter>bits</parameter>"
msgstr ""

#: index.docbook:498
#, no-c-format
msgid "Set sample size to use (8 or 16)."
msgstr ""

#: index.docbook:498
#, no-c-format
msgid "<option>-c</option> <parameter>channels</parameter>"
msgstr ""

#: index.docbook:498
#, no-c-format
msgid "Set number of channels (1 or 2)."
msgstr ""

#: index.docbook:498
#, no-c-format
msgid "Display command usage and exit."
msgstr ""

#: index.docbook:540
#, no-c-format
msgid "&artscontrol;"
msgstr ""

#: index.docbook:542
#, no-c-format
msgid ""
"This is a graphical utility for performing a number of tasks related to the "
"sound server. The default window displays two volume level indicators and a "
"slider to control overall output volume. From the <guimenu>View</guimenu> "
"menu you can select other functions:"
msgstr ""

#: index.docbook:549
#, no-c-format
msgid "FFT Scope"
msgstr ""

#: index.docbook:549
#, no-c-format
msgid "Opens a window which shows a real-time spectrum analyzer style display."
msgstr ""

#: index.docbook:549
#, no-c-format
msgid "Audio Manager"
msgstr ""

#: index.docbook:549
#, no-c-format
msgid ""
"Displays active sound sources and allows you to connect them to any of the "
"available busses."
msgstr ""

#: index.docbook:549
#, no-c-format
msgid "aRts Status"
msgstr ""

#: index.docbook:549
#, no-c-format
msgid ""
"Shows if the sound server is running and if scheduling is real-time. "
"Indicates when server will autosuspend and allows you to suspend it "
"immediately."
msgstr ""

#: index.docbook:549
#, no-c-format
msgid "Midi Manager"
msgstr "Umphathi weMidi"

#: index.docbook:549
#, no-c-format
msgid ""
"Shows active &MIDI; inputs and outputs and allows you to make connections "
"[TODO: Does this work yet? Need more detail]."
msgstr ""

#: index.docbook:549
#, no-c-format
msgid "FreeVerb"
msgstr ""

#: index.docbook:549
#, no-c-format
msgid ""
"Connects a FreeVerb reverb effect to the stack of &arts; output effects and "
"allows you to control the effect parameters graphically."
msgstr ""

#: index.docbook:549
#, no-c-format
msgid "Leds-like volume display"
msgstr ""

#: index.docbook:549
#, no-c-format
msgid ""
"Changes the volume indicators in the main window to use a colored "
"<acronym>LED</acronym> display format instead of progress bars."
msgstr ""

#: index.docbook:616
#, no-c-format
msgid "artsc-config"
msgstr ""

#: index.docbook:618
#, no-c-format
msgid ""
"This is a utility to assist developers using the &arts; C "
"<acronym>API</acronym>. It outputs the appropriate compiler and linker "
"options needed when compiling and linking code with &arts;. It is intended "
"to be used within make files to assist in portability. The command accepts "
"three options:"
msgstr ""

#: index.docbook:626
#, no-c-format
msgid "--cflags"
msgstr ""

#: index.docbook:626
#, no-c-format
msgid ""
"Displays the compiler flags needed when compiling with the &arts; C "
"<acronym>API</acronym>."
msgstr ""

#: index.docbook:626
#, no-c-format
msgid "--libs"
msgstr ""

#: index.docbook:626
#, no-c-format
msgid ""
"Displays the linker flags needed when linking with the &arts; C "
"<acronym>API</acronym>."
msgstr ""

#: index.docbook:626
#, no-c-format
msgid "--version"
msgstr ""

#: index.docbook:626
#, no-c-format
msgid "Displays the version of the <command>artsc-config</command> command."
msgstr ""

#: index.docbook:656
#, no-c-format
msgid "Typical output from the command is shown below:"
msgstr ""

#: index.docbook:658
#, no-c-format
msgid ""
"<prompt>%</prompt> <userinput><command>artsc-config</command> "
"<option>--cflags</option></userinput>\n"
"<computeroutput>-I/usr/local/kde2/include/artsc</computeroutput>\n"
"<prompt>%</prompt> <userinput><command>artsc-config</command> "
"<option>--libs</option></userinput>\n"
"<computeroutput>-L/usr/local/kde2/lib -ldl -lartsc -DPIC -fPIC "
"-lpthread</computeroutput>\n"
"<prompt>%</prompt> <userinput><command>artsc-config</command> "
"<option>--version</option></userinput>\n"
"<computeroutput>0.9.5</computeroutput>"
msgstr ""

#: index.docbook:667
#, no-c-format
msgid "You could use this utility in a make file using a rule such as:"
msgstr ""

#: index.docbook:671
#, no-c-format
msgid ""
"artsc: artsc.c\n"
"        gcc `artsc-config --cflags` -o artsc artsc.c `artsc-config --libs`"
msgstr ""

#: index.docbook:679
#, no-c-format
msgid "&mcopidl;"
msgstr ""

#: index.docbook:681
#, no-c-format
msgid ""
"The &mcopidl; command is the &IDL; file compiler for &MCOP;, the Multimedia "
"Communication Protocol used by &arts;. Interfaces in &arts; are defined in "
"&IDL;, a language independent Interface Definition Language. The &mcopidl; "
"utility accepts an &IDL; file as input and generates C++ header and source "
"files for a class implementing the interface. The command accepts the "
"following syntax:"
msgstr ""

#: index.docbook:692
#, no-c-format
msgid ""
"mcopidl [ <replaceable>options</replaceable> ] "
"<replaceable>filename</replaceable>"
msgstr ""

#: index.docbook:695
#, no-c-format
msgid "The valid options are:"
msgstr ""

#: index.docbook:696
#, no-c-format
msgid "<option>-I</option> <parameter>directory</parameter>"
msgstr ""

#: index.docbook:696
#, no-c-format
msgid "Search in <parameter>directory</parameter> for includes."
msgstr ""

#: index.docbook:696
#, no-c-format
msgid "<option>-e</option> <parameter>name</parameter>"
msgstr ""

#: index.docbook:696
#, no-c-format
msgid ""
"Exclude a struct, interface, or enum type <parameter>name</parameter> from "
"code generation."
msgstr ""

#: index.docbook:696
#, no-c-format
msgid "<option>-t</option>"
msgstr "<option>-t</option>"

#: index.docbook:696
#, no-c-format
msgid ""
"Also create <literal role=\"extension\">.mcoptype</literal>/<literal "
"role=\"extension\">.mcopclass</literal> files containing type information "
"for the &IDL; file."
msgstr ""

#: index.docbook:728
#, no-c-format
msgid ""
"More information about &MCOP; and &IDL; is covered in the section <link "
"linkend=\"interfaces\">Interfaces and &IDL;</link>."
msgstr ""
