Class BlobPanel

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
uk.ac.starlink.topcat.plot.BlobPanel
All Implemented Interfaces:
MouseListener, MouseMotionListener, ImageObserver, MenuContainer, Serializable, EventListener
public class BlobPanel extends JComponent implements MouseListener, MouseMotionListener
Component which allows the user to draw a blob using the mouse. You drag the mouse around to cover patches of the component; you can create several separate or overlapping blobs by doing several click-drag sequences. If you drag off the window the currently-dragged region will be ditched. Clicking with the right button removes the most recently-added blob. Resizing the window clears any existing blobs (since it's not obvious how or if to resize the blobs). Try it, it's easy.
Since:
8 Jul 2004
Author:
Mark Taylor (Starlink)
See Also:

  • Constructor Details

    • BlobPanel

      public BlobPanel()
      Creates a new BlobPanel.

  • Method Details

    • getBlob

      public Shape getBlob()
      Returns the currently-defined blob.
      Returns:
      shape drawn

    • setBlob

      public void setBlob(Shape blob)
      Sets the currently-defined blob.
      Parameters:
      blob - shape to be displayed and played around with by the user

    • clear

      public void clear()
      Resets the current blob to a null shape.

    • getBlobAction

      public Action getBlobAction()
      Returns the action which is used to start and stop blob drawing. Invoking the action toggles the activity status of this panel, and when invoked for deactivation (that is after a blob has been drawn) then blobCompleted(Shape) is called.
      Returns:
      activation toggle action

    • setActive

      public void setActive(boolean active)
      Sets whether this panel is active (visible, accepting mouse gestures, drawing shapes) or inactive (invisible).
      Parameters:
      active - true to select activeness

    • isActive

      public boolean isActive()
      Indicates whether this blob is currently active.
      Returns:
      true iff this blob is active (visible and drawing)

    • blobCompleted

      protected void blobCompleted(Shape blob)
      Invoked when this component's action is invoked to terminate a blob drawing session. Subclasses may provide an implementation which does something with the shape. The default implemenatation does nothing.
      Parameters:
      blob - completed shape

    • setColors

      public void setColors(Color fillColor, Color pathColor)
      Sets the colours which will be used for drawing the blob.
      Parameters:
      fillColor - colour which fills the blob area
      pathColor - colour which delineates the blob region

    • paintComponent

      protected void paintComponent(Graphics g)
      Overrides:
      paintComponent in class JComponent

    • mouseEntered

      public void mouseEntered(MouseEvent evt)
      Specified by:
      mouseEntered in interface MouseListener

    • mouseExited

      public void mouseExited(MouseEvent evt)
      Specified by:
      mouseExited in interface MouseListener

    • mouseClicked

      public void mouseClicked(MouseEvent evt)
      Specified by:
      mouseClicked in interface MouseListener

    • mousePressed

      public void mousePressed(MouseEvent evt)
      Specified by:
      mousePressed in interface MouseListener

    • mouseReleased

      public void mouseReleased(MouseEvent evt)
      Specified by:
      mouseReleased in interface MouseListener

    • mouseDragged

      public void mouseDragged(MouseEvent evt)
      Specified by:
      mouseDragged in interface MouseMotionListener

    • mouseMoved

      public void mouseMoved(MouseEvent evt)
      Specified by:
      mouseMoved in interface MouseMotionListener