E17 Edgar Gadgets Loader

This is the E17 module that load and manage simple edje file (called Gadgets).

How it works

The module don't need configurations, simply enable it from the enlightenment module config dialog.

Once loaded the module will monitor at two directories: ~/.e/e/gadgets and <e_prefix>/share/enlightenment/data/gadgets. The first (the user gadgets directory) take precedence.

All the edje file found in those directories will be exposed as they was native E17 modules. So you can put your edje files (Gadgets) on your E17 desktop or in a shelf, like they was normal modules.

The Protocol (or the API)

You can use any existing edje file as a gadget, but if you want some kind of control over the gadget you must follow the following spec.

How to write a Gadget

The best way to start writing your own gadget is to start from the skeleton gadget, it's the Ruler (HalloWorld). Get it and start editing, there are a simple Makefile in the source, just change the name of the gadget there. Then you can use make, make install and make clean to generate your gadget.

The Ruler EDC file is full of documentation and all the Edgar functions are explained there. You can see the ruler.edc and ruler.embryo files online directly from cvs :)

Download

svn checkout http://e17mods.googlecode.com/svn/trunk/MODULES/edgar

Install

To compile and install the module use the usual:

./autogen
make
sudo make install

TODO

• Add new API message "EDGAR_VISIBLE" and "EDGAR_OBSCURED" to save calculations when the gadget is not visible.