Class Drawable

    • Field Summary

      Fields 
      Modifier and Type Field Description
      protected DisplayCanvas canvas
      The canvas on which this Drawable is drawn.
      protected CoordinateRect coords
      The CoordinateRect for the rectagular area where this Drawable is drawn.
    • Constructor Summary

      Constructors 
      Constructor Description
      Drawable()  
    • Method Summary

      All Methods Instance Methods Abstract Methods Concrete Methods 
      Modifier and Type Method Description
      abstract void draw​(java.awt.Graphics g, boolean coordsChanged)
      Draw this drawable in the graphics context g.
      boolean getVisible()
      Return true if this Drawable is visible, false if it is hidden.
      void needsRedraw()
      This routine should be called if the appearance of the Drawable changes so that the rectangular area that it occupies has to be redrawn.
      protected void setOwnerData​(DisplayCanvas canvas, CoordinateRect coords)
      Sets the values of member variables canvas and coords.
      void setVisible​(boolean show)
      Set the visibility of this Drawable.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • coords

        protected CoordinateRect coords
        The CoordinateRect for the rectagular area where this Drawable is drawn. This is set automatically when the Drawable is added to a CoordingteRect and should not be changed. (It will be changed automatically if the Drawable is removed from the CoordinateRect.)
      • canvas

        protected DisplayCanvas canvas
        The canvas on which this Drawable is drawn. This is set automatically when the Drawable is added to a CoordinateRect and it should not be changed. (It will be changed automatically if the Drawable is removed from the CoordinateRect.)
    • Constructor Detail

      • Drawable

        public Drawable()
    • Method Detail

      • draw

        public abstract void draw​(java.awt.Graphics g,
                                  boolean coordsChanged)
        Draw this drawable in the graphics context g. This is meant to be called only by the CoordinateRect, coords, that manages this Drawable. The coords contains information about the rectangular area in which this Drawable is displayed, both in terms of pixels and in terms of real (x,y)-coordinates. The value of coordsChanged is true if any of the values coords.getXmin(), coords.getXmax(), coords.getYmin(), coords.getYmax(), coords.getLeft(), coords.getRight(), coords.getTop(), coords.getBottom(), or coords.getGap() has changed. Drawables that depend only on this information can check the value of coordsChanged to see whether they need to update any previously computed member variables that depend on these values. This method is meant to be called only by the system.
        Parameters:
        g - The graphics context in which the Drawble is to be drawn. (The drawing can change the color in g, but should not permanently change font, painting mode, etc. Thus, every drawable is responsible for setting the color it wants to use.)
        coordsChanged - Indicates whether the CoordinateRect has changed.
      • getVisible

        public boolean getVisible()
        Return true if this Drawable is visible, false if it is hidden. A hidden Drawable is ignored by the CoordinateRect that manages it.
      • setVisible

        public void setVisible​(boolean show)
        Set the visibility of this Drawable. If show is false, then the Drawable is hidden. If it is true, the Drawable is shown.
      • needsRedraw

        public void needsRedraw()
        This routine should be called if the appearance of the Drawable changes so that the rectangular area that it occupies has to be redrawn. The routine is generally meant to be called by the Drawable itself. It will notify the DisplayCanvas, canvas, that the CoordinateRect, coords, needs to be redrawn, where canvas and coords are the member variables in this class. If canvas is null, nothing happens, since presumably the Drawable is not displayed anywhere in that case.
      • setOwnerData

        protected void setOwnerData​(DisplayCanvas canvas,
                                    CoordinateRect coords)
        Sets the values of member variables canvas and coords. This is designed to be called only by the CoordinateRect class.