Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

Using plugins

You can extend the capabilities of Source’ by adding new component models or data processing tools. Some of these "plugin" tools extend Source’s user interface, or add additional steps to the Geographic Wizard. Other plugins, especially those written by third parties, may look and operate differently from the normal user interface.

When installing plugins in Source, you must have administrator access on your computer. Plugins that are installed as part of Source are located in the plugins folder (C:\Program Files\eWater\Source\Plugins). They are files which have a .DLL or .EXE extension, and work with specific versions of Source. Plugins that are external to Source, and must be downloaded from the Internet must be handled differently. Refer to Externally created plugins edit for more information.

Many of the existing eWater CRC Toolkit tools (or components of these tools) can be used as Source plugins; however, you must ensure that the plugin version is compatible with the Source version. In other words, the plugin .dll files have been compiled against the Source version that the plugin is to be used with. It is good practice to copy external or third party plugins to the corresponding plugins folder prior to loading the plugin into Source.

Note Ensure that there are no projects open prior to loading plugins. Refer to Plugins related edit for more information.

To load a new plugin:

  • Choose Tools » Plugin Manager to open the Plugin manager (Figure 209 edit);
  • Click Add and in the plugins folder (usually C:\Program Files\eWater\Source version\Plugins), select the plugin and click Open; and
  • Click Close.

Note that if a plugin is required to run the project, but not loaded, an error appears asking if you want to keep loading the project without loading the plugin first. If the plugin is important to the project, Source might have problems running. The error tells you the name of the plugin that was used. An example of this is shown in Figure 210 edit, indicating that the HargreavesET plugin is missing.

There are several plugins included with the Source that have been verified by the Source development team. This documentation is only developed and maintained for these included plugins.

Writing your own plugins

When you install Source, instructions for writing your own plugins are included along with a series of templates to help you get started. Under Windows XP, the standard location is:

C:\Program Files\Source n.n.n.n\Plugins\ExamplePlugins.zip

Under Windows 7, the standard location is:

C:\Program Files\eWater\Source n.n.n.n\Plugins\ExamplePlugins.zip

where n.n.n.n is the version number of Source. If you boot Windows from a different hard disk drive or have otherwise customised your installation, you should make the necessary adjustments.

Please consult your system administrator if local security policies prevent you from accessing this package.

 

  • No labels