New images
[jalview.git] / help / html / features / preferences.html
1 <html>\r
2 \r
3 <head><title>Preferences</title></head>\r
4 \r
5 <body>\r
6 <p><strong>Preferences</strong></p>\r
7 <p>There are four tabs in the Preferences dialog box: \r
8 <ul>\r
9   <li>The <a href="#visual"><strong>&quot;Visual&quot;</strong> Preferences</a> \r
10     tab allows you to configure the default display for a new alignment window. \r
11   </li>\r
12   <li>The <a\r
13   href="#connections"><strong>&quot;Connections&quot;</strong> Preferences</a> \r
14     tab allows you to change the links made from Jalview to your default web browser. \r
15   </li>\r
16   <li>The <a href="#output"><strong>&quot;Output&quot;</strong> Preferences</a> \r
17     tab contains settings affecting the export of sequence alignments and EPS \r
18     files. </li>\r
19   <li>The <a href="#editing"><strong>&quot;Editing&quot;</strong> Preferences</a> \r
20     tab contains settings affecting the export of sequence alignments and EPS \r
21     f</li>\r
22 </ul>\r
23 </p>\r
24 <p><strong><a name="visual">Visual</a> Preferences tab</strong></p>\r
25 <p><em>Maximise Window</em> - If this is selected, a new alignment window will stretch \r
26   to fit the available space.</p>\r
27 <p><em>Show Annotations</em> - If this is selected the new window will display an annotation \r
28   panel below the sequences. This annotation panel may have several rows describing \r
29   the whole alignment. The 3 standard annotations <em>Conservation</em>, <em>Quality</em> and <em>Consensus</em> \r
30   may be shown or hidden by default.</p>\r
31 <p><em>Full Sequence ID</em> - If selected the ID panel will display the name of a sequence \r
32   plus the start and end residues in the format name/start-end. If not selected, \r
33   the displayed ID will be the name of the sequence.</p>\r
34 <p><em>Font</em> - The default font name, size and style can be set for a new \r
35   alignment window. </p>\r
36 <p><em>Smooth Font</em> - Toggles anti-aliasing on / off for faster rendering \r
37   of the alignment.</p>\r
38 <p><em>Gap Symbol</em> - The default gap symbol may be set to either &quot;-&quot; or &quot;.&quot;</p>\r
39 <p><em>Colour</em> - The default colour scheme for a new alignment window. If \r
40   the chosen option is &quot;User Defined&quot; then the last User Defined Colour \r
41   loaded or saved via the User Defined Colours panel will be loaded. </p>\r
42 <p><em>Sort by</em> - When the alignment is loaded in, it will can be sorted by \r
43   Id or pairwise identity.</p>\r
44 <p><em>Open file</em> - If this is selected then the default alignment file will \r
45   be opened when Jalview is started. You can change the default file by clicking \r
46   on file name and either typing in the file path or selecting it from the file \r
47   chooser window. </p>\r
48 <p><a name="connections"><strong>&quot;Connections&quot; Preferences tab</strong></a></p>\r
49 <p><em>URL Link From Sequence ID</em><br>\r
50   Right click a sequence id to see a popup menu with &quot;Link&quot; as one of \r
51   the items. By default the item &quot;SRS&quot; is added to this link menu. This \r
52   link will show a web page in your default browser with the selected sequence \r
53   id as part of the URL.<br>\r
54   Jalview allows you to add your own custom links to other web pages. Click new \r
55   to add a new link. You can name the link, this will be displayed on a new menu \r
56   item under the &quot;Link&quot; menu when you right click on a sequence id. \r
57   <br>\r
58   You must enter $SEQUENCE_ID$ within your URL. This will be replaced by the chosen \r
59   sequence id when you click on it. </p>\r
60 <p><em>Default Browser (Unix)</em><br>\r
61   Its difficult in Java to detect the default web browser for Unix users. If Jalview \r
62   can't find your default web browser, enter the name or full path to your web \r
63   browser application. </p>\r
64 <p><em>Proxy Server</em><br>\r
65   If you normally use a proxy server for using the internet, you must tick the \r
66   box &quot;Use a Proxy Server&quot; and enter the address and port details as \r
67   necessary. Web Services will not work if you are using a proxy server and do \r
68   not enter the settings here.</p>\r
69 <p><a name="output"><strong>Output Preferences tab</strong></a></p>\r
70 <p><em>EPS Rendering Style</em><br>\r
71 This is a selection box which allows the \r
72   user to set a default rendering style for EPS export: \r
73 <ul><li>&quot;Lineart&quot;<br>EPS files will accurately\r
74 reproduce the alignment view in Jalview and all characters will be\r
75 converted into line art. Files generated in this way are large and are\r
76 not easily editable, but have no font table dependencies.</li>\r
77 <li>&quot;Text&quot;<br>EPS files will be a mixture of text and\r
78 lineart. This produces compact files that can be edited easily in\r
79 programs like Microsoft Word and Adobe Illustrator, but can be\r
80 problematic if the fonts available to jalview are not accessible by\r
81 the program reading the EPS file.\r
82 <li>&quot;Prompt each time&quot;<br>Choose this to be asked select between Lineart and Text each time you make an EPS file.</li>\r
83 </ul>\r
84 </p>\r
85 <p><em>Sequence//Start-End Numbering</em><br>\r
86   The output tab also has a group of checkboxes for each file format. If these \r
87   are ticked, then Jalview will write files with the start and end sequence positions \r
88   appended to each sequence id:\r
89 <pre>\r
90   >ID/1-10\r
91   AACDEAAFEA\r
92 </pre>\r
93 <p>If the boxes are left unchecked for a particular format, the sequence limits \r
94   will not be appended to the sequence id. </p>\r
95 </p>\r
96 <p><em>Use Modeller Output</em></p>\r
97 <p>This option only applies to PIR format output. Jalview\r
98   automatically reads PIR files with sequence descriptions compatible\r
99   with the program <a\r
100   href="http://salilab.org/modeller/">Modeller</a>.\r
101   If this option is selected <a href="../io/modellerpir.html">Jalview will write Modeller style PIR\r
102   files</a> with correct start/end numbering and PDB file association (if\r
103   available). The Jalview id/start-end option is ignored if Modeller output is selected.\r
104 <p><a name="editing"><strong>Editing Preferences tab</strong></a></p>\r
105 <p>There are currently 2 options available which can be selected / deselected. \r
106 </p>\r
107 <p><em>AutoCalculate Consensus</em> - For large alignments it can be useful to \r
108   deselect &quot;Autocalculate Consensus&quot; when editing. This prevents lengthy \r
109   calculations which are performed after each sequence edit. New alignment windows \r
110   will have their &quot;Autocalculate Consensus&quot; option set according to \r
111   this setting. </p>\r
112 <p><em>Pad gaps when editing</em> - New alignment windows will &quot;Pad Gaps&quot; \r
113   according to this setting.</p>\r
114 <p>&nbsp;</p>\r
115 <p>&nbsp;</p>\r
116 </body>\r
117 </html>\r