  sample plugin for IMPROV v5.1
---------------------------------

This package contains a skeleton image processing plugin, 
for use in Improv 5.1

If you want to dive right in, start editing where ever you 
find CHANGEME in sample_plugin.c and sample_plugin.h.

Otherwise, read on...


This package should contain the following files:

Makefile         A simple makefile for this example plugin
improv_plugin.h  A header containing all the structs and 
                 prototypes required within the plugin.
sample_plugin.h  The header file for the plugin.
sample_plugin.c  The source file for the plugin.

The package also includes the following headers from the FW 
image handling library, but you will need libFW.so from the 
main package to link against.

FW/labImage.h    Header containing FW structs, and loading, 
                 saving and conversion functions.
FW/labImgDraw.h  Header for drawing functions.
FW/labScale.h    Header for Scale and cut functions
FW/labFont.h     Header for font realted functions


The only files that you need modify are sample_plugin.c and 
sample_plugin.h. These files already contain the skeleton 
code required, and you simply add you code where ever you 
find CHANGEME.

To add a new image processing function, perform the following:

1 - Add code to the IP_Init() function to create another 
    instance of the IP_Op structure for your new function.
    Two examples are provided, but check improv_plugin.h 
    for the details of the structure.
2 - Write your image processing function, using the same 
    prototype as the example functions. You may name the 
    function what ever you wish, but the prototype must 
    be the same. Make sure that your function name matches 
    what you specified for op->process in IP_Init().
3 - Add the prototype for your new function to sample_header.h
4 - Increment the NUMBER_OF_OPERATIONS, defined at the top 
    of sample_plugin.c
5 - Build, run and happy debugging. ;)


**IMPORTANT**
---------------------------------

Improv now uses a BGRa 32 bit format for colour images. This 
change is neccessary to simplify the interface to QT and 
Video 4 Linux. Routinues are provided in the FW library to 
convert between pixel formats.


  Unique ID
---------------------------------

For reference, the included Improv plugins have the following 
unique IDs. The application will complain if you try and load 
to plugins with the same ID, so avoid these.

1 - IPL_plugin
2 - LK_plugin
3 - OpticFlow
4 - feat_track
5 - Contour
