Important note

ROVLib is exclusively for RISC OS computers, and code linked with it will not work on non RISC OS computers (excluding RISC OS emulators).

License

ROVLib is released under The Artistic License.

Why the Artistic License rather than (L)GPL or something else?

I've used ROVLib in a number of commercial applications, and I wouldn't expect to force the companies involved to have their source code released. The LGPL is better, but since RISC OS doesn't support dynamic linking natively, it's a little difficult to implement. After reviewing a number of other licenses, I found that the Artistic License seems to be the best for this library.

Copyright

Currently, all ROVLib components are Copyright © Jason Tribbeck / 7th ARM 1994-2017. This will probably change with new development.

Download

Only the GCCSDK source code is being maintained - although it should probably still compile with Norcroft.

• Source code for GCCSDK - This is the complete source, with everything compiling with GCCSDK.
• Object code for GCCSDK - This is the header files, and object library suitable for use with GCCSDK.
• 32-bit source code for Norcroft - This is the complete source code, as well as object files and the complete library.
• 32-bit object code for Norcroft - This is the header files, and object library.
• 26-bit object code for Norcroft - This is the same as above, but for 26-bit compilation.
• Tutorials - These were written for the 26-bit library, but should be easy to convert to 32-bit.

Download via SVN

I have now made the GCCSDK version source available for download from my SVN server.

To make it (a little) less of a target to hack, I've changed the default port for my SVN server so it's running on port 13960 instead of 3960. To access the SVN server, use:

svn co svn://rovlib.tribbeck.com:13960/rovlib

This will download the latest version. The first proper revision is revision 4. Revisions prior to this were testing, and there were additional files in there which are now unnecessary (unless you want to look at the .git directory I left in there, a couple of zip files containing the source and object files and some of the conversion Perl scripts!)

The tutorials have also been converted to GCCSDK, and can be downloaded via SVN:

svn co svn://rovlib.tribbeck.com:13960/rovlib-tutorials

Note that they need an environment variable which will point to the ROVLib installation directory. As a reference, my .bashrc file has this at the bottom:

export ROVLIB_PATH=/home/build/riscos/rovlib

Autobuilds

I now have a continuous integration style build for ROVLib (and also the work-in-progress ROVLib2) - this is available from http://autobuild.tribbeck.com. Note that this is a bit rough-and-ready, but you can download the source, built output, and the build logs.

I'll include the tutorials at some point...

API documentation

This is available online.

Build requirements - RISC OS

Using ROVLib

You need a C compiler capable of using ARM AOF format files. For the 32-bit ROVLib, you will need a 32-bit compatible compiler.

Building ROVLib

You need Norcroft (Acorn) Cv5 to build ROVLib, as well as ObjAsm 3. It may work using the gccsdk, but it is not supported as yet. This should happen soon. Note that it has been known to compile with ObjAsm 2, but it was never tested.

Build requirements - Linux

Using ROVLib

You need to install GCCSDK. The compiler needs to be told where the include files are, and the linker needs to know where the library is.

Building ROVLib

You need to install GCCSDK, and have the GCCSDK_INSTALL_CROSSBIN environment variable set. The GNUmakefile will build everything to the current directory.

Note that a local program, fixasm is compiled with the local GCC. This will modify the assembler output files so that the linker thinks they're compiled with the soft-float. No floating point is actually used in the assembler! The upshot is that you need to make sure you have a working GCC compiler as well as GCCSDK.

Tutorials

The non-SVN tutorials have not been modified to compile with GCCSDK - I have used a GNUmakefile like this. You will need to set the ROVPATH variable to where you've installed ROVLib. Note that you will need to change the filenames from c/FileName to FileName.c, and also the third tutorial needs the function name close() renamed. All of this (and more!) has been done in the SVN repository

Note that the binary files are quite a bit bigger than produced with Norcroft. I suspect something related with GCCSDK, such as Unixlib...

News

2006-03-26
I've copied this over from SourceForge to my own server; CVS isn't currently working, but archives are available.

2002-11-17
I have successfully created a 32-bit version of ROVLib, linked it with one of my tutorials and executed it on RISC OS 4.02. The C source only needed recompilation (as expected), and the assembler required minor modifications (done with a simple PERL script). Note that the source in rovsrc has not been updated as yet; this is expected to be done shortly.

2002-14-02
I have started the tutorials, and uploaded the first five last night. I also fixed some explicit pathnames in the source code, so it should be compilable on machines other than my own!

2002-14-02
Peter Naulls has kindly sent me patches to get a large amount of ROVLib compilable with the GCCSDK, and I will be integrating them over the next two days.

2002-14-02
I am going on holiday for two weeks from 2002-17-02. I will try to be contactable, but there may be delays.

2017-08-20
Well, it's been a long time... I've now got the code compiling with GCCSDK on Linux, and I've built a couple of the tutorials.

2017-09-09
In the GCCSDK version, I've now added the necessary code to allow it to be safely included in C++ programs. I also found that I'd missed the #ifdef for template.h, so that's now added.

2017-09-09
I've now enabled an SVN server for access to the source. I'll add some other bits later (such as the tutorials).

Contacting me

If you wish to contact me, then you can do so at jason @ tribbeck.com.