public interface ExtendedPlugInFilter extends PlugInFilter
The sequence of calls to an ExtendedPlugInFilter is the following:
- setup(arg, imp): The filter should return its flags.
- showDialog(imp, command, pfr): The filter should display
the dialog asking for parameters (if any) and do all operations
needed to prepare for processing the individual image(s) (E.g.,
slices of a stack). For preview, a separate thread may call
setNPasses(nPasses) and run(ip) while
the dialog is displayed. The filter should return its flags.
- setNPasses(nPasses): Informs the filter of the number
of calls of run(ip) that will follow.
- run(ip): Processing of the image(s). With the
CONVERT_TO_FLOAT flag, this method will be called for
each color channel of an RGB image. With DOES_STACKS,
it will be called for each slice of a stack.
- setup("final", imp): called only if flag
FINAL_PROCESSING has been specified.
Flag DONE stops this sequence of calls.
| Modifier and Type | Field and Description |
|---|---|
static int |
KEEP_PREVIEW
Set this flag if the last preview image may be kept as a result.
|
CONVERT_TO_FLOAT, DOES_16, DOES_32, DOES_8C, DOES_8G, DOES_ALL, DOES_RGB, DOES_STACKS, DONE, FINAL_PROCESSING, KEEP_THRESHOLD, NO_CHANGES, NO_IMAGE_REQUIRED, NO_UNDO, PARALLELIZE_IMAGES, PARALLELIZE_STACKS, ROI_REQUIRED, SNAPSHOT, STACK_REQUIRED, SUPPORTS_MASKING| Modifier and Type | Method and Description |
|---|---|
void |
setNPasses(int nPasses)
This method is called by ImageJ to inform the plugin-filter
about the passes to its run method.
|
int |
showDialog(ImagePlus imp,
java.lang.String command,
PlugInFilterRunner pfr)
This method is called after
setup(arg, imp) unless the
DONE flag has been set. |
run, setupstatic final int KEEP_PREVIEW
PARALLELIZE_STACKS flag.int showDialog(ImagePlus imp, java.lang.String command, PlugInFilterRunner pfr)
setup(arg, imp) unless the
DONE flag has been set.imp - The active image already passed in the
setup(arg, imp) call. It will be null, however, if
the NO_IMAGE_REQUIRED flag has been set.command - The command that has led to the invocation of
the plugin-filter. Useful as a title for the dialog.pfr - The PlugInFilterRunner calling this plugin-filter.
It can be passed to a GenericDialog by addPreviewCheckbox
to enable preview by calling the run(ip) method of this
plugin-filter. pfr can be also used later for calling back
the PlugInFilterRunner, e.g., to obtain the slice number
currently processed by run(ip).PlugInFilter and
ExtendedPlugInFilter.void setNPasses(int nPasses)
CONVERT_TO_FLOAT
has been specified). When processing a stack, it is the number
of slices to be processed (minus one, if one slice has been
processed for preview before), and again, 3 times that number
for RGB images processed with CONVERT_TO_FLOAT.