Sophie

Sophie

distrib > Mandriva > 8.0 > i586 > media > main > by-pkgid > 6a3ae4e037535c68bd8a5fcce387b3cb > files > 671

kdemultimedia-2.1.1-5mdk.i586.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML
><HEAD
><TITLE
>Examples</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-builder"
HREF="artsbuilder.html"><LINK
REL="PREVIOUS"
TITLE="Tutorial"
HREF="artsbuilder-tutorial.html"><LINK
REL="NEXT"
TITLE="aRts in Detail"
HREF="arts-in-detail.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="artsbuilder-tutorial.html"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 3. <SPAN
CLASS="APPLICATION"
>aRts-builder</SPAN
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="arts-in-detail.html"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="ARTSBUILDER-EXAMPLES"
>3.3. Examples</A
></H1
><P
>Artsbuilder comes with several examples, which can be opened through
<SPAN
CLASS="GUIMENU"
>File</SPAN
>-&gt;<SPAN
CLASS="GUIMENUITEM"
>Open Example...</SPAN
>. Some of them are in the directory, some of them (which for
some reason don't work with the current release) are left in the todo directory.</P
><P
>The examples fall into several categories:
<UL
><LI
><P
>Standalone examples illustrating how to use each of the built-in
arts modules (named example_*.arts). These typically send some
output to a sound card.</P
></LI
><LI
><P
>Instruments built from lower level arts modules (named
instrument_*.arts). These following a standard convention for
input and output ports so they can be used by the midi manager
in artscontrol.</P
></LI
><LI
><P
>Templates for creating new modules (names template_*.arts).</P
></LI
><LI
><P
>Effects which can be used as reusable building blocks (named
effect_*.arts) [ all in todo ]</P
></LI
><LI
><P
>Mixer elements used for creating mixers, including graphical
controls (named mixer_element_*.arts). [ all in todo ]</P
></LI
><LI
><P
>Miscellaneous modules that don't fit into any of the above
categories.</P
></LI
></UL
></P
><P
>Detailed Description Of Each Module:
<DIV
CLASS="VARIABLELIST"
><DL
><DT
>example_stereo_beep.arts</DT
><DD
><P
>Generates a 440Hz sine wave tone in the left channel and an 880Hz sine
wave tone in the right channel, and sends it to the sound card
output. This is referenced in the aRts documentation.</P
></DD
><DT
>example_sine.arts</DT
><DD
><P
>Generates a 440 Hz sine wave.</P
></DD
><DT
>example_pulse.arts</DT
><DD
><P
>&#13;Generates a 440 Hz pulse wave with a 20% duty cycle.</P
></DD
><DT
>example_softsaw.arts</DT
><DD
><P
>&#13;Generates a 440 Hz sawtooth wave.</P
></DD
><DT
>example_square.arts</DT
><DD
><P
>&#13;Generates a 440 Hz square wave.</P
></DD
><DT
>example_tri.arts</DT
><DD
><P
>&#13;Generates a 440 Hz triangle wave.</P
></DD
><DT
>example_noise.arts</DT
><DD
><P
>&#13;Generates white noise.</P
></DD
><DT
>example_dtmf1.arts</DT
><DD
><P
>&#13;Generates a dual tone by producing 697 and 1209 Hz sine waves, scaling
them by 0.5, and adding them together. This is the DTMF tone for the
digit "1" on a telephone keypad.</P
></DD
><DT
>example_atan_saturate.arts</DT
><DD
><P
>&#13;Runs a triangle wave through the atan saturate filter.</P
></DD
><DT
>example_autopanner.arts</DT
><DD
><P
>Uses an autopanner to pan a 400 Hz sine wave between the left and
right speakers at a 2 Hz rate.</P
></DD
><DT
>example_brickwall.arts</DT
><DD
><P
>&#13;Scales a sine wave by a factor of 5 and then runs it through a
brickwall limiter.</P
></DD
><DT
>example_bus.arts</DT
><DD
><P
>&#13;Downlinks from a bus called "Bus" and uplinks to the bus
"out_soundcard" with the left and right channels reversed.</P
></DD
><DT
>example_cdelay.arts</DT
><DD
><P
>&#13;Downlinks from a bus called "Delay", uplinks the right channel through
a 0.5 second cdelay, and the left channel unchanged. You can use
artscontrol to connect the effect to a sound player and observe the
results.</P
></DD
><DT
>example_delay.arts</DT
><DD
><P
>&#13;This is the same as example_cdelay but used the delay effect.</P
></DD
><DT
>example_capture_wav.arts</DT
><DD
><P
>&#13;This uses the Synth_CAPTURE_WAV to save a 400 Hz sine wave as a wav
file. Run the module for a few seconds, and then examine the file
created in /tmp. You can play the file with a player such as kaiman.</P
></DD
><DT
>example_data.arts</DT
><DD
><P
>&#13;This uses the Data module to generate a constant stream of the value
"3" and sends it to a Debug module to periodically display it. It
also contains a Nil module, illustrating how it can be used to
do nothing at all.</P
></DD
><DT
>example_adsr.arts</DT
><DD
><P
>&#13;Shows how to create a simple instrument sound using the Envelope Adsr
module, repetitively triggered by a square wave.</P
></DD
><DT
>example_fm.arts</DT
><DD
><P
>&#13;This uses the FM Source module to generate a 440 Hz sine
wave which is frequency modulated at a 5 Hz rate.</P
></DD
><DT
>example_freeverb.arts</DT
><DD
><P
>&#13;This connects the Freeverb effect from a bus downlink to a bus
outlink. You can use artscontrol to connect the effect to a sound
player and observe the results.</P
></DD
><DT
>example_flanger.arts</DT
><DD
><P
>&#13;This implements a simple flanger effect (it doesn't appear
to work yet, though).</P
></DD
><DT
>example_moog.arts</DT
><DD
><P
>&#13;This structure combines the two channels from a bus into
one, passes it though the Moog VCF filter, and sends
it out the out_soundcard bus.</P
></DD
><DT
>example_pitch_shift.arts</DT
><DD
><P
>&#13;This structure passes the left channel of sound card data through the
Pitch Shift effect. Adjust the speed parameter to vary the effect.</P
></DD
><DT
>example_rc.arts</DT
><DD
><P
>&#13;This structure passes a white noise generator though an RC filter and
out to the sound card. By viewing the FFT Scope display in artscontrol
you can see how this varies from an unfiltered noise waveform.</P
></DD
><DT
>example_sequence.arts</DT
><DD
><P
>&#13;This demonstrates the Sequence module by playing a sequence of notes.</P
></DD
><DT
>example_shelve_cutoff.arts</DT
><DD
><P
>&#13;This structure passes a white noise generator though a Shelve Cutoff
filter and out to the sound card. By viewing the FFT Scope display in
artscontrol you can see how this varies from an unfiltered noise
waveform.</P
></DD
><DT
>example_equalizer.arts</DT
><DD
><P
>&#13;This demonstrates the Std_Equalizer module. It boosts the low and high
frequencies by 6 dB.</P
></DD
><DT
>example_tremolo.arts</DT
><DD
><P
>&#13;This demonstrates the Tremolo effect. It modulates the left and right
channels using a 10 Hz tremolo.</P
></DD
><DT
>example_xfade.arts</DT
><DD
><P
>&#13;This example mixes 440 and 880 Hz sine waves using a cross fader.
Adjust the value of the cross fader's percentage input from -1 to 1 to
control the mixing of the two signals.</P
></DD
><DT
>example_pscale.arts</DT
><DD
><P
>&#13;This illustrates the Pscale module (I'm not sure if this is a
meaningful example).</P
></DD
><DT
>example_play_wav.arts</DT
><DD
><P
>&#13;This illustrates the Play Wave module. You will need to
enter the full path to a .wav file as the filename
parameter.</P
></DD
><DT
>example_multi_add.arts</DT
><DD
><P
>This shows the Multi Add module which accepts any number of inputs. It
sums three Data modules which produce inputs of 1, 2, and 3, and
displays the result 6.</P
></DD
></DL
></DIV
></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="artsbuilder-tutorial.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="arts-in-detail.html"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Tutorial</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="artsbuilder.html"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><SPAN
CLASS="APPLICATION"
>aRts</SPAN
> in Detail</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>