title_freepens.plugin
Example plugin for Scalos title bars, written in C
(same as the title_freepens.plugin written in ASM)


******************
* Information    *
* Known problems *
* Contacting us  *
******************


Information
===========
This source code shows you how to create a title bar plugin for
Scalos. Have a look through the source to see what is happening.
These type of plugins are installed through the main "Scalos"
prefs program and normally reside in the "Scalos:Plugins/OOP"
directory.


Basically you are creating a shared library with a single
function. This function returns a pointer to a ScaClassInfo
structure which is initialised with a pointer to the actual
function to call in the h_Entry field of the Hook structure
within the ScaClassInfo structure.


Provided is a makefile for vbcc and a StormC (v3) project file.
The generic makefile should be easy to adapt to any compiler,
and is intended for use with a standard "make" command.


In both the makefile and the project, we have assumed that you
will have the Amiga OS includes located in the include: assign.
Feel free to change this if you have them set up somewhere else.



Known problems
==============
If you cannot get StormC to compile and link the project,
and it produces an error along the lines of:
	Linker warning: data access to code: "_LVORawDoFmt".
	 symbol _LVORawDoFmt
then you could try replacing the amiga.lib in the project file
with the amiga.lib from another compiler. Using the one supplied
with vbcc worked fine for us.


StormC seems to be very picky about where to place the SAVEDS
(__saveds) extension, which also seems to be incompatible with
other compilers. This has meant that we have not used SAVEDS
(__saveds) when compiling for vbcc, although it probably will
not matter as we have not compiled using the small data model.
Perhaps something to take note of though.



Contacting us
=============
If there are any questions, suggestions or other feedback,
send all emails to scalos@satanicdreams.com

Visit the Scalos webpage at: http://scalos.satanicdreams.com