-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html><!-- InstanceBegin template="/Templates/jtemplate.dwt" codeOutsideHTMLIsLocked="false" -->
-<head>
-<!-- InstanceBeginEditable name="doctitle" -->
-<TITLE>JalviewLite API documentation</TITLE>
-<!-- InstanceEndEditable -->
-<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><meta http-equiv="keywords" content="jalview,multiple,sequence,alignment,editor,viewer,java,download,barton group,protein,dna,das,distributed annotation system">
-<!-- InstanceBeginEditable name="head" -->
-<!-- InstanceEndEditable -->
-<style type="text/css">
<!--
-td {
- font-family: Geneva, Arial, Helvetica, sans-serif;
- font-size: 12px;
-}
-.plain {
- font-family: Verdana, Arial, Helvetica, sans-serif;
- font-size: 14px;
- text-decoration: none;
-}
-.plain:hover{
- background-color:#000000; color: #F2F2FF;
-}
-
+ * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
+ * Copyright (C) $$Year-Rel$$ The Jalview Authors
+ *
+ * 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 <http://www.gnu.org/licenses/>.
+ * The Jalview Authors are detailed in the 'AUTHORS' file.
-->
-</style>
-<script language="JavaScript">
-function genHref()
-{
-var s1 = "ml:ljvwr", s2 = "athpai.g", s3 = "ioe@leo ", href="";
-for(i=0; i<8; i++)
-{href = href + s1.charAt(i) + s2.charAt(i) + s3.charAt(i); }
-window.location=href;
-}
-function getEventTarget(e)
-{
-if(!e)
-e = window.event;
-if(e.target)
-return e.target;
-return e.srcElement;
-}
-</script>
-</head>
-<body alink="#000000" vlink="#000000" link="#000000">
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ?
-"https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost +
-"google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-try{
-var pageTracker = _gat._getTracker("UA-9060947-1");
-pageTracker._trackPageview();
-} catch(err) {}
-</script>
-<div align="left">
- <table width="805" height="100" cellpadding="5">
- <tr>
- <td background="../jalview.gif"> <a href="http://www.compbio.dundee.ac.uk" target="NEW"><img src="../uodc_r1_c1.gif" width="143" height="101" border="1"></a></td>
- </tr>
- </table>
- <table width="805" border="0" cellpadding="5" cellspacing="5">
- <tr>
- <td width="183" valign="top" bgcolor="#F2F2FF" border="5">
-
- <div align="center">
- <table width="182" height="386" border="0" cellpadding="0" cellspacing="0">
- <tr>
- <td align="left" valign="middle"><a href="../index.html" class="plain">Home</a></td>
- </tr>
- <tr>
- <td align="left" valign="middle"><a href="../overview.html" class="plain">Overview</a></td>
- </tr>
- <tr>
- <td align="left" valign="middle"><a href="../download.html" class="plain">Download</a></td>
- </tr>
- <tr>
- <td align="left" valign="middle"><a href="applets.html" class="plain">Applet
- Version</a></td>
- </tr>
- <tr>
- <td align="left" valign="middle"><a href="examples.html" class="plain">Screenshots</a></td>
- </tr>
- <tr>
- <td align="left" valign="middle"><a href="../faq.html" class="plain">FAQ</a></td>
- </tr>
- <tr>
- <td align="left" valign="middle"><a href="../documentList.html" class="plain">Documentation</a></td>
- </tr>
- <tr>
- <td align="left" valign="middle" ><a href="../releaseHistory.html" class="plain">Release
- history</a></td>
- </tr>
- <tr>
- <td align="left" valign="middle"><a href="../source/source.html" class="plain">Source
- Code</a></td>
- </tr>
- <tr>
- <td align="left" valign="middle"><a href="../versions.html" class="plain">Development Version</a></td>
- </tr>
- <tr>
- <td align="left" valign="middle"><a href="../links.html" class="plain">Links</a></td>
- </tr>
- <tr>
- <td align="left" valign="middle"><a href="http://www.jalview.org/mailman/listinfo/jalview-announce" class="plain" target="NEW">News
- Mailing List</a></td>
- </tr>
- <tr>
- <td align="left" valign="middle"><a
- href="http://www.jalview.org/mailman/listinfo/jalview-discuss"
- class="plain" target="NEW">Discussion Mailing List</a><br><br><em>Please send problems<br>and
- bug reports to the discussion list.</em></td>
- </tr>
- <tr></tr>
- <tr>
- <!--<td align="left" valign="middle"><br>
- Please send problems<br>and
- bug reports to:<br><a href="#" onClick="javascript:genHref();"><img src="../help.gif" width="123" height="19" border="0"></a></td>-->
- </tr>
- </table>
- </div>
- <div align="center"> <a href="http://www.bbsrc.ac.uk/" target="NEW"><br>
- <img src="../bbsrc-new.gif" width="179" height="64" border="1"></a>
- </div>
- </td>
- <td valign="top" width="587" bgcolor="#F2F2FF"><!-- InstanceBeginEditable name="Contents" -->
- <p> </p>
- <strong>JalviewLite Javascript API<br></strong>
- <p>The jalviewLite applet's application programming interface (API) includes two components. A <a href="javascript/jalview.js">JalviewLite Javascript Library</a> and the <a href="#api">public methods on the JalviewLite applet</a>.
- <p>The best way to learn how to use the API is to see it in action on the demonstration pages below:</p>
- <ul>
- <li><a href="formComplete.html">use Javascript to control and get data from JalviewLite</a></li>
- <li><a href="linkedapplets_ng.html">use Javascript to make two jalviewLite instances talk to each other.</a></li>
- <li><a href="embeddedWJmol.html">configure JalviewLite to talk to a Jmol applet on the page (EXPERIMENTAL! please provide feedback!).</a></li>
- <li><a href="javascriptLaunch.html">launch JalviewLite from a javascript button</a></li>
-
- </ul>
- <h4>Notes</h4>
+
+<!-- content start -->
+<p>The jalviewLite applet's application programming interface (API) includes two components. A <a href="javascript/jalview.js">JalviewLite Javascript Library</a> and the <a href="#api">public methods on the JalviewLite applet</a>.
+</p>
+ <h3>Notes</h3>
<ul>
<li>Unfortunately Javascript - Java communication is not possible
using Internet Explorer or Opera on Macs. Please use Safari or
</li>
</ul>
<a name="api">
- <h4>JalviewLite's Java API</h4></a>
+ <h1>JalviewLite's Javascript API</h1></a>
<p>The following public methods on the jalviewLite applet are available to be called from javascript:</p>
<pre>//get list of IDs of selected sequences
public String getSelectedSequences()
public String getAlignmentFrom(AlignFrame alf, String format, String suffix)
// add the given features or annotation to the current alignment
+// if features are loaded, feature display is automatically enabled
public void loadAnnotation(String annotation)
// add the given features or annotation to the given alignment view
+// if features are loaded, feature display is automatically enabled
public void loadAnnotationFrom(AlignFrame alf, String annotation)
+// parse the given string as a jalview or GFF features file and optionally enable feature display on the current alignment
+// (v2.8)
+public abstract void loadFeatures(String features, boolean autoenabledisplay)
+
+// parse the given string as a jalview or GFF features file and optionally enable feature display on the given alignment
+// (v2.8)
+public abstract void loadFeaturesFrom(AlignFrame alf, String features, boolean autoenabledisplay)
+
// get the sequence features in the given format (Jalview or GFF)
public String getFeatures(String format)
public AlignFrame newViewFrom(AlignFrame alf, String name)
// load a new alignment
+// remember to store the AlignFrame object reference
+// if you want to manipulate the new alignment view.
public AlignFrame loadAlignment(String text, String title)
// the given location the top left hand corner for given current view (v2.7)
public void scrollViewToIn(AlignFrame alf, String topRow, String leftHandColumn)
+// adjust horizontal scroll in alf to the make
+// the given location the left hand corner for given current view (v2.7)
+public void scrollViewToColumnIn(AlignFrame alf, String leftHandColumn)
+
+// adjust horizontal/vertical scroll in alf to the make
+// the given location the top row for given current view (v2.7)
+public void scrollViewToRowIn(AlignFrame alf, String topRow)
+
// return separator separated list of feature groups
// on the current alignment
// debug flag - controls output to standard out
public static boolean debug
-</pre> <!-- InstanceEndEditable --></td>
- </tr>
- </table>
-</div>
-</body>
-<!-- InstanceEnd --></html>
+</pre>
+<!-- content end -->
\ No newline at end of file