chiark / gitweb /
dc818904861711b583b67b7eeb84a82bc97590bb
[disorder] / disobedience / manual / properties.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
2 <!--
3 This file is part of DisOrder.
4 Copyright (C) 2009 Richard Kettlewell
5
6 This program is free software: you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation, either version 3 of the License, or
9 (at your option) any later version.
10
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14 GNU General Public License for more details.
15
16 You should have received a copy of the GNU General Public License
17 along with this program.  If not, see <http://www.gnu.org/licenses/>.
18 -->
19 <html>
20  <head>
21    <title>Disobedience: Track Properties</title>
22    <link rel=stylesheet
23          type="text/css"
24          href="disobedience.css">
25  </head>
26  <body>
27    <h1>4. Track Properties</h1>
28
29    <p>The chapter describes how to edit track properties.</p>
30
31    <p class=image><img src="track-properties.png"></p>
32
33    <p>This window can be invoked from any of the four tabs by
34    selecting one or more tracks and then either selected <b>Edit >
35    Track Properties</b> or via the right-click pop-up menu.</p>
36
37    <h2><a name=names>4.1 Track Name Parts</a></h2>
38
39    <p>The first three fields for each track are the parts of its name:
40    the artist, album and title.  These control what appear in the
41    similarly named columns in the queue and other tabs.  If they are
42    wrong then you can edit them here to correct them.</p>
43
44    <p>The double-headed arrow at the right of each field will copy the
45    current field value to all the other tracks in the window.  For
46    instance if an album name is mis-spelled or wrong then you could
47    follow the following procedure to correct it for all its
48    tracks:</p>
49
50    <ol>
51
52      <li>In the <b>Choose</b> tab, select all the tracks in the album.</li>
53
54      <li>Select <b>Edit > Track Properties</b> to bring up the track
55      properties window.</li>
56
57      <li>Edit the album name in the first track.</li>
58
59      <li>Click the arrow button to the right of the corrected version.</li>
60
61      <li>Click the <b>OK</b> button.</li>
62
63    </ol>
64
65    <h2><a name=tags>4.2 Tags</a></h2>
66
67    <p>Each track has an associated collection of tags.  These can used
68    when searching for tracks in the <b>Choose</b> tab or to control
69    which tracks are picked at random (although this functionality is
70    not readily available in current versions of Disobedience).</p>
71
72    <p>To add tags to a track enter the tags you want to apply to it in
73    the <b>Tags</b> field, separated by commas.  Tags cannot contain
74    commas and are compared without regard to whitespace.</p>
75
76    <h2><a name=weight>4.3 Track Weight</a></h2>
77
78    <p>Every track has an associated weight.  A higher weight makes the
79    track more likely to be picked at random and lower weight makes it
80    less likely to be picked at random.  (In the simplest case the
81    probability that it will be picked is equal to its weight divided
82    by the total weight of all tracks, although there are a number of
83    other factors that modify this.)</p>
84
85    <p>If no weight has been explicitly set then the track gets a
86    default weight of 90,000.</p>
87
88    <p>One way to prevent a track being picked at random would be to
89    set its weight to zero, but in fact there is a box you can untick
90    to suppress random selection of tracks too.</p>
91
92  </body>
93 </html>