- NDStdArrays.adl
-
- 
- This plugin is a tool for converting the color mode of NDArray data. -
-- NDPluginColorConvert inherits from NDPluginDriver. NDPluginColorConvert receives - an input NDArray with one color mode and outputs another NDArray with a (potentially) - different color mode. All other attributes of the array are preserved. The NDPluginStdArrays - public interface is defined in NDPluginColorConvert.h as follows:
+ + ++ This plugin is a tool for converting the color mode of NDArray data. +
++ NDPluginColorConvert inherits from NDPluginDriver. NDPluginColorConvert receives + an input NDArray with one color mode and outputs another NDArray with a (potentially) + different color mode. All other attributes of the array are preserved. The NDPluginColorConvert + public interface is defined in NDPluginColorConvert.h as follows:
-class NDPluginColorConvert : public NDPluginDriver {
-public:
- NDPluginColorConvert(const char *portName, int queueSize, int blockingCallbacks,
- const char *NDArrayPort, int NDArrayAddr,
- size_t maxMemory);
-
- /* These methods override the virtual methods in the base class */
- void processCallbacks(NDArray *pArray);
- asynStatus drvUserCreate(asynUser *pasynUser, const char *drvInfo,
- const char **pptypeName, size_t *psize);
-
- /* These methods are just for this class */
- template < typename epicstype > void convertColor(NDArray *pArray);
-};
+class NDPluginColorConvert : public NDPluginDriver {
+public:
+ NDPluginColorConvert(const char *portName, int queueSize, int blockingCallbacks,
+ const char *NDArrayPort, int NDArrayAddr,
+ size_t maxMemory);
+
+ /* These methods override the virtual methods in the base class */
+ void processCallbacks(NDArray *pArray);
+ asynStatus drvUserCreate(asynUser *pasynUser, const char *drvInfo,
+ const char **pptypeName, size_t *psize);
+
+ /* These methods are just for this class */
+ template < typename epicstype > void convertColor(NDArray *pArray);
+};
...
}
-
- - NDPluginStdArrays defines the following parameters. It also implements all of the - standard plugin parameters from NDPluginDriver - . The EPICS database NDColorConvert.template provides access to these parameters, - listed in the following table. -
-| - Parameter Definitions in NDPluginColorConvert.h and EPICS Record Definitions in - NDColorConvert.template | -||||||
| - Enum name | -- asyn interface | -- Access | -- Description | -- drvUser string | -- EPICS record name | -- EPICS record type | -
|---|---|---|---|---|---|---|
| - NDPluginColorConvertColorModeOut | -- asynInt32 | -- r/w | -- The output color mode. | -- COLOR_MODE_OUT | -
- $(P)$(R)ColorModeOut
- - $(P)$(R)ColorModeOut_RBV - |
-
- mbbo
- - mbbi |
-
- NDPluginColorConvert currently supports the following conversions:
-- If the input color mode and output color mode are not one of these supported conversion - combinations then the output array is simply a copy of the input array and no conversion - is performed.
-- The NDPluginColorConvert plugin is created with the following command, either from - C/C++ or from the EPICS IOC shell. -
-drvNDColorConvertConfigure(const char *portName, int queueSize, int blockingCallbacks, - const char *NDArrayPort, int NDArrayAddr, size_t maxMemory) --
| - Argument | -- Description | -
|---|---|
- portName |
- - The name of the asyn port for this plugin. - | -
- queueSize |
- - The maximum number of NDArray objects that can be queued for processing. Passed - to the NDPluginDriver base class constructor. - | -
- blockingCallbacks |
- - Flag controlling whether callbacks block. Passed to the NDPluginDriver base class - constructor. - | -
- NDArrayPort |
- - The name of the asyn port of the driver that will provide the NDArray data. Passed - to the NDPluginDriver base class constructor. - | -
- NDArrayAddr |
- - The asyn addr of the asyn port of the driver that will provide the NDArray data. - Passed to the NDPluginDriver base class constructor. - | -
- maxMemory |
- - Maximum number of bytes of memory to be allocated from the NDArrayPool. Passed to - the constructor for the NDPluginDriver base class. The NDStdArrays plugin allocates - 2 NDArray objects, so this should be at least twice the size of the largest NDArray - to be used. | -
- The following is the MEDM screen that provides access to the parameters in NDPluginDriver.h - and NDPluginStdArrays.h through records in NDPluginBase.template and NDStdArrays.template. - This is the MEDM screen that is normally used to control the display of images via - EPICS channel access. -
-
-
- There is an IDL procedure called
- epics_ad_display that can be used to display 2-dimensional array data that
- the NDStdArrays plugin sends to EPICS. This IDL client is available as source code
- (which requires an IDL license), and also as a pre-built IDL .sav file that can
- be run for free under the IDL Virtual Machine. This IDL program can run on any machine
- that IDL runs on, and that has the ezcaIDL shareable library built for it. This
- includes Windows, Linux, Solaris, and Mac. epics_ad_display is included
- in the CARS IDL imaging
- software.
-
- The control window for epics_ad_display is shown below. It has a field
- to input the base name of the EPICS PVs with the image data. It also has fields
- to enable/display the IDL display update, to change the display mode, to autoscale
- the intensity, and to invert the image in the Y direction. If autoscale is set to
- No then manual scaling can be entered in the Min and Max fields. The number of frames
- per second actually being displayed by IDL is shown. There is a status window that
- shows whether the EPICS PVs are connected and the time the last was array received,
- updated once per second.
-
- 
- epics_ad_display can use the simple IDL routine tv to
- display the images. This is the fastest mode, and results in a non-scalable unadorned
- window.
tv routine.
- 
- epics_ad_display can also use the routine
- image_display.pro to display the images. This routine displays row and column
- profiles as the cursor is moved. It allows changing the color lookup tables, and
- zooming in (right mouse click) and out (left mouse click). The following is an example
- of image_display displaying an image from the simulation detector.
- 
- Stephen Mudie at the Australian Synchrotron has written a very nice IDL client to - display the EPICS images from the Flea Firewire cameras. This client should be converted - to display the data from this areaDetector plugin. -
- - + ++ NDPluginColorConvert defines the following parameters. It also implements all of + the standard plugin parameters from NDPluginDriver + . The EPICS database NDColorConvert.template provides access to these parameters, + listed in the following table. +
+| + Parameter Definitions in NDPluginColorConvert.h and EPICS Record Definitions in + NDColorConvert.template | +||||||
| + Enum name | ++ asyn interface | ++ Access | ++ Description | ++ drvUser string | ++ EPICS record name | ++ EPICS record type | +
|---|---|---|---|---|---|---|
| + NDPluginColorConvertColorModeOut | ++ asynInt32 | ++ r/w | ++ The output color mode (NDColorMode_t). | ++ COLOR_MODE_OUT | +
+ $(P)$(R)ColorModeOut
+ + $(P)$(R)ColorModeOut_RBV + |
+
+ mbbo
+ + mbbi |
+
+ NDPluginColorConvert currently supports the following conversions:
++ The Bayer color conversion supports the 4 Bayer formats (NDBayerRGGB, NDBayerGBRG, + NDBayerGRBG, NDBayerBGGR) defined in NDArray.h. If the input color mode and output + color mode are not one of these supported conversion combinations then the output + array is simply a copy of the input array and no conversion is performed.
++ The NDPluginColorConvert plugin is created with the following command, either from + C/C++ or from the EPICS IOC shell. +
+int drvNDColorConvertConfigure(const char *portName, int queueSize, int blockingCallbacks, + const char *NDArrayPort, int NDArrayAddr, + int maxBuffers, size_t maxMemory); ++
| + Argument | ++ Description | +
|---|---|
+ portName |
+ + The name of the asyn port for this plugin. + | +
+ queueSize |
+ + The maximum number of NDArray objects that can be queued for processing. Passed + to the NDPluginDriver base class constructor. + | +
+ blockingCallbacks |
+ + Flag controlling whether callbacks block. Passed to the NDPluginDriver base class + constructor. + | +
+ NDArrayPort |
+ + The name of the asyn port of the driver that will provide the NDArray data. Passed + to the NDPluginDriver base class constructor. + | +
+ NDArrayAddr |
+ + The asyn addr of the asyn port of the driver that will provide the NDArray data. + Passed to the NDPluginDriver base class constructor. + | +
+ maxBuffers |
+ + Maximum number of NDArray buffers to be created for plugin callbacks, i.e. for plugins + that will be getting called from this plugin. Passed to the constructor for the + NDPluginDriver base class. | +
+ maxMemory |
+ + Maximum number of bytes of memory to be allocated from the NDArrayPool. Passed to + the constructor for the NDPluginDriver base class. | +
+ The following is the MEDM screen that provides access to the parameters in NDPluginDriver.h + and NDPluginColorConvert.h through records in NDPluginBase.template and NDColorConvert.template. +
+
+ 