royalbridge

Short:        Use ANY shared library within Arexx progs
Author:       Ivan Sturlic
Uploader:     isturlic public srce hr (Ivan Sturlic)
Type:         util/rexx
Architecture: m68k-amigaos

-----------------------------------------------------------------------------
                                  ROYAL BRIDGE
                        Copyright (c) 1998, Ivan Sturlic
-----------------------------------------------------------------------------
Version 28.26 (26 Apr 1998)

royalbridge.library is an Arexx external function library which acts as
a bridge to any Amiga shared library.

To call the library function royalbridge.library needs to know the library
base, function offset and information about which processor registers to use
for function arguments.

To make coding much easier you can use the Royal Bridge Arexx Preprocessor
which is also included. Arexx preprocessor requires a C compiler which will
be used to access C include files.

When using Arexx preprocessor you write an .app file which is nothing else
but normal Arexx program with some preprocessor commands which will be
replaced by real things in final .rexx file.

For example, to call the exec.library/AllocVec() function you would write:

#call 0 bmap = AllocVec(#{sizeof(struct BitMap)},#{MEMF_CLEAR})

This line would be replaced by preprocessor and would look like:

bmap = rbCall(0 || ' 2ac 1002',40,65536)

CURRENT LIMITATIONS
-------------------
 - It is not possible to call a library function which uses an a5 register
   for its argument
 - Won't work with floating point arguments

HISTORY
-------
 - 26 Apr 1998
   -----------
   First public release