[disorder] / disobedience / manual / properties.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
<!--
This file is part of DisOrder.
Copyright (C) 2009 Richard Kettlewell

This program 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.

This program 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 this program.  If not, see <http://www.gnu.org/licenses/>.
-->
<html>
 <head>
   <title>Disobedience: Track Properties</title>
   <link rel=stylesheet
         type="text/css"
         href="disobedience.css">
 </head>
 <body>
   <h1>4. Track Properties</h1>

   <p>The chapter describes how to edit track properties.</p>

   <p class=image><img src="track-properties.png"></p>

   <p>This window can be invoked from any of the four tabs by
   selecting one or more tracks and then either selecting <b>Edit >
   Track Properties</b> or via the right-click pop-up menu.</p>

   <h2><a name=names>4.1 Track Name Parts</a></h2>

   <p>The first three fields for each track are the parts of its name:
   the artist, album and title.  These control what appear in the
   similarly named columns in the queue and other tabs.  If they are
   wrong then you can edit them here to correct them.</p>

   <p>The double-headed arrow at the right of each field will copy the
   current field value to all the other tracks in the window.  For
   instance if an album name is mis-spelled or wrong then you could
   follow the following procedure to correct it for all its
   tracks:</p>

   <ol>

     <li>In the <b>Choose</b> tab, select all the tracks in the album.</li>

     <li>Select <b>Edit > Track Properties</b> to bring up the track
     properties window.</li>

     <li>Edit the album name in the first track.</li>

     <li>Click the arrow button to the right of the corrected version.</li>

     <li>Click the <b>OK</b> button.</li>

   </ol>

   <h2><a name=tags>4.2 Tags</a></h2>

   <p>Each track has an associated collection of tags.  These can used
   when searching for tracks in the <b>Choose</b> tab or to control
   which tracks are picked at random.</p>

   <p>To add tags to a track enter the tags you want to apply to it in
   the <b>Tags</b> field, separated by commas.  Tags cannot contain
   commas and are compared without regard to whitespace.</p>

   <p>To search by tag, prefix it with <tt>tag:</tt> in the search box.</p>

   <p>To control how tracks are picked at random, select <b>Control >
   Global Preferences</b>.  If <b>Required Tags</b> contains a
   comma-separated list of tags then only tracks with at least one of
   the listed tags will be picked at random.  Similarly
   if <b>Prohibited Tags</b> contains a comma-separated list of tags
   then no track with any of the listed tags will be picked at
   random.</p>

   <h2><a name=weight>4.3 Track Weight</a></h2>

   <p>Every track has an associated weight.  A higher weight makes the
   track more likely to be picked at random and lower weight makes it
   less likely to be picked at random.  (In the simplest case the
   probability that it will be picked is equal to its weight divided
   by the total weight of all tracks, although there are a number of
   other factors that modify this.)</p>

   <p>If no weight has been explicitly set then the track gets a
   default weight of 90,000.</p>

   <p>One way to prevent a track being picked at random would be to
   set its weight to zero, but in fact there is a box you can untick
   to suppress random selection of tracks too.</p>

   <hr>

   <a href="index.html">Back to contents</a>

 </body>
</html>
Commit	Line	Data
a9ace56d RK	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
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>
a9ace56d RK	106	</html>