chiark / gitweb /
cgi/cgimain.c: Make the CGI program be (a little) locale-aware.
[disorder] / disobedience / manual / properties.html
CommitLineData
a9ace56d
RK
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
2<!--
3This file is part of DisOrder.
4Copyright (C) 2009 Richard Kettlewell
5
6This program is free software: you can redistribute it and/or modify
7it under the terms of the GNU General Public License as published by
8the Free Software Foundation, either version 3 of the License, or
9(at your option) any later version.
10
11This program is distributed in the hope that it will be useful,
12but WITHOUT ANY WARRANTY; without even the implied warranty of
13MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14GNU General Public License for more details.
15
16You should have received a copy of the GNU General Public License
17along 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
a80fe344 34 selecting one or more tracks and then either selecting <b>Edit >
a9ace56d
RK
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
a80fe344 69 which tracks are picked at random.</p>
a9ace56d
RK
70
71 <p>To add tags to a track enter the tags you want to apply to it in
72 the <b>Tags</b> field, separated by commas. Tags cannot contain
73 commas and are compared without regard to whitespace.</p>
74
a80fe344
RK
75 <p>To search by tag, prefix it with <tt>tag:</tt> in the search box.</p>
76
77 <p>To control how tracks are picked at random, select <b>Control >
78 Global Preferences</b>. If <b>Required Tags</b> contains a
79 comma-separated list of tags then only tracks with at least one of
80 the listed tags will be picked at random. Similarly
81 if <b>Prohibited Tags</b> contains a comma-separated list of tags
82 then no track with any of the listed tags will be picked at
83 random.</p>
84
a9ace56d
RK
85 <h2><a name=weight>4.3 Track Weight</a></h2>
86
87 <p>Every track has an associated weight. A higher weight makes the
88 track more likely to be picked at random and lower weight makes it
89 less likely to be picked at random. (In the simplest case the
90 probability that it will be picked is equal to its weight divided
91 by the total weight of all tracks, although there are a number of
92 other factors that modify this.)</p>
93
94 <p>If no weight has been explicitly set then the track gets a
95 default weight of 90,000.</p>
96
97 <p>One way to prevent a track being picked at random would be to
98 set its weight to zero, but in fact there is a box you can untick
99 to suppress random selection of tracks too.</p>
100
f326f12d
RK
101 <hr>
102
103 <a href="index.html">Back to contents</a>
104
a9ace56d
RK
105 </body>
106</html>