#
Visualiser Providers

###### Identifier:

org.eclipse.contribution.visualiser.providers

###### Description:

This extension point is used to plug in to the Visualiser by specifying a provider. Each extension must provide an implementor of org.eclipse.contribution.visualiser.interfaces.IContentProvider and an implementor of org.eclipse.contribution.visualiser.interfaces.IMarkupProvider.

###### Configuration Markup:

<!ELEMENT extension (provider)>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED>

<!ELEMENT provider EMPTY>

<!ATTLIST provider

contentProviderClass CDATA #REQUIRED

id CDATA #REQUIRED

name CDATA #REQUIRED

description CDATA #IMPLIED

markupProviderClass CDATA #REQUIRED

title CDATA #IMPLIED

priority CDATA #IMPLIED

paletteid CDATA #IMPLIED

emptyMessage CDATA #IMPLIED>

Provider definition.

- contentProviderClass - Content Provider class (must implement org.eclipse.contribution.visualiser.interface.IContentProvider).
- id - Unique ID for the provider
- name - Name of the provider, to be used in the Visualiser preference page.
- description - Description of the provider, to be used in the Visualiser preference page.
- markupProviderClass - Markup provider class (must implement org.eclipse.contribution.visualiser.interfaces.IMarkupProvider).
- title - Title, to be used in the Visualiser view's title.
- priority - Integer value where 0 is the lowest, stating the priority of the provider in the list on the Visualiser preference page. This value also determines which of the available providers is selected by default.
- paletteid - If present, this defines the default palette to be used by this provider
- emptyMessage - Empty Message - to be displayed in the Visualiser view when no data is available from the content provider. Should ideally direct the user to how to get some data into the view (e.g. "Click on something in the navigator view").

###### Examples:

An example of a simple file-based provider:

<extension
id="file_providers"
name="File Providers"
point="org.eclipse.contribution.visualiser.providers">
<contentProvider
markupclass="org.eclipse.contribution.visualiser.interfaces.simpleImpl.FileMarkupProvider"
name="File content provider"
priority="0"
description="Simple test provider that reads flat file to determine groups, members and marks"
class="org.eclipse.contribution.visualiser.interfaces.simpleImpl.FileContentProvider"
id="filecontentprovider">
</contentProvider>
</extension>

###### Supplied Implementation:

Several implementation examples are included with the Visualiser