Merge with git+ssh://sgc@fondialog1.hum.uva.nl/fro/git/sgc.git
[sgc.git] / todo / SGC_manual.pango
blob3b1c5275f3ebc243cbbdda92fc28a8796a7b03e2
1 <span size="xx-large">
2 <b>SpeakGoodChinese (shuo1 hao3 zhong1 wen2)</b>
3 </span>
5 <span size="x-large">
6 <big><b>Manual</b></big>
7 </span>
9 <span size="medium">
10 The SpeakGoodChinese tone recognizer tries to help you to practise to pronounce mandarin tones in a "normal" voice. It tries to recognize what tones you said assuming that you pronounced the requested words in a normal voice. It will warn you if you speak with a voice that is either too low, too high, if you exaggerate the tone melodies or reduce them too much (flat tones).
11 </span>
13 <span size="medium">
14 The abilities of the tone recognizer are limited. It will only work reliably if you pronounce the requested words in a normal voice. You should also practise in silent surroundings using a low noise microphone. It also helps to check the settings of the audio-mixer to ensure that your voice is neither recorded too loud (clipped sounds) or too soft (very noisy).
15 </span>
17 <span size="medium">
18 Recognizing errors is always difficult. SpeakGoodChinese is no exception to this rule. Therefore, accepting or rejecting your pronunciation as correct will be much more accurate than determining what exactly you did wrong. If SpeakGoodChinese informs you that it rejected your pronunciation, you should always look at the recognition result, the feedback and the graphical display of your tone contours. It also helps to look at how your tones were pronounced when they are correct.
19 </span>
21 <span size="x-large">
22 Display
23 </span>
25 <span size="large">
26 Tone contours
27 </span>
29 <span size="medium">
30 In the top part of the display, you see a graphical model of the melody, or pitch, of the requested tones in black. After you have recorded your own pronunciation of the word, the melody of your voice is displayed in red. If your voice is to high or low, you might consider changing the base register of your voice in the Voice menu.
31 </span>
33 <span size="large">
34 Pinyin
35 </span>
37 <span size="medium">
38 On the display, you will find the pinyin transcription of the requested word. After you have recorded your own pronunciation, this will be replaced by the recognition result. In some cases, the tones could not be recognized, and you will see question marks (?) instead. The advice will try to explain what happened. Note that SpeakGoodChinese is better at recognizing correct tones than specifying what exactly went wrong, especially if the melody of your voice could not be determined accurately. So we advice you to always look at the red tone contour to see what happened.
39 </span>
41 <span size="large">
42 Advice
43 </span>
45 <span size="medium">
46 After your own speech has been recognized, you will find the result printed out below the recognition result. 
47 </span>
49 <span size="x-large">
50 Buttons
51 </span>
53 <span size="large">
54 Record
55 </span>
57 <span size="medium">
58 Record your voice. You get 2 seconds to speak the requested word. SpeakGoodChinese does not work well if there is background noise. Also, some microphones can add a lot of noise, which could interfere with recognition. The tone recognizer assumes you try to speak the requested word. If you pronounce a different word, the results are unpredictable. In some cases, a wrongly pronounced word can be recognized as correct erroneously. SpeakGoodChinese will try to isolate the word you speak from other sounds. This means that if you pause between syllables, either syllable might be cut off the word and you end up with only a single syllable. In this case, the results of the recognition will be completely random.
59 </span>
61 <span size="large">
62 Play
63 </span>
65 <span size="medium">
66 Replay the recorded sound.
67 </span>
69 <span size="large">
70 Example
71 </span>
73 <span size="medium">
74 Play an example of the requested sound. In the Play menu, you can choose whether to play hummed tones, or existing recordings.
75 </span>
77 <span size="large">
78 Previous
79 </span>
81 <span size="medium">
82 Go to the previous item on the list.
83 </span>
85 <span size="large">
86 Next
87 </span>
89 <span size="medium">
90 Go to the next item on the list
91 </span>
93 <span size="x-large">
94 Menu
95 </span>
97 <span size="large">
98 File
99 </span>
101 <span size="medium">
102 <i>not functional yet</i>
103 Quit - Stop application
104 </span>
106 <span size="large">
107 Play
108 </span>
110 <span size="medium">
111 <u>Before</u>
112 </span>
114 <span size="medium">
115 Play an example before you Record
116 </span>
118 <span size="medium">
119 <i>Mandarin</i> - Play an existing example
120 </span>
122 <span size="medium">
123 <i>Hum</i> - Generate a hummed contour
124 </span>
126 <span size="medium">
127 <u>Example</u>
128 </span>
130 <span size="medium">
131 The example played after pushing the Example button
132 </span>
134 <span size="medium">
135 <i>Mandarin</i> - Play a pre-recorded example or resynthesize the last the correct tones (if available)
136 </span>
138 <span size="medium">
139 <i>Hum</i> - Generate a hummed contour
140 </span>
142 <span size="large">
143 Voice
144 </span>
146 <span size="medium">
147 You must choose what type of voice you have. Basically, if you often get "Too Low" or "Too High"  messages, you might want to raise or lower the indicated register. You can always look at the display and try to find a voice register that makes your own voice (red line) match the Reference Pitch (black line) best. The frequency (in Hz) indicated is always the ideal frequency of the first tone.
148 </span>
150 <span size="medium">
151 <i>Male (150Hz)</i> - Low range male
152 </span>
154 <span size="medium">
155 <i>Male (200Hz)</i> - Mid range male
156 </span>
158 <span size="medium">
159 <i>Female (300Hz)</i> - Mid range female
160 </span>
162 <span size="medium">
163 <i>Child (450Hz)</i> - High pitch voice, children
164 </span>
166 <span size="large">
167 Words
168 </span>
170 <span size="medium">
171 <i>Add+</i> - Add a word to the list
172 (the file tests.txt)
173 </span>
175 <span size="mlarge">
176 Help
177 </span>
179 <span size="medium">
180 <i>About</i> - About the SpeakGoodChinese application
181 </span>