Class SequencePoster

  • All Implemented Interfaces:
    java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.swing.SwingConstants, SequenceRenderContext, Changeable

    public class SequencePoster
    extends javax.swing.JComponent
    implements javax.swing.SwingConstants, SequenceRenderContext, Changeable
    Deprecated.
    This doesn't handle loads of stuff. Use SequencePoster.
    A panel that displays a Sequence.

    A SequencePoster can either display the sequence from left-to-right (HORIZONTAL) or from top-to-bottom (VERTICAL). It has an associated scale which is the number of pixels per symbol. It also has a lines property that controls how to wrap the sequence off one end and onto the other.

    Each line in the SequencePoster is broken down into a list of strips, each rendered by an individual SequenceRenderer object. You could add a SequenceRenderer that draws on genes, another that draws repeats and another that prints out the DNA sequence. They are responsible for rendering their view of the sequence in the place that the SequencePoster positions them.

    Author:
    Thomas Down, Matthew Pocock
    See Also:
    Serialized Form
    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
      class  SequencePoster.Border
      Deprecated.
       
      • Nested classes/interfaces inherited from class javax.swing.JComponent

        javax.swing.JComponent.AccessibleJComponent
      • Nested classes/interfaces inherited from class java.awt.Container

        java.awt.Container.AccessibleAWTContainer
      • Nested classes/interfaces inherited from class java.awt.Component

        java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy
    • Field Summary

      Fields 
      Modifier and Type Field Description
      static ChangeType RENDERER
      Deprecated.
       
      • Fields inherited from class javax.swing.JComponent

        listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
      • Fields inherited from class java.awt.Component

        accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
      • Fields inherited from interface java.awt.image.ImageObserver

        ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
      • Fields inherited from interface javax.swing.SwingConstants

        BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
    • Constructor Summary

      Constructors 
      Constructor Description
      SequencePoster()
      Deprecated.
      Create a new SeqeuncePanel.
    • Method Summary

      All Methods Instance Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      protected void _setRenderer​(SequenceRenderer r)
      Deprecated.
       
      void addChangeListener​(ChangeListener cl)
      Deprecated.
      Add a listener that will be informed of all changes.
      void addChangeListener​(ChangeListener cl, ChangeType ct)
      Deprecated.
      Add a listener that will be informed of changes of a given type.
      void addSequenceViewerListener​(SequenceViewerListener svl)
      Deprecated.
       
      void addSequenceViewerMotionListener​(SequenceViewerMotionListener svml)
      Deprecated.
       
      protected int[] calcLineExtent​(java.awt.event.MouseEvent me)
      Deprecated.
       
      protected ChangeSupport getChangeSupport​(ChangeType ct)
      Deprecated.
       
      int getDirection()
      Deprecated.
      Retrieve the current rendering direction.
      FeatureHolder getFeatures()
      Deprecated.
      The features to render.
      SequenceRenderContext.Border getLeadingBorder()
      Deprecated.
      Retrieve the object that encapsulates the leading border area - the space before sequence information is rendered.
      int getLines()
      Deprecated.
      Retrieve the number of lines that the sequence will be rendered over.
      RangeLocation getRange()
      Deprecated.
      The range of the SymbolList to render.
      java.awt.RenderingHints getRenderingHints()
      Deprecated.
       
      double getScale()
      Deprecated.
      Retrieve the current scale.
      Sequence getSequence()
      Deprecated.
       
      int getSpacer()
      Deprecated.
      Retrieve the current spacer value
      SymbolList getSymbols()
      Deprecated.
      Retrieve the currently rendered SymbolList
      SequenceRenderContext.Border getTrailingBorder()
      Deprecated.
      Retrieve the object that encapsulates the trailing border area - the space after sequence information is rendered.
      RangeLocation getVisibleRange()
      Deprecated.
       
      int graphicsToSequence​(double gPos)
      Deprecated.
      Converts a graphical position into a sequence coordinate.
      int graphicsToSequence​(java.awt.geom.Point2D point)
      Deprecated.
      Converts a graphical position into a sequence coordinate.
      protected boolean hasChangeListeners()
      Deprecated.
       
      protected boolean isActive()
      Deprecated.
       
      boolean isUnchanging​(ChangeType ct)
      Deprecated.
      A particular ChangeType can never be raised by this Changeable.
      void paintComponent​(java.awt.Graphics g)
      Deprecated.
      Paint this component.
      void removeChangeListener​(ChangeListener cl)
      Deprecated.
      Remove a listener that was interested in all types of changes.
      void removeChangeListener​(ChangeListener cl, ChangeType ct)
      Deprecated.
      Remove a listener that was interested in a specific types of changes.
      void removeSequenceViewerListener​(SequenceViewerListener svl)
      Deprecated.
       
      void removeSequenceViewerMotionListener​(SequenceViewerMotionListener svml)
      Deprecated.
       
      void resizeAndValidate()
      Deprecated.
       
      double sequenceToGraphics​(int seqPos)
      Deprecated.
      Converts a sequence index into a graphical coordinate.
      void setDirection​(int dir)
      Deprecated.
      Set the direction that this SequencePoster renders in.
      void setLines​(int lines)
      Deprecated.
      Set the absolute number of lines that the sequence will be rendered on.
      void setRenderer​(SequenceRenderer r)
      Deprecated.
       
      void setRenderingHints​(java.awt.RenderingHints renderingHints)
      Deprecated.
      Use this to switch on effects like Anti-aliasing etc
      void setScale​(double scale)
      Deprecated.
      Set the scale.
      void setSequence​(Sequence s)
      Deprecated.
      Set the SymboList to be rendered.
      void setSpacer​(int spacer)
      Deprecated.
      Set the number of pixels to leave blank between each block of sequence information.
      • Methods inherited from class javax.swing.JComponent

        addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getUI, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintImmediately, paintImmediately, paramString, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update, updateUI
      • Methods inherited from class java.awt.Container

        add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
      • Methods inherited from class java.awt.Component

        action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    • Constructor Detail

      • SequencePoster

        public SequencePoster()
        Deprecated.
        Create a new SeqeuncePanel.
    • Method Detail

      • isUnchanging

        public boolean isUnchanging​(ChangeType ct)
        Deprecated.
        Description copied from interface: Changeable

        A particular ChangeType can never be raised by this Changeable.

        If this returns true, then it is guaranteed that change events of this type (and all child types) can never under any circumstances be fired by this Changeable instance. If it returns false, that does not mean that this type of event will or even can be raised, but that it is worth registering listeners incase.

        Specified by:
        isUnchanging in interface Changeable
        Parameters:
        ct - the ChangeType to check
        Returns:
        true if ChangeEvents of this type are guaranteed to never be fired
      • setSequence

        public void setSequence​(Sequence s)
        Deprecated.
        Set the SymboList to be rendered. This symbol list will be passed onto the SequenceRenderer instances registered with this SequencePoster.
        Parameters:
        s - the SymboList to render
      • setDirection

        public void setDirection​(int dir)
                          throws java.lang.IllegalArgumentException
        Deprecated.
        Set the direction that this SequencePoster renders in. The direction can be one of HORIZONTAL or VERTICAL. Once the direction is set, the display will redraw. HORIZONTAL represents left-to-right rendering. VERTICAL represents AceDB-style vertical rendering.
        Parameters:
        dir - the new rendering direction
        Throws:
        java.lang.IllegalArgumentException
      • getDirection

        public int getDirection()
        Deprecated.
        Retrieve the current rendering direction.
        Specified by:
        getDirection in interface SequenceRenderContext
        Returns:
        the rendering direction (one of HORIZONTAL and VERTICAL)
      • setSpacer

        public void setSpacer​(int spacer)
        Deprecated.
        Set the number of pixels to leave blank between each block of sequence information.

        If the SeqeuncePanel chooses to display the sequence information split across multiple lines, then the spacer parameter indicates how many pixles will seperate each line.

        Parameters:
        spacer - the number of pixels seperating each line of sequence information
      • getSpacer

        public int getSpacer()
        Deprecated.
        Retrieve the current spacer value
        Returns:
        the number of pixels between each line of sequence information
      • setScale

        public void setScale​(double scale)
        Deprecated.
        Set the scale.

        The scale parameter is interpreted as the number of pixels per symbol. This may take on a wide range of values - for example, to render the symbols as text, you will need a scale of > 8, where as to render chromosome 1 you will want a scale < 0.00000001

        Parameters:
        scale - the new pixles-per-symbol ratio
      • getScale

        public double getScale()
        Deprecated.
        Retrieve the current scale.
        Specified by:
        getScale in interface SequenceRenderContext
        Returns:
        the number of pixles used to render one symbol
      • setLines

        public void setLines​(int lines)
        Deprecated.
        Set the absolute number of lines that the sequence will be rendered on. If this is set to 0, then the number of lines will be calculated according to how many lines will be needed to render the sequence in the currently available space. If it is set to any positive non-zero value, the sequence will be rendered using that many lines, and the SequencePoster will request enough space to accomplish this.
        Parameters:
        lines - the number of lines to split the sequence information over
      • getLines

        public int getLines()
        Deprecated.
        Retrieve the number of lines that the sequence will be rendered over.
        Returns:
        the current number of lines (0 if autocalculated)
      • paintComponent

        public void paintComponent​(java.awt.Graphics g)
        Deprecated.
        Paint this component.

        This calls the paint method of the currently registered SequenceRenderer after setting up the graphics appropriately.

        Overrides:
        paintComponent in class javax.swing.JComponent
      • sequenceToGraphics

        public double sequenceToGraphics​(int seqPos)
        Deprecated.
        Description copied from interface: SequenceRenderContext
        Converts a sequence index into a graphical coordinate. You will need to use this in conjunction with getDirection to correctly lay graphics out.
        Specified by:
        sequenceToGraphics in interface SequenceRenderContext
        Parameters:
        seqPos - Index within the sequence
        Returns:
        Equivalent graphical position in pixels
      • graphicsToSequence

        public int graphicsToSequence​(double gPos)
        Deprecated.
        Description copied from interface: SequenceRenderContext
        Converts a graphical position into a sequence coordinate. You will need to have used getDirection to decide whether to use the x or y coordinate.
        Specified by:
        graphicsToSequence in interface SequenceRenderContext
        Parameters:
        gPos - A pixel position
        Returns:
        The corresponding sequence index
      • graphicsToSequence

        public int graphicsToSequence​(java.awt.geom.Point2D point)
        Deprecated.
        Description copied from interface: SequenceRenderContext
        Converts a graphical position into a sequence coordinate. This will use getDirection to decide whether to use the x or y coordinate.
        Specified by:
        graphicsToSequence in interface SequenceRenderContext
        Parameters:
        point - a point representing the position
        Returns:
        the corresponding sequence index
      • calcLineExtent

        protected int[] calcLineExtent​(java.awt.event.MouseEvent me)
        Deprecated.
      • isActive

        protected boolean isActive()
        Deprecated.
      • getRenderingHints

        public java.awt.RenderingHints getRenderingHints()
        Deprecated.
        Returns:
        the current rendering properties
      • setRenderingHints

        public void setRenderingHints​(java.awt.RenderingHints renderingHints)
        Deprecated.
        Use this to switch on effects like Anti-aliasing etc
        Parameters:
        renderingHints - the desired rendering properties