|
|
|
|
libartskde Introduction
|
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
|
|
1. What is libartskde?
|
|
|
|
|
libartskde is a simple KDE->aRts wrapper
|
|
|
|
|
that allows the developer to use KDE
|
|
|
|
|
technology to access aRts.
|
|
|
|
|
ie. no need to deal with std::string's anymore
|
|
|
|
|
etc.. you can just use TQString's or KURL's
|
|
|
|
|
to play sound
|
|
|
|
|
|
|
|
|
|
2. How to use it to play sounds?
|
|
|
|
|
<snip>
|
|
|
|
|
1 KArtsDispatcher dispatcher;
|
|
|
|
|
2 KArtsServer server;
|
|
|
|
|
|
|
|
|
|
3 KURL file = "file:/home/nikoz/test.mp3";
|
|
|
|
|
|
|
|
|
|
4 KPlayObjectFactory factory(server.server());
|
|
|
|
|
5 KPlayObject *playobj = factory.createPlayObject(file, true);
|
|
|
|
|
|
|
|
|
|
6 playobj->play();
|
|
|
|
|
<snap>
|
|
|
|
|
|
|
|
|
|
Line:
|
|
|
|
|
1 Sets up the a KArtsDispatcher
|
|
|
|
|
2 Starts a new SoundServerV2 in the running artsd process
|
|
|
|
|
|
|
|
|
|
3 Simple test URL to demonstrate the use with KURL
|
|
|
|
|
|
|
|
|
|
4 Creates a KPlayObjectFactory, parameter: our SoundServerV2
|
|
|
|
|
5 Gets a KPlayObject from the factory, containing an Arts::PlayObject
|
|
|
|
|
created in our running artsd process
|
|
|
|
|
Parameters:
|
|
|
|
|
KURL url
|
|
|
|
|
(specifies the url to be played)
|
|
|
|
|
bool createBUS
|
|
|
|
|
(specifies wheter to create a Synth_BUS_UPLINK or not, "false" is only interesting if you want to use EffectsStacks etc..., see Noatun)
|
|
|
|
|
6 Play the file
|
|
|
|
|
|
|
|
|
|
That's it, with 6 LOC a "full" media player :)
|
|
|
|
|
|
|
|
|
|
To make the example above compile you will also have to add these #includes:
|
|
|
|
|
#include <arts/kartsserver.h>
|
|
|
|
|
#include <arts/kartsdispatcher.h>
|
|
|
|
|
#include <arts/kplayobject.h>
|
|
|
|
|
#include <arts/kplayobjectfactory.h>
|
|
|
|
|
|
|
|
|
|
Enjoy...
|
|
|
|
|
Nikolas Zimmermann
|
|
|
|
|
<wildfox@kde.org>
|
