Package gov.nih.mipav.view.dialogs
Class JDialogFacetModel
- java.lang.Object
- 
- java.awt.Component
- 
- java.awt.Container
- 
- java.awt.Window
- 
- java.awt.Dialog
- 
- javax.swing.JDialog
- 
- gov.nih.mipav.view.dialogs.JDialogBase
- 
- gov.nih.mipav.view.dialogs.JDialogScriptableBase
- 
- gov.nih.mipav.view.dialogs.JDialogFacetModel
 
 
 
 
 
 
 
 
- 
- All Implemented Interfaces:
- AlgorithmInterface,- ScriptableActionInterface,- DialogDefaultsInterface,- ActionDiscovery,- java.awt.event.ActionListener,- java.awt.event.FocusListener,- java.awt.event.ItemListener,- java.awt.event.WindowListener,- java.awt.image.ImageObserver,- java.awt.MenuContainer,- java.io.Serializable,- java.util.EventListener,- javax.accessibility.Accessible,- javax.swing.RootPaneContainer,- javax.swing.WindowConstants
 
 public class JDialogFacetModel extends JDialogScriptableBase implements AlgorithmInterface, java.awt.event.ItemListener, ActionDiscovery, ScriptableActionInterface Dialog to get user input, then call the algorithm. The user has the option to generate a new image or replace the source image. It should be noted that the algorithms are executed in their own threads.- Version:
- 1.0 April 15, 2016
- Author:
- William Gandler
- See Also:
- AlgorithmFacetModel, Serialized Form
 
- 
- 
Nested Class Summary- 
Nested classes/interfaces inherited from class gov.nih.mipav.view.dialogs.JDialogBaseJDialogBase.CancelAction, JDialogBase.HelpAction, JDialogBase.OKAction
 - 
Nested classes/interfaces inherited from class javax.swing.JDialogjavax.swing.JDialog.AccessibleJDialog
 - 
Nested classes/interfaces inherited from class java.awt.Dialogjava.awt.Dialog.AccessibleAWTDialog, java.awt.Dialog.ModalExclusionType, java.awt.Dialog.ModalityType
 - 
Nested classes/interfaces inherited from class java.awt.Windowjava.awt.Window.AccessibleAWTWindow, java.awt.Window.Type
 
- 
 - 
Field SummaryFields Modifier and Type Field Description private javax.swing.ButtonGroupalgoGroupDOCUMENT ME!private javax.swing.JPanelalgoPanelDOCUMENT ME!private doublealphaprivate intblockSidestatic intCORNER_DETECTORprivate javax.swing.JRadioButtoncornerDetectorprivate javax.swing.ButtonGroupdestinationGroupDOCUMENT ME!private javax.swing.JPaneldestinationPanelDOCUMENT ME!private intdisplayLocDOCUMENT ME!static intFACET_BASED_PEAK_NOISE_REMOVALUse serialVersionUID for interoperability.private AlgorithmFacetModelfacetAlgoDOCUMENT ME!static intGRADIENT_BASED_FACET_EDGE_DETECTIONprivate doublegradientDirectionThresholdprivate javax.swing.JRadioButtongradientEdgeprivate ModelImageimageDOCUMENT ME!static intINTEGRATED_DIRECTIONAL_DERIVATIVE_ANGLEstatic intINTEGRATED_DIRECTIONAL_DERIVATIVE_MAGNITUDEprivate javax.swing.JRadioButtonintegratedAngleDOCUMENT ME!private javax.swing.JRadioButtonintegratedMagnitudestatic intITERATED_FACET_MODELprivate javax.swing.JRadioButtoniteratedModelDOCUMENT ME!private javax.swing.JLabellabelAlphaprivate javax.swing.JLabellabelThresholdprivate javax.swing.JPanelmainPanelDOCUMENT ME!private javax.swing.JRadioButtonmask11private javax.swing.JRadioButtonmask13private javax.swing.JRadioButtonmask3private javax.swing.JRadioButtonmask5private javax.swing.JRadioButtonmask7private javax.swing.JRadioButtonmask9private javax.swing.ButtonGroupmaskGroupDOCUMENT ME!private javax.swing.JPanelmaskPanelDOCUMENT ME!private javax.swing.JRadioButtonnewImageDOCUMENT ME!private javax.swing.JRadioButtonnoiseRemovalDOCUMENT ME!private javax.swing.JRadioButtonreplaceImageDOCUMENT ME!private ModelImageresultImageDOCUMENT ME!private introutineprivate javax.swing.JTextFieldtextAlphaprivate javax.swing.JTextFieldtextThresholdprivate java.lang.String[]titlesDOCUMENT ME!private ViewUserInterfaceuserInterfaceDOCUMENT ME!static intZERO_CROSSING_EDGE_DETECTORprivate javax.swing.JRadioButtonzeroDetector- 
Fields inherited from class gov.nih.mipav.view.dialogs.JDialogScriptableBasedisplayInNewFrame, isComplete, scriptParameters
 - 
Fields inherited from class gov.nih.mipav.view.dialogs.JDialogBaseapplyButton, bar, cancelButton, cancelFlag, closeButton, HELP, helpButton, mainDialogPanel, NEW, OKButton, parentFrame, progressBar, REPLACE, runInSeparateThread, runningScriptFlag, runQuiet, serif12, serif12B, voiManager
 - 
Fields inherited from class javax.swing.JDialogaccessibleContext, rootPane, rootPaneCheckingEnabled
 - 
Fields inherited from class java.awt.ComponentBOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
- 
 - 
Constructor SummaryConstructors Constructor Description JDialogFacetModel()Empty constructor needed for dynamic instantiation (used during scripting).JDialogFacetModel(ModelImage im)Used primarily for the script to store variables and run the algorithm.JDialogFacetModel(java.awt.Frame theParentFrame, ModelImage im)Creates a new JDialogFacetModel object.
 - 
Method SummaryAll Methods Instance Methods Concrete Methods Modifier and Type Method Description voidactionPerformed(java.awt.event.ActionEvent event)Closes dialog box when the OK button is pressed and calls the algorithm.voidalgorithmPerformed(AlgorithmBase algorithm)This method is required if the AlgorithmPerformed interface is implemented.protected voidcallAlgorithm()Once all the necessary variables are set, call the Frequency Filter algorithm based on what type of image this is and whether or not there is a separate destination image.ParameterTablecreateInputParameters()Returns a table listing the input parameters of this algorithm (which should match up with the scripting parameters used insetGUIFromParams()).ParameterTablecreateOutputParameters()Returns a table listing the output parameters of this algorithm (usually just labels used to obtain output image names later).protected voiddoPostAlgorithmActions()Store the result image in the script runner's image table now that the action execution is finished.ActionMetadatagetActionMetadata()Return meta-information about this discoverable action for categorization and labeling purposes.java.lang.StringgetOutputImageName(java.lang.String imageParamName)Returns the name of an image output by this algorithm, the image returned depends on the parameter label given (which can be used to retrieve the image object from the image registry).ModelImagegetResultImage()Accessor that returns the image.private voidinit()Sets up the GUI (panels, buttons, etc) and displays it on the screen.booleanisActionComplete()Returns whether the action has successfully completed its execution.private voidsetAlpha(double alpha)private voidsetBlockSide(int blockSide)voidsetDisplayLocNew()Accessor that sets the display loc variable to new, so that a new image is created once the algorithm completes.voidsetDisplayLocReplace()Accessor that sets the display loc variable to replace, so the current image is replaced once the algorithm completes.private voidsetGradientDirectionThreshold(double gradientDirectionThreshold)protected voidsetGUIFromParams()Set the dialog GUI using the script parameters while running this algorithm as part of a script.private voidsetRoutine(int routine)private booleansetVariables()Use the GUI results to set up the variables needed to run the algorithm.protected voidstoreParamsFromGUI()Record the parameters just used to run this algorithm in a script.- 
Methods inherited from class gov.nih.mipav.view.dialogs.JDialogScriptableBasegetDialogActionString, insertScriptLine, isComplete, scriptRun, setComplete
 - 
Methods inherited from class gov.nih.mipav.view.dialogs.JDialogBasebuildApplyButton, buildButtons, buildCancelButton, buildCancelButton, buildCloseButton, buildHelpButton, buildImageComboBox, buildOKButton, buildOKButton, buildOKCancelButtons, buildTitledBorder, buildTitledBorder, createLabel, createProgressBar, createProgressBar, createTextField, focusGained, focusLost, getDialogName, isCancelled, isQuietRunning, isRunInSeparateThread, isScriptRunning, itemStateChanged, loadDefaults, loadDefaults, makeImageName, makeString, openNewFrame, saveDefaults, saveDefaults, setLeftHandSystem, setQuietRunning, setScriptRunning, setSeparateThread, setVisible, setVisible, setVisibleMenuBar, setVisibleStandard, setVOIManager, setWCSystem, testParameter, testParameterMin, updateFFTFileInfo, updateFileInfo, updateFileInfoOtherModality, updateFileInfoStatic, updateFileInfoStatic, updateFileTypeInfo, updateFileTypeInfo, windowActivated, windowClosed, windowClosing, windowDeactivated, windowDeiconified, windowIconified, windowOpened
 - 
Methods inherited from class javax.swing.JDialogaddImpl, createRootPane, dialogInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getGraphics, getJMenuBar, getLayeredPane, getRootPane, getTransferHandler, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, repaint, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, setTransferHandler, update
 - 
Methods inherited from class java.awt.DialogaddNotify, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setBackground, setModal, setModalityType, setOpacity, setResizable, setShape, setTitle, setUndecorated, show, toBack
 - 
Methods inherited from class java.awt.WindowaddPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, toFront
 - 
Methods inherited from class java.awt.Containeradd, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, validate, validateTree
 - 
Methods inherited from class java.awt.Componentaction, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setMixingCutoutShape, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
 - 
Methods inherited from class java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 - 
Methods inherited from interface gov.nih.mipav.view.dialogs.ActionDiscoveryscriptRun
 - 
Methods inherited from interface gov.nih.mipav.model.scripting.ScriptableActionInterfaceinsertScriptLine, scriptRun
 
- 
 
- 
- 
- 
Field Detail- 
FACET_BASED_PEAK_NOISE_REMOVALpublic static final int FACET_BASED_PEAK_NOISE_REMOVAL Use serialVersionUID for interoperability.- See Also:
- Constant Field Values
 
 - 
ITERATED_FACET_MODELpublic static final int ITERATED_FACET_MODEL - See Also:
- Constant Field Values
 
 - 
GRADIENT_BASED_FACET_EDGE_DETECTIONpublic static final int GRADIENT_BASED_FACET_EDGE_DETECTION - See Also:
- Constant Field Values
 
 - 
ZERO_CROSSING_EDGE_DETECTORpublic static final int ZERO_CROSSING_EDGE_DETECTOR - See Also:
- Constant Field Values
 
 - 
INTEGRATED_DIRECTIONAL_DERIVATIVE_ANGLEpublic static final int INTEGRATED_DIRECTIONAL_DERIVATIVE_ANGLE - See Also:
- Constant Field Values
 
 - 
INTEGRATED_DIRECTIONAL_DERIVATIVE_MAGNITUDEpublic static final int INTEGRATED_DIRECTIONAL_DERIVATIVE_MAGNITUDE - See Also:
- Constant Field Values
 
 - 
CORNER_DETECTORpublic static final int CORNER_DETECTOR - See Also:
- Constant Field Values
 
 - 
blockSideprivate int blockSide 
 - 
alphaprivate double alpha 
 - 
routineprivate int routine 
 - 
gradientDirectionThresholdprivate double gradientDirectionThreshold 
 - 
gradientEdgeprivate javax.swing.JRadioButton gradientEdge 
 - 
labelAlphaprivate javax.swing.JLabel labelAlpha 
 - 
textAlphaprivate javax.swing.JTextField textAlpha 
 - 
zeroDetectorprivate javax.swing.JRadioButton zeroDetector 
 - 
integratedAngleprivate javax.swing.JRadioButton integratedAngle DOCUMENT ME!
 - 
integratedMagnitudeprivate javax.swing.JRadioButton integratedMagnitude 
 - 
cornerDetectorprivate javax.swing.JRadioButton cornerDetector 
 - 
labelThresholdprivate javax.swing.JLabel labelThreshold 
 - 
textThresholdprivate javax.swing.JTextField textThreshold 
 - 
algoGroupprivate javax.swing.ButtonGroup algoGroup DOCUMENT ME!
 - 
algoPanelprivate javax.swing.JPanel algoPanel DOCUMENT ME!
 - 
destinationGroupprivate javax.swing.ButtonGroup destinationGroup DOCUMENT ME!
 - 
destinationPanelprivate javax.swing.JPanel destinationPanel DOCUMENT ME!
 - 
displayLocprivate int displayLoc DOCUMENT ME!
 - 
maskPanelprivate javax.swing.JPanel maskPanel DOCUMENT ME!
 - 
mask3private javax.swing.JRadioButton mask3 
 - 
mask5private javax.swing.JRadioButton mask5 
 - 
mask7private javax.swing.JRadioButton mask7 
 - 
mask9private javax.swing.JRadioButton mask9 
 - 
mask11private javax.swing.JRadioButton mask11 
 - 
mask13private javax.swing.JRadioButton mask13 
 - 
maskGroupprivate javax.swing.ButtonGroup maskGroup DOCUMENT ME!
 - 
facetAlgoprivate AlgorithmFacetModel facetAlgo DOCUMENT ME!
 - 
iteratedModelprivate javax.swing.JRadioButton iteratedModel DOCUMENT ME!
 - 
imageprivate ModelImage image DOCUMENT ME!
 - 
mainPanelprivate javax.swing.JPanel mainPanel DOCUMENT ME!
 - 
newImageprivate javax.swing.JRadioButton newImage DOCUMENT ME!
 - 
replaceImageprivate javax.swing.JRadioButton replaceImage DOCUMENT ME!
 - 
resultImageprivate ModelImage resultImage DOCUMENT ME!
 - 
titlesprivate java.lang.String[] titles DOCUMENT ME!
 - 
userInterfaceprivate ViewUserInterface userInterface DOCUMENT ME!
 - 
noiseRemovalprivate javax.swing.JRadioButton noiseRemoval DOCUMENT ME!
 
- 
 - 
Constructor Detail- 
JDialogFacetModelpublic JDialogFacetModel() Empty constructor needed for dynamic instantiation (used during scripting).
 - 
JDialogFacetModelpublic JDialogFacetModel(ModelImage im) Used primarily for the script to store variables and run the algorithm. No actual dialog will appear but the set up info and result image will be stored here.- Parameters:
- im- Source image.
 
 - 
JDialogFacetModelpublic JDialogFacetModel(java.awt.Frame theParentFrame, ModelImage im)Creates a new JDialogFacetModel object.- Parameters:
- theParentFrame- Parent frame.
- im- Source image.
 
 
- 
 - 
Method Detail- 
actionPerformedpublic void actionPerformed(java.awt.event.ActionEvent event) Closes dialog box when the OK button is pressed and calls the algorithm.- Specified by:
- actionPerformedin interface- java.awt.event.ActionListener
- Overrides:
- actionPerformedin class- JDialogBase
- Parameters:
- event- Event that triggers function.
 
 - 
algorithmPerformedpublic void algorithmPerformed(AlgorithmBase algorithm) This method is required if the AlgorithmPerformed interface is implemented. It is called by the algorithms when it has completed or failed to to complete, so that the dialog can be display the result image and/or clean up.- Specified by:
- algorithmPerformedin interface- AlgorithmInterface
- Parameters:
- algorithm- Algorithm that caused the event.
 
 - 
getResultImagepublic ModelImage getResultImage() Accessor that returns the image.- Returns:
- The result image.
 
 - 
setDisplayLocNewpublic void setDisplayLocNew() Accessor that sets the display loc variable to new, so that a new image is created once the algorithm completes.
 - 
setDisplayLocReplacepublic void setDisplayLocReplace() Accessor that sets the display loc variable to replace, so the current image is replaced once the algorithm completes.
 - 
callAlgorithmprotected void callAlgorithm() Once all the necessary variables are set, call the Frequency Filter algorithm based on what type of image this is and whether or not there is a separate destination image.- Specified by:
- callAlgorithmin class- JDialogScriptableBase
 
 - 
setRoutineprivate void setRoutine(int routine) - Parameters:
- routine-
 
 - 
setBlockSideprivate void setBlockSide(int blockSide) - Parameters:
- blockSide-
 
 - 
setAlphaprivate void setAlpha(double alpha) - Parameters:
- alpha-
 
 - 
setGradientDirectionThresholdprivate void setGradientDirectionThreshold(double gradientDirectionThreshold) - Parameters:
- gradientDirectionThreshold-
 
 - 
doPostAlgorithmActionsprotected void doPostAlgorithmActions() Store the result image in the script runner's image table now that the action execution is finished.- Overrides:
- doPostAlgorithmActionsin class- JDialogScriptableBase
 
 - 
setGUIFromParamsprotected void setGUIFromParams() Set the dialog GUI using the script parameters while running this algorithm as part of a script.- Specified by:
- setGUIFromParamsin class- JDialogScriptableBase
 
 - 
storeParamsFromGUIprotected void storeParamsFromGUI() throws ParserExceptionRecord the parameters just used to run this algorithm in a script.- Specified by:
- storeParamsFromGUIin class- JDialogScriptableBase
- Throws:
- ParserException- If there is a problem creating/recording the new parameters.
 
 - 
initprivate void init() Sets up the GUI (panels, buttons, etc) and displays it on the screen.
 - 
setVariablesprivate boolean setVariables() Use the GUI results to set up the variables needed to run the algorithm.- Returns:
- trueif parameters set successfully,- falseotherwise.
 
 - 
getActionMetadatapublic ActionMetadata getActionMetadata() Return meta-information about this discoverable action for categorization and labeling purposes.- Specified by:
- getActionMetadatain interface- ActionDiscovery
- Returns:
- Metadata for this action.
 
 - 
createInputParameterspublic ParameterTable createInputParameters() Returns a table listing the input parameters of this algorithm (which should match up with the scripting parameters used insetGUIFromParams()).- Specified by:
- createInputParametersin interface- ActionDiscovery
- Returns:
- A parameter table listing the inputs of this algorithm.
 
 - 
createOutputParameterspublic ParameterTable createOutputParameters() Returns a table listing the output parameters of this algorithm (usually just labels used to obtain output image names later).- Specified by:
- createOutputParametersin interface- ActionDiscovery
- Returns:
- A parameter table listing the outputs of this algorithm.
 
 - 
getOutputImageNamepublic java.lang.String getOutputImageName(java.lang.String imageParamName) Returns the name of an image output by this algorithm, the image returned depends on the parameter label given (which can be used to retrieve the image object from the image registry).- Specified by:
- getOutputImageNamein interface- ActionDiscovery
- Parameters:
- imageParamName- The output image parameter label for which to get the image name.
- Returns:
- The image name of the requested output image parameter label.
 
 - 
isActionCompletepublic boolean isActionComplete() Returns whether the action has successfully completed its execution.- Specified by:
- isActionCompletein interface- ActionDiscovery
- Returns:
- True, if the action is complete. False, if the action failed or is still running.
 
 
- 
 
-