X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=src%2Fjalview%2Fdatamodel%2FSequenceI.java;h=ca12c8310b692cb4a678d08ddda9f639f06bbd14;hb=08b87509ada06ac8614424247346daef4054b41a;hp=84643d1265783394d54cb803594f0ed71ade764e;hpb=4a25d1aa51aa9f76efba8eb278bdd976216bb88e;p=jalview.git diff --git a/src/jalview/datamodel/SequenceI.java b/src/jalview/datamodel/SequenceI.java index 84643d1..ca12c83 100755 --- a/src/jalview/datamodel/SequenceI.java +++ b/src/jalview/datamodel/SequenceI.java @@ -20,8 +20,10 @@ */ package jalview.datamodel; +import jalview.datamodel.Sequence.DBModList; import jalview.datamodel.features.SequenceFeaturesI; import jalview.util.MapList; +import jalview.ws.params.InvalidArgumentException; import java.util.BitSet; import java.util.Iterator; @@ -112,9 +114,11 @@ public interface SequenceI extends ASequenceI * get a range on the sequence as a string * * @param start - * position relative to start of sequence including gaps (from 0) + * (inclusive) position relative to start of sequence including gaps + * (from 0) * @param end - * position relative to start of sequence including gaps (from 0) + * (exclusive) position relative to start of sequence including gaps + * (from 0) * * @return String containing all gap and symbols in specified range */ @@ -353,14 +357,17 @@ public interface SequenceI extends ASequenceI /** * set the array of Database references for the sequence. * + * BH 2019.02.04 changes param to DBModlist + * * @param dbs * @deprecated - use is discouraged since side-effects may occur if DBRefEntry * set are not normalised. + * @throws InvalidArgumentException if the is not one created by Sequence itself */ @Deprecated - public void setDBRefs(DBRefEntry[] dbs); + public void setDBRefs(DBModList dbs); - public DBRefEntry[] getDBRefs(); + public DBModList getDBRefs(); /** * add the given entry to the list of DBRefs for this sequence, or replace a @@ -379,6 +386,12 @@ public interface SequenceI extends ASequenceI */ public boolean addSequenceFeature(SequenceFeature sf); + /** + * Deletes the feature from the sequence (if found). To be precise, deletes + * the first feature {@code f} found where {@code f.equals(sf)}. + * + * @param sf + */ public void deleteFeature(SequenceFeature sf); public void setDatasetSequence(SequenceI seq); @@ -576,4 +589,46 @@ public interface SequenceI extends ASequenceI * @return first residue not contained in regions */ public int firstResidueOutsideIterator(Iterator it); + + /** + * @author Bob Hanson 2019.07.30 + * + * get a 4-byte color, with caching + * + */ + public int getColor(int i); + + /** + * @author Bob Hanson 2019.07.30 + * + * set a 4-byte color, with caching + * + */ + public int setColor(int i, int argb); + + /** + * @author Bob Hanson 2019.07.30 + * + * allows resetting the color cache + * + */ + public void resetColors(); + + /** + * Answers a (possibly empty) list of features of the specified type that + * overlap the specified column position. If parameter {@code result} is not + * null, features are appended to it and the (possibly extended) list is + * returned. + */ + List findFeatures(int column, String type, + List result); + + /** + * Answers true if this store contains at least one feature, else false + * + * @return + */ + public boolean hasFeatures(String type); + } +