While Reggae comes with a complete set of autodocs, starting using Reggae may be not easy for programmers. Autodocs concentrate on details by definition, not giving an overwiev. I've been asked for writing some simple tutorial showing how to use Reggae in programs. The work has just been started (it is not linked from main page yet). Feel free to give your opinions, proposals, language fixes (I'm not a native English speaker) here.

Now if only we could have similar tutorials for all aspects of MorphOS - that would be great! Thanks for your work!

Hello Krashan,

could a 68k app, use Reggae to play "multiple" samples under MOS? (waves for the matter). iirc Raggae can co-exist with datatypes, right?

Great initiative Krashan ! :)

I'll try to replace all Datatypes calls by reggae in my search engine...

SixK

could a 68k app, use Reggae to play "multiple" samples under MOS?

Yes, it can. Multimedia.class library API is the "new style" one (parameters are passed to PPC registers, not emulated 68k ones). Then a 68k app cannot access multimedia.class library functions directly. That is why Reggae contains multimedia68k.library, which is a wrapper allowing 68k application to access multimedia.class library functions. Then a 68k app just opens "multimedia68k.library" instead of "multimedia/multimedia.class", function names, arguments and meaning of results are identical. BOOPSI interface is the same for 68k apps and PPC apps, so nothing changes there.

Reggae can co-exist with datatypes, right?

Of course it can. They are independent and can be used simultaneously in the same program.

[ Edited by Krashan on 2007/6/16 18:15 ]

ok perfect! Thank you!

is there a player that uses Reggae to test some waves?

Edit- just found "soundplay" in a previous build (b) and it works.

What "OneMillion" is for?



[ Edited by Framiga on 2007/6/17 14:42 ]

OneMillion is a benchmark tool. It loads and decodes million of sample frames from a sound stream and shows operation time.

Appreciated, now we have no excuse not to use Reggae..

You could move the explanation for media port numbers up a bit,
because it is not explained in the first usage (section 2.2).

You could move the explanation for media port numbers

1. The tutorial is not yet finished.

2. I assume most programmers will not be interested in Reggae design and advanced usage (at least for the first time). They will use it on "just load me this image and go away" basis. That is why I want to keep the first chapters simple. When you want to use some library in your application you want docs to be simple, so you can have working code as soon as possible. Then, after it is working you may want to learn more about the library, maybe optimize its usage, use more advanced APIs etc. The tutorial is written with this principle in mind. For simple Reggae usage "just put zero here" is enough. When the tutorial enters the stage where "just put zero" does not work anymore, ports will be explained.

The tutorial has got some new chapters.

Brilliant! That's exactly what every new system needs: Free tools and documentation to make it easy to program.