*/
package jalview.viewmodel;
-import jalview.api.AlignViewportI;
import jalview.datamodel.AlignmentI;
+import jalview.datamodel.HiddenColumns;
/**
* Slightly less embryonic class which: Supplies and updates viewport properties
*/
public class ViewportRanges extends ViewportProperties
{
+ public static final String STARTRES = "startres";
+
+ public static final String ENDRES = "endres";
+
+ public static final String STARTSEQ = "startseq";
+
+ public static final String ENDSEQ = "endseq";
+
+ private boolean wrappedMode = false;
+
// start residue of viewport
private int startRes;
}
/**
+ * Get alignment width in cols, excluding hidden cols
+ */
+ public int getVisibleAlignmentWidth()
+ {
+ return al.getWidth() - al.getHiddenColumns().getSize();
+ }
+
+ /**
+ * Get alignment height in rows, excluding hidden rows
+ */
+ public int getVisibleAlignmentHeight()
+ {
+ return al.getHeight();
+ }
+
+ /**
* Set first residue visible in the viewport, and retain the current width.
+ * Fires a property change event.
*
* @param res
* residue position
*/
public void setStartEndRes(int start, int end)
{
- int oldres = this.startRes;
- if (start > al.getWidth() - 1)
+ int oldstartres = this.startRes;
+
+ /*
+ * if not wrapped, don't leave white space at the right margin
+ */
+ int lastColumn = getVisibleAlignmentWidth() - 1;
+ if (!wrappedMode && (start > lastColumn))
{
- startRes = al.getWidth() - 1;
+ startRes = Math.max(lastColumn, 0);
}
else if (start < 0)
{
startRes = start;
}
+ int oldendres = this.endRes;
if (end < 0)
{
endRes = 0;
}
+ else if (!wrappedMode && (end > lastColumn))
+ {
+ endRes = Math.max(lastColumn, 0);
+ }
else
{
endRes = end;
}
- changeSupport.firePropertyChange("startres", oldres, start);
- }
-
- /**
- * Set last residue visible in the viewport
- *
- * @param res
- * residue position
- */
- public void setEndRes(int res)
- {
- int width = getViewportWidth();
- setStartEndRes(res - width + 1, res);
+ changeSupport.firePropertyChange(STARTRES, oldstartres, startRes);
+ if (oldstartres == startRes)
+ {
+ // event won't be fired if start positions are same
+ // fire an event for the end positions in case they changed
+ changeSupport.firePropertyChange(ENDRES, oldendres, endRes);
+ }
}
/**
- * Set the first sequence visible in the viewport
+ * Set the first sequence visible in the viewport, maintaining the height. If
+ * the viewport would extend past the last sequence, sets the viewport so it
+ * sits at the bottom of the alignment. Fires a property change event.
*
* @param seq
* sequence position
*/
public void setStartSeq(int seq)
{
+ int startseq = seq;
int height = getViewportHeight();
- setStartEndSeq(seq, seq + height - 1);
+ if (startseq + height - 1 > getVisibleAlignmentHeight() - 1)
+ {
+ startseq = getVisibleAlignmentHeight() - height;
+ }
+ setStartEndSeq(startseq, startseq + height - 1);
}
/**
- * Set start and end sequences at the same time. This method only fires one
- * event for the two changes, and should be used in preference to separate
- * calls to setStartSeq and setEndSeq.
+ * Set start and end sequences at the same time. The viewport height may
+ * change. This method only fires one event for the two changes, and should be
+ * used in preference to separate calls to setStartSeq and setEndSeq.
*
* @param start
* the start sequence
*/
public void setStartEndSeq(int start, int end)
{
- int oldseq = this.startSeq;
- if (start > al.getHeight() - 1)
+ int oldstartseq = this.startSeq;
+ int visibleHeight = getVisibleAlignmentHeight();
+ if (start > visibleHeight - 1)
{
- startSeq = al.getHeight() - 1;
+ startSeq = Math.max(visibleHeight - 1, 0);
}
else if (start < 0)
{
startSeq = start;
}
- if (end >= al.getHeight())
+ int oldendseq = this.endSeq;
+ if (end >= visibleHeight)
{
- endSeq = al.getHeight() - 1;
+ endSeq = Math.max(visibleHeight - 1, 0);
}
else if (end < 0)
{
endSeq = end;
}
- changeSupport.firePropertyChange("startseq", oldseq, start);
+ changeSupport.firePropertyChange(STARTSEQ, oldstartseq, startSeq);
+ if (oldstartseq == startSeq)
+ {
+ // event won't be fired if start positions are the same
+ // fire in case the end positions changed
+ changeSupport.firePropertyChange(ENDSEQ, oldendseq, endSeq);
+ }
}
/**
- * Set the last sequence visible in the viewport
+ * Set the last sequence visible in the viewport. Fires a property change
+ * event.
*
* @param seq
* sequence position
/**
* Set viewport width in residues, without changing startRes. Use in
* preference to calculating endRes from the width, to avoid out by one
- * errors!
+ * errors! Fires a property change event.
*
* @param w
* width in residues
/**
* Set viewport height in residues, without changing startSeq. Use in
* preference to calculating endSeq from the height, to avoid out by one
- * errors!
+ * errors! Fires a property change event.
*
* @param h
* height in sequences
/**
* Set viewport horizontal start position and width. Use in preference to
- * calculating endRes from the width, to avoid out by one errors!
+ * calculating endRes from the width, to avoid out by one errors! Fires a
+ * property change event.
*
* @param start
* start residue
*/
public void setViewportStartAndWidth(int start, int w)
{
- setStartEndRes(start, start + w - 1);
+ int vpstart = start;
+ if (vpstart < 0)
+ {
+ vpstart = 0;
+ }
+
+ /*
+ * if not wrapped, don't leave white space at the right margin
+ */
+ if (!wrappedMode)
+ {
+ if ((w <= getVisibleAlignmentWidth())
+ && (vpstart + w - 1 > getVisibleAlignmentWidth() - 1))
+ {
+ vpstart = getVisibleAlignmentWidth() - w;
+ }
+
+ }
+ setStartEndRes(vpstart, vpstart + w - 1);
}
/**
* Set viewport vertical start position and height. Use in preference to
- * calculating endSeq from the height, to avoid out by one errors!
+ * calculating endSeq from the height, to avoid out by one errors! Fires a
+ * property change event.
*
* @param start
* start sequence
*/
public void setViewportStartAndHeight(int start, int h)
{
- setStartEndSeq(start, start + h - 1);
+ int vpstart = start;
+ if (vpstart < 0)
+ {
+ vpstart = 0;
+ }
+ else if ((h <= getVisibleAlignmentHeight())
+ && (vpstart + h - 1 > getVisibleAlignmentHeight() - 1))
+ // viewport height is less than the full alignment and we are running off
+ // the bottom
+ {
+ vpstart = getVisibleAlignmentHeight() - h;
+ }
+ setStartEndSeq(vpstart, vpstart + h - 1);
}
/**
}
/**
- * Scroll the viewport range vertically
+ * Scroll the viewport range vertically. Fires a property change event.
*
* @param up
* true if scrolling up, false if down
}
else
{
- if (endSeq >= al.getHeight() - 1)
+ if (endSeq >= getVisibleAlignmentHeight() - 1)
{
return false;
}
}
/**
- * Scroll the viewport range horizontally
+ * Scroll the viewport range horizontally. Fires a property change event.
*
* @param right
* true if scrolling right, false if left
}
else
{
- if (endRes > al.getWidth() - 1)
+ if (endRes >= getVisibleAlignmentWidth() - 1)
{
return false;
}
}
/**
- * Scroll a wrapped alignment so that the specified residue is visible
+ * Scroll a wrapped alignment so that the specified residue is visible. Fires
+ * a property change event.
*
* @param res
* residue position to scroll to
}
/**
- * Scroll so that (x,y) is visible
+ * Scroll so that (x,y) is visible. Fires a property change event.
*
* @param x
* x position in alignment
* @param y
* y position in alignment
- * @param av
- * viewport to be visible in. Here until hidden columns JAL-2388
- * merged, then use alignment to get hidden cols
*/
- public void scrollToVisible(int x, int y, AlignViewportI av)
+ public void scrollToVisible(int x, int y)
{
while (y < startSeq)
{
scrollUp(false);
}
- while (x < av.getColumnSelection().adjustForHiddenColumns(startRes))
+ HiddenColumns hidden = al.getHiddenColumns();
+ while (x < hidden.adjustForHiddenColumns(startRes))
{
if (!scrollRight(false))
{
break;
}
}
- while (x > av.getColumnSelection().adjustForHiddenColumns(endRes))
+ while (x > hidden.adjustForHiddenColumns(endRes))
{
if (!scrollRight(true))
{
}
}
}
+
+ /**
+ * Adjust sequence position for page up. Fires a property change event.
+ */
+ public void pageUp()
+ {
+ if (wrappedMode)
+ {
+ setStartRes(Math.max(0, getStartRes() - getViewportWidth()));
+ }
+ else
+ {
+ setViewportStartAndHeight(startSeq - (endSeq - startSeq),
+ getViewportHeight());
+ }
+ }
+
+ /**
+ * Adjust sequence position for page down. Fires a property change event.
+ */
+ public void pageDown()
+ {
+ if (wrappedMode)
+ {
+ /*
+ * if height is more than width (i.e. not all sequences fit on screen),
+ * increase page down to height
+ */
+ int newStart = getStartRes()
+ + Math.max(getViewportHeight(), getViewportWidth());
+
+ /*
+ * don't page down beyond end of alignment, or if not all
+ * sequences fit in the visible height
+ */
+ if (newStart < getVisibleAlignmentWidth())
+ {
+ setStartRes(newStart);
+ }
+ }
+ else
+ {
+ setViewportStartAndHeight(endSeq, getViewportHeight());
+ }
+ }
+ public void setWrappedMode(boolean wrapped)
+ {
+ wrappedMode = wrapped;
+ }
+
+ public boolean isWrappedMode()
+ {
+ return wrappedMode;
+ }
+
+ /**
+ * Answers the vertical scroll position (0..) to set, given the visible column
+ * that is at top left.
+ *
+ * <pre>
+ * Example:
+ * viewport width 40 columns (0-39, 40-79, 80-119...)
+ * column 0 returns scroll position 0
+ * columns 1-40 return scroll position 1
+ * columns 41-80 return scroll position 2
+ * etc
+ * </pre>
+ *
+ * @param topLeftColumn
+ * (0..)
+ * @return
+ */
+ public int getWrappedScrollPosition(final int topLeftColumn)
+ {
+ int w = getViewportWidth();
+
+ /*
+ * visible whole widths
+ */
+ int scroll = topLeftColumn / w;
+
+ /*
+ * add 1 for a part width if there is one
+ */
+ scroll += topLeftColumn % w > 0 ? 1 : 0;
+
+ return scroll;
+ }
+
+ /**
+ * Answers the maximum wrapped vertical scroll value, given the column
+ * position (0..) to show at top left of the visible region.
+ *
+ * @param topLeftColumn
+ * @return
+ */
+ public int getWrappedMaxScroll(int topLeftColumn)
+ {
+ int scrollPosition = getWrappedScrollPosition(topLeftColumn);
+
+ /*
+ * how many more widths could be drawn after this one?
+ */
+ int columnsRemaining = getVisibleAlignmentWidth() - topLeftColumn;
+ int width = getViewportWidth();
+ int widthsRemaining = columnsRemaining / width
+ + (columnsRemaining % width > 0 ? 1 : 0) - 1;
+ int maxScroll = scrollPosition + widthsRemaining;
+
+ return maxScroll;
+ }
}