File: chap4.xml

package info (click to toggle)
gsequencer 7.7.5-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 71,040 kB
  • sloc: ansic: 1,145,949; xml: 31,016; cpp: 9,487; sh: 5,798; makefile: 3,845; perl: 155; sed: 16; python: 11
file content (117 lines) | stat: -rw-r--r-- 4,515 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE chapter
[
<!ENTITY images "images">
<!ENTITY backwardIcon "../&images;/adwaita/media-skip-backward.png">
<!ENTITY previousIcon "../&images;/adwaita/media-seek-backward.png">
<!ENTITY playIcon "../&images;/adwaita/media-playback-start.png">
<!ENTITY stopIcon "../&images;/adwaita/media-playback-stop.png">
<!ENTITY nextIcon "../&images;/adwaita/media-seek-forward.png">
<!ENTITY forwardIcon "../&images;/adwaita/media-skip-forward.png">
]>

<!-- Copyright (C) 2005-2018 Jo\u00EBl Kr\u00E4hemann -->
<!-- Permission is granted to copy, distribute and/or modify this document -->
<!-- under the terms of the GNU Free Documentation License, Version 1.3 -->
<!-- or any later version published by the Free Software Foundation; -->
<!-- with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. -->
<!-- A copy of the license is included in the section entitled "GNU -->
<!-- Free Documentation License". -->

<chapter xmlns="http://docbook.org/ns/docbook" version="5.0">
  <title>The navigation</title>
  <mediaobject>
    <imageobject>
      <imagedata width="100%" scalefit="1" fileref="../&images;/ags_navigation.png" format="PNG" />
    </imageobject>
    <caption>
      <para>
	The navigation screenshot
      </para>
    </caption>
  </mediaobject>
  <para>
    With the navigation you have overall control of your song. Settings you perform
    here may influence the behaviour of AGS. There&apos;s a duration label doing a time approximation.
    It is really unreliable and may differ about 30 seconds after 3 minutes of playback. Note
    with higher frequency of the audio related threads it may differ less. An other factor is bpm
    what has an influence, as well.
  </para>

  <sect1>
    <title>BPM</title>
    <para>
      The beats per minute (BPM for short) indicates the velocity of a song being
      played. To adjust the BPM of the project in-/decrement the spinner labeled
      with bpm. To edit patterns or notes at a more granular rate select the wished
      tact within the appropriate engine or editor.
    </para>
    <para>
      To calculate timings you divide 1 minute with the entered BPM and divide it
      with basic. For example you have a BPM rate of 120 and a 4/4 tact you would
      calculate the timing as follow:
    </para>
    <equation>
      <mathphrase>t = 1 / 120 * (1 / 4)</mathphrase>
    </equation>
  </sect1>

  <sect1>
    <title>Playback controls</title>
    <para>
      With these controls you can play/stop a song or seek to the wished position.
    </para>
    <table>
      <title>AGS playback controls table</title>
      <tgroup cols="3" align="left" colsep='1' rowsep='1'>
	<colspec colnum="1" colname="col1" colwidth="1*"/>
	<colspec colnum="2" colname="col2" colwidth="2*"/>
	<colspec colnum="3" colname="col3" colwidth="4.5*"/>
	<thead>
	  <row>
	    <entry>icon</entry>
	    <entry>action</entry>
	    <entry>description</entry>
	  </row>
	</thead>
	<tbody>
	  <row>
	    <entry><imagedata fileref="&backwardIcon;" format="PNG" width="1em" /></entry>
	    <entry>backward</entry>
	    <entry>Seeking back until it&apos;s pressed again.</entry>
	  </row>
	  <row>
	    <entry><imagedata fileref="&previousIcon;" format="PNG" width="1em" /></entry>
	    <entry>previous</entry>
	    <entry>Seeking back until it&apos;s not pressed anymore.</entry>
	  </row>
	  <row>
	    <entry><imagedata fileref="&playIcon;" format="PNG" width="1em" /></entry>
	    <entry>play</entry>
	    <entry>Starts the engines and the piano roll.</entry>
	  </row>
	  <row>
	    <entry><imagedata fileref="&stopIcon;" format="PNG" width="1em" /></entry>
	    <entry>stop</entry>
	    <entry>Stops the engines and the piano roll.</entry>
	  </row>
	  <row>
	    <entry><imagedata fileref="&nextIcon;" format="PNG" width="1em" /></entry>
	    <entry>next</entry>
	    <entry>Seeking forward until it&apos;s not pressed anymore.</entry>
	  </row>
	  <row>
	    <entry><imagedata fileref="&forwardIcon;" format="PNG" width="1em" /></entry>
	    <entry>forward</entry>
	    <entry>Seeking forward until it&apos;s pressed again.</entry>
	  </row>
	</tbody>
      </tgroup>
    </table>
    <para>
      The loop checkbox enables the loop L and loop R settings below. It causes the notation to loop playback.
      Auto-Scroll checkbox animates the horizontal scrollbars to follow playback position. Use exclude sequencers
      checkbox to enable/disable pattern based sequencers.
    </para>
  </sect1>
</chapter>