
CONTENTS OF THE DISK
--------------------

This disk contains support material and information necessary when 
creating a shared library for interfacing frame buffers, graphics
adapters etc. custom display devices from Real 3D v.1.4.1.

The file 'Document' contains information of how to create the library 
and how to use Real 3D's features which are related to custom display 
devices.

The latest beta version of Real 3D v.1.4.1 is also included. Although
data saving functions of the editor are removed, the version is sufficient
for testing the functionality of the interface library. The program 
version is the 'turbo' version, which requires 68020/30/40 and a math 
coprocessor.

The disk also contains a test scene 'TestScene' including a simple test 
object and suitable basic rendering options for frame buffer usage.

The drawer 'Source' contains an example implementation of the interface
library (for ACS Harlequin), written in SAS C. This example can be used 
freely. The following files are included:

    - hr_r3d.library.asm -- contains library initialization routines and
      entry functions, which push arguments into stack and call the
      actual C language routines contained in the file hrcode.c.
        
    - hrcode.c -- the actual library routines written in C.

    - dspdrvbase.h -- the library base definitions for C.

    - dspdrvbase.i -- the library base definitions for assembler.

    - asmsupp.i  -- a collection of useful assembler macros
 
    - dspdrv.fd  -- the .fd file defining the structure of the library

    - hrlibrary.with -- a link file for linking the library with blink


If you want to create the library by modifying this example, redefine the
library name strings in the file hr_r3d.library.asm and reassemble the file,
redefine the contents of the C functions in the file hrcode.c and recompile 
it, and finally redefine the library name in the link file and link the 
library. 
