NOTE : This project is not currently in development and is totally unsupported. These pages are here for information only.

Level 3 Functions

Declaration

Each function that has been specified in the getLevel3FunctionNames routine must be declared as any other exported C function. The Idea behind the Level 3 functions is that the host software can display a menu item or button for each exported function and the user may select these. The functions can be used for extra camera controls like the setting of resolution, flash etc. All Level 3 functions must be defined in the same way and all must accept the same parameters. The standard declaration is as follows

extern "C" BWindow* functionname(BPoint middle);



Description

Each Level 3 function must receive a single BPoint as its parameter. This will be the center position of the host software's window and can be used to position any dialog boxes that the plugin may wish to display for this function.

The function returns a pointer to a BWindow object which will then be shown by the host software. If the function does not need a dialog box to be shown, then the function should carry out it's operations and then return NULL.

Example Implementation - Kodak DC210 Plugin

BWindow* ConfigureCamera(BPoint middle) { BWindow* ptemp; ptemp = new cameraprops(BRect(middle.x - 184,middle.y - 234, middle.x + 184,middle.y + 234), ComPort); return(ptemp); }