diff --git a/documentation/pluginDoc.html b/documentation/pluginDoc.html index 634b93d..718d4fb 100755 --- a/documentation/pluginDoc.html +++ b/documentation/pluginDoc.html @@ -10,7 +10,7 @@

areaDetector Plugins

- September 28, 2012

+ October 1, 2012

Mark Rivers

@@ -22,6 +22,7 @@
  • Overview
  • NDPluginDriver
  • Guidelines and rules for plugins
  • +
  • commonPlugins.cmd
  • NDPluginColorConvert
  • NDPluginFile
  • NDPluginOverlay
  • @@ -228,7 +229,7 @@ r/o - The number of free queue lelements. + The number of free queue elements. QUEUE_FREE @@ -236,6 +237,23 @@ longin + + + NDPluginDriver
    + QueueUse + + N/A + + r/o + + The number of used queue elements. + + N/A + + $(P)$(R)QueueUse + + calc + NDArray pool size and status (only for plugins that generate NDArrays for use by @@ -720,11 +738,28 @@ because it does not modify it.
  • Plugins must release their mutex by calling this->unlock() when they do time-consuming operations. If they do not then they will not be able to queue new NDArrays callbacks - or obtain new parameter values. Obviously they must mot access memory locations + or obtain new parameter values. Obviously they must not access memory locations that other threads could modify during this time, so they should only access local variables, not class variables (which includes the parameter library).
  • If plugins generate new or modified NDArrays then they must call doCallbacksGenericPointer() so that registered clients can get the values of the new arrays.
  • +

    + commonPlugins.cmd

    +

    + The areaDetector iocBoot directory contains a file called commonPlugins.cmd. This + file is loaded by all of the example driver IOC startup scripts. It loads a set + of plugins which are typically useful for detectors IOCs. Each detector medm screen + has links to related displays for each of the common plugins. While this set of + plugins is often useful and sufficient, users are free to add or remove plugins + from this set for their own IOCs. New medm displays will typically need to be created + if that is done, to have the required links to related displays.

    +

    + The following medm screen shows the status of all of the common plugins at a glance, + with links to bring up the detailed screen for each.

    +
    +

    + commonPlugins.adl

    + commonPlugins.png