X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=src%2Fjalview%2Fapi%2FAlignViewportI.java;h=5f759b87923062307ed230016db54870fe5e8a59;hb=416f6e172aa77e3b0f2c2bd2b7a5655a6194d936;hp=54a1d6fb1838b9d6239290cc17ea98fc6a39ffdc;hpb=e8ede151da126e8fe205392c64f1604d80adda6d;p=jalview.git diff --git a/src/jalview/api/AlignViewportI.java b/src/jalview/api/AlignViewportI.java index 54a1d6f..5f759b8 100644 --- a/src/jalview/api/AlignViewportI.java +++ b/src/jalview/api/AlignViewportI.java @@ -1,23 +1,39 @@ -/** +/* + * Jalview - A Sequence Alignment Editor and Viewer (Version 2.8) + * Copyright (C) 2012 J Procter, AM Waterhouse, LM Lui, J Engelhardt, G Barton, M Clamp, S Searle + * + * This file is part of Jalview. * + * Jalview is free software: you can redistribute it and/or + * modify it under the terms of the GNU General Public License + * as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. + * + * Jalview is distributed in the hope that it will be useful, but + * WITHOUT ANY WARRANTY; without even the implied warranty + * of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. See the GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License along with Jalview. If not, see . */ package jalview.api; +import java.awt.Color; import java.util.Hashtable; import java.util.Map; import jalview.datamodel.AlignmentAnnotation; import jalview.datamodel.AlignmentI; -import jalview.datamodel.AnnotatedCollectionI; +import jalview.datamodel.AlignmentView; +import jalview.datamodel.CigarArray; import jalview.datamodel.ColumnSelection; import jalview.datamodel.SequenceCollectionI; +import jalview.datamodel.SequenceGroup; import jalview.datamodel.SequenceI; import jalview.schemes.ColourSchemeI; -import jalview.schemes.RNAHelicesColour; /** * @author jimp - * + * */ public interface AlignViewportI { @@ -31,7 +47,7 @@ public interface AlignViewportI /** * calculate the height for visible annotation, revalidating bounds where * necessary ABSTRACT GUI METHOD - * + * * @return total height of annotation */ public int calcPanelHeight(); @@ -65,23 +81,28 @@ public interface AlignViewportI AlignmentAnnotation getAlignmentQualityAnnot(); AlignmentAnnotation getAlignmentConservationAnnotation(); + /** * get the container for alignment consensus annotation + * * @return */ AlignmentAnnotation getAlignmentConsensusAnnotation(); /** * Test to see if viewport is still open and active - * @return true indicates that all references to viewport should be dropped + * + * @return true indicates that all references to viewport should be dropped */ boolean isClosed(); + /** * get the associated calculation thread manager for the view + * * @return */ AlignCalcManagerI getCalcManager(); - + /** * get the percentage gaps allowed in a conservation calculation * @@ -90,24 +111,28 @@ public interface AlignViewportI /** * set the consensus result object for the viewport + * * @param hconsensus */ void setSequenceConsensusHash(Hashtable[] hconsensus); /** * - * @return the alignment annotatino row for the structure consensus calculation + * @return the alignment annotatino row for the structure consensus + * calculation */ AlignmentAnnotation getAlignmentStrucConsensusAnnotation(); /** * set the Rna structure consensus result object for the viewport - * @param hStrucConsensus + * + * @param hStrucConsensus */ void setRnaStructureConsensusHash(Hashtable[] hStrucConsensus); /** * set global colourscheme + * * @param rhc */ void setGlobalColourScheme(ColourSchemeI rhc); @@ -117,4 +142,46 @@ public interface AlignViewportI void setHiddenRepSequences( Map hiddenRepSequences); + /** + * hides or shows dynamic annotation rows based on groups and group and + * alignment associated auto-annotation state flags apply the current + * group/autoannotation settings to the alignment view. Usually you should + * call the AlignmentViewPanel.adjustAnnotationHeight() method afterwards to + * ensure the annotation panel bounds are set correctly. + * + * @param applyGlobalSettings + * - apply to all autoannotation rows or just the ones associated + * with the current visible region + * @param preserveNewGroupSettings + * - don't apply global settings to groups which don't already have + * group associated annotation + */ + void updateGroupAnnotationSettings(boolean applyGlobalSettings, + boolean preserveNewGroupSettings); + + void setSequenceColour(SequenceI seq, Color col); + + Color getSequenceColour(SequenceI seq); + + void updateSequenceIdColours(); + + SequenceGroup getSelectionGroup(); + + SequenceI[] getSequenceSelection(); + + void clearSequenceColours(); + + CigarArray getViewAsCigars(boolean selectedRegionOnly); + + AlignmentView getAlignmentView(boolean selectedOnly); + + AlignmentView getAlignmentView(boolean selectedOnly, boolean markGroups); + + String[] getViewAsString(boolean selectedRegionOnly); + + void setSelectionGroup(SequenceGroup sg); + + char getGapCharacter(); + + }