summaryrefslogtreecommitdiffstats
path: root/tde-i18n-ru/docs/tdemultimedia/artsbuilder/modules.docbook
blob: 8b5ae5b969d4afad7459e09a3143abede4987efc (plain)
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
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
<!-- <?xml version="1.0" ?>
<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd">
To validate or process this file as a standalone document, uncomment
this prolog. Be sure to comment it out again when you are done -->

<chapter id="arts-modules">
<title>Модули &arts;</title>

  <sect1 id="modules-introduction">
<title>Введение</title>

<para>В этой главе рассказывается обо всех стандартных модулях &arts;. Это, пожалуй, самое мощное средство &arts;. Модули можно объединять в структуры, получая эффекты и инструменты. </para>

<para>Есть два вида модулей. Модули-синтезаторы используются для создания различных эффектов, инструментов, микшеров и приложений с помощью потоков мультимедиа-данных. С помощью визуальных модулей вы сможете создать графический интерфейс управления встроенными в синтезаторы звуковыми структурами. </para>

</sect1>

<sect1 id="synth-modules-reference">
<title>Описание модулей-синтезаторов</title>
 

<sect2 id="mcat-synth-arithmetic-mixing">
<title>Арифметика + Микширование</title>

 

<sect3 id="mref-synth-add-sect">
<title>Synth&lowbar;ADD</title>
<anchor id="mref-synth-add"/>

<mediaobject>
<imageobject>
<imagedata fileref="images/Synth_ADD.png" format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;ADD</phrase></textobject>
</mediaobject>

<para>Добавляет два сигнала. </para>

</sect3>

<sect3 id="mref-synth-mul-sect">
<title>Synth&lowbar;MUL</title>
<anchor id="mref-synth-mul"/>

<mediaobject>
<imageobject>
<imagedata fileref="images/Synth_MUL.png" format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;MUL</phrase></textobject>
</mediaobject>

<para>Умножает сигнал на коэффициент. Его можно использовать для понижения сигнала (0 &lt; коэффициент &lt; 1), повышения (коэффициент&gt; 1) или инвертирования (коэффициент &lt; 0). Заметьте, что коэффициентом может быть не только константа, но и сигнал (например, оболочка или настоящий сигнал). </para>

</sect3>

<sect3 id="mref-synth-div-sect">
<title>Synth&lowbar;DIV</title>
<anchor id="mref-synth-div"/>

<mediaobject>
<imageobject>
<imagedata fileref="images/Synth_DIV.png" format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;DIV</phrase></textobject>
</mediaobject>

<para>Делит значение сигнала на какую-либо величину, например, на другой сигнал. Зайдайте invalue1 равным 1, и получите обратную величину для invalue2 в outvalue. Конечно, значение invalue2 не должно обращаться в 0, иначе возникнет ошибка деления на ноль. </para>

</sect3>

<sect3 id="mref-synth-multi-add-sect">
<title>Synth&lowbar;MULTI&lowbar;ADD</title>
<anchor id="mref-synth-multi-add"/>

<mediaobject>
<imageobject>
<imagedata fileref="images/Synth_MULTI_ADD.png"
  format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;MULTI&lowbar;ADD</phrase></textobject>
</mediaobject>

<para>Добавляет случайное количество сигналов. Если вам нужно объединить сигналы четырёх осцилляторов, можете подключить их выходы к одному модулю Synth&lowbar;MULTI&lowbar;ADD. Это будет эффективнее использования трёх модулей Synth&lowbar;ADD. </para>

</sect3>

<sect3 id="mref-synth-xfade-sect">
<title>Synth&lowbar;XFADE</title>
<anchor id="mref-synth-xfade"/>

<mediaobject>
<imageobject><imagedata fileref="images/Synth_XFADE.png" format="PNG"/>
</imageobject>
<textobject><phrase>Synth&lowbar;XFADE</phrase></textobject>
</mediaobject>

<para>Приглушает два сигнала. Если входное значение -1, будет слышен только левый сигнал, 1 - правый, 0 - оба сигнала слышны с одинаковой громкостью. </para>

<para>С помощью этого модуля вы сможете убедиться, что сигнал находится в определённом диапазоне. Если у вас было два сигнала из диапазона -1..1, после обработки этим модулем они будут такими же. </para>
</sect3>

<sect3 id="mref-synth-autopanner-sect">
<title>Synth&lowbar;AUTOPANNER</title>
<anchor id="mref-synth-autopanner"/>

<para>Эфект, обратный crossfader. Преобразовывает моносигнал в стерео. Используется автоматически для разделения между правым и левым выходами. Стандартным приложением может быть гитара или другой сольный инструмент. </para>

<para>Соедините генератор низких частот, источник синусоидального или пилообразного сигнала с inlfo и задайте частоту между 0,1 и 5 Гц для создания обычного эффекта или больше, если хотите создать особый. </para>

</sect3>

</sect2>

<sect2 id="mcat-synth-busses">
<title>Шины</title>

<sect3 id="mref-synth-bus-uplink-sect">
<title>Synth&lowbar;BUS&lowbar;UPLINK</title>
<anchor id="mref-synth-bus-uplink"/>

<mediaobject>
<imageobject><imagedata fileref="images/Synth_BUS_UPLINK.png"
               format="PNG"/>
</imageobject>
<textobject><phrase>Synth&lowbar;BUS&lowbar;UPLINK</phrase></textobject>
</mediaobject>

<para>Входная связь шины. Передает сигналы левого и правого каналов, также имя шины, куда передаются данные. Комбинированный сигнал со всех входных связей с таким именем будет появляться на выходной связи этой шины. </para>
</sect3>

<sect3 id="mref-synth-bus-downlink-sect">
<title>Synth&lowbar;BUS&lowbar;DOWNLINK</title>
<anchor id="mref-synth-bus-downlink"/>

<mediaobject>
<imageobject>
<imagedata fileref="images/Synth_BUS_DOWNLINK.png"
  format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;BUS&lowbar;DOWNLINK</phrase></textobject>
</mediaobject>

<para>Получает (суммирует) все данные с конкретной шины (с именем, указанным в портешины). </para>
</sect3>

</sect2>

<!-- TODO AFTER KDE2.1: move freeverb into delays, and rename category to
     Delays &amp; reverbs -->

<sect2 id="mcat-synth-delays">
<title>Задержки</title>

 

<sect3 id="mref-synth-delay-sect">
<title>Synth&lowbar;DELAY</title>
<anchor id="mref-synth-delay"/>

<mediaobject>
<imageobject><imagedata fileref="images/Synth_DELAY.png"
               format="PNG"/></imageobject></mediaobject>

<para>Задерживает входящий сигнал на определённое время. Оно задаётся в секундах и не должно превышать максимальное значние задержки. </para>

<para>Этот тип задержек <emphasis>не следует использовать</emphasis> в структурах обратной связи, т. к. это непостоянная задержка: вы можете изменить её длительность во время исполнения программы и даже дать ей значение 0. Но в структурах обратной связи собственный вывод используется для вычисления следующих сэмплов, поэтому задержка, которую можно свести к 0 во время синтеза, может привести к нежелательным последствиям. </para>

<para>Используйте CDELAY в этих настройках. Можно сочетать небольшую постоянную задержку (0,001 секунд) с переменной. </para>

<para>Также вы можете комбинировать CDELAY и DELAY, чтобы получить переменную длину задержки с минимальным значением в петле обратной связи. Просто убедитесь, что используете CDELAY. </para>

</sect3>

<sect3 id="mref-synth-cdelay-sect">
<title>Synth&lowbar;CDELAY</title>
<anchor id="mref-synth-cdelay"/>

<mediaobject>
<imageobject><imagedata fileref="images/Synth_CDELAY.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;CDELAY</phrase></textobject>
</mediaobject>

<para>Задерживает входной сигнал на определённое время. Значение должно быть больше 0 для задержки в 0 секунд и дольше. Оно постоянно во время выполнения программы, т.е. не может быть изменено. </para>

<para>Сокращает время обработки засчёт того, что не выполняет интерполяцию. Полезен в рекурсивных структурах. Описание смотрите ниже (Synth&lowbar;DELAY). </para>

</sect3>

</sect2>

<sect2 id="mcat-synth-envelopes">
<title>Оболочки</title>

 

<sect3 id="mref-synth-envelope-adsr-sect">
<title>Synth&lowbar;ENVELOPE&lowbar;ADSR</title>
<anchor id="mref-synth-envelope-adsr"/>

<mediaobject>
<imageobject><imagedata fileref="images/Synth_ENVELOPE_ADSR.png"
               format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;ENVELOPE&lowbar;ADSR</phrase></textobject>
</mediaobject>

<para>Это классическая <acronym>ADSR</acronym>-оболочка; подразумевается, что вы укажете следущее: </para>

<variablelist>
<varlistentry>
<term>active</term>
<listitem>
<para>Нажата ли нота в данный момент. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>invalue</term>
<listitem>
<para>Входной сигнал. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>attack</term>
<listitem>
<para>Время между нажатием клавиши и достижением максимальной амплитуды сигнала (в секундах). </para>
</listitem>
</varlistentry>

<varlistentry>
<term>decay</term>
<listitem>
<para>Время, необходимое для того, чтобы сигнал с максимальной амплитудой вернулся к некоторому постоянному уровню (в секундах). </para>
</listitem>
</varlistentry>

<varlistentry>
<term>sustain</term>
<listitem>
<para>Уровень сигнала до того, как пользователь отпустит клавишу. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>release</term>
<listitem>
<para>Время (в секундах) до полного затухания сигнала после того, как пользователь отпустил клавишу. </para>
</listitem>
</varlistentry>
</variablelist>

<para>На выходе получится сигнал с заданными параметрами. Если оболочка <acronym>ASDR</acronym> закончила работу, установится значение 1. Этоможно ипользовать для обеспечения <quote>готовых</quote> выходных данных инструмента (при этом после завершения фазы &MIDI; маршрутизатор разрушит объект). </para>

</sect3>

<sect3 id="mref-synth-pscale-sect">
<title>Synth&lowbar;PSCALE</title>
<anchor id="mref-synth-pscale"/>

<mediaobject>
<imageobject><imagedata fileref="images/Synth_PSCALE.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;PSCALE</phrase></textobject>
</mediaobject>

<para>Модуль Synth&lowbar;PSCALE управляет уровнем громкости пропускаемого сигнала: от 0 (тихо) до 1 (исходная громкость) и опять до 0. Точка наивысшего уровня громкости может меняться в зависимости от pos (получается из Synth&lowbar;SEQUENCE). </para>

<para>Пример: установка пика в 0,1 приведёт к тому, что после проигрыша 10&percnt; ноты звук достигнет максимума и начнет затухать. </para>
</sect3>

</sect2>

<sect2 id="mcat-synth-effects">
<title>Эффекты</title>

<sect3 id="mref-synth-freeverb-sect">
<title>Synth&lowbar;FREEVERB</title>
<anchor id="mref-synth-freeverb"/>

<mediaobject>
<imageobject><imagedata fileref="images/Synth_FREEVERB.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;FREEVERB</phrase></textobject>
</mediaobject>

<para>Это эффект реверберации. В этой реализации сигнал проходит через модуль и к нему будет добавлен его же эхо. </para>

<note>
<para>Это значит, что им можно пользоваться и в StereoEffectStack. </para>
</note>

<para>Входной сигнал должен быть подключен к (inleft, inright), а выходной будет (outleft, outright). </para>

<para>Параметры: </para>

<variablelist>
<varlistentry>
<term>roomsize</term>
<listitem>
<para>Размер помещения, в котором эмулируется эхо (диапазон: 0..1, где 1 - самый большой размер помещения). </para>
</listitem>
</varlistentry>

<varlistentry>
<term>damp</term>
<listitem>
<para>Настраивает фильтр поглощения высоких частот (диапазон: 0..1, при значении 1 частоты сильно поглощаются). </para>
</listitem>
</varlistentry>

<varlistentry>
<term>wet</term>
<listitem>
<para>Величина сигнала эха (часть исходного сигнала, которая должна быть преобразована фильтрами). </para>
</listitem>
</varlistentry>

<varlistentry>
<term>dry</term>
<listitem>
<para>Количество звука, для которого создается обычное эхо (или задержка) вместо реверберации (диапазон: 0..1). </para>
<!-- TODO: do some measurements to show that this documentation -is- correct,
I am not sure if it is echo, or really pure (non-delayed), or multiple delay
or whatever -->
</listitem>
</varlistentry>

<varlistentry>
<term>width</term>
<listitem>
<para>Величина, добавляемая алгоритмом, чтобы сделать звук более <quote>широким</quote> в пространстве (диапазон: 0..1). </para>
</listitem>
</varlistentry>

<varlistentry>
<term>mode</term>
<listitem>
<para>В значении 0 происходит обычная обработка. </para>
</listitem>
</varlistentry>
</variablelist>

</sect3>

<sect3 id="mref-synth-tremolo-sect">
<title>Synth&lowbar;TREMOLO</title>
<anchor id="mref-synth-tremolo"/>

<mediaobject><imageobject><imagedata fileref="images/Synth_TREMOLO.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;TREMOLO</phrase></textobject>
</mediaobject>

<para>Тремоло модулирует амплитуду в соответствии с волной генератора нихких частот. Вы, наверное, использовали бы синусоидальную волну, но... Зачем же ограничивать себя? Вы получите сильный эффект, пробивающийся сквозь все остальные звуки из-за его широкого динамического диапазона. Тремоло - один из любимых эффектов гитаристов, хотя сейчас он не столь популярен, как это было в 1960-х. </para>

<para>Сейчас вычисляется как invalue + abs(inlfo). Возможно, будет лучше использовать такую формулу: invalue * (1+inlfo*depth), где depth - параметр со значением из диапазона 0..1. </para>

</sect3>
<sect3 id="mref-synth-fx-cflanger-sect">
<title>Synth&lowbar;FX&lowbar;CFLANGER</title>
<anchor id="mref-synth-fx-cflanger"/>

<mediaobject><imageobject><imagedata
fileref="images/Synth_FX_CFLANGER.png" format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;FX&lowbar;CFLANGER</phrase></textobject>
</mediaobject>

<para>Эффект задержки, непостоянной во времени, <quote>флэнджер</quote>. </para>

<para>Порты модуля:</para>

<variablelist>
<varlistentry>
<term>invalue</term>
<listitem>
<para>Обрабатываемый сигнал. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>lfo</term>
<listitem>
<para>Предпочтительно синусоидальная волна, определяющая время задержки: (-1 .. 1). </para>
</listitem>
</varlistentry>

<varlistentry>
<term>mintime</term>
<listitem>
<para>Минимальное значение задержки внутри модуля (в миллисекундах). Рекомендуемые значения: попробуйте 1 мс. Используйте значения &lt; 1000 мс. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>maxtime</term>
<listitem>
<para>Максимальное значение задержки внутри модуля (в миллисекундах). Рекомендуемые значения: попробуйте 5 мс. Используйте значения &lt; 1000 мс. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>outvalue</term>
<listitem>
<para>Полученный сигнал. Для достижения эффекта нужно его смешать с исходным сигналом. </para>
</listitem>
</varlistentry>
</variablelist>

<tip>
<para>Вы можете сделать это основой эффекта <quote>хора</quote>. </para>
</tip>

</sect3>

</sect2>

<sect2 id="mcat-synth-filters">
<title>Фильтры</title>

<sect3 id="mref-synth-pitch-shift-sect">
<title>Synth&lowbar;PITCH&lowbar;SHIFT</title>
<anchor id="mref-synth-pitch-shift"/>

<mediaobject><imageobject><imagedata
fileref="images/Synth_PITCH_SHIFT.png" format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;PITCH&lowbar;SHIFT</phrase></textobject>
</mediaobject>

<para>Этот эффект сдвига высоты звука меняет частоту входного сигнала, оставляя скорость прежней. Примером приложения,. использующего этот эффект, может быть такое, которое меняет высоту голоса при записи (и проигрывании). </para>

<para>Параметр <emphasis>speed</emphasis> - это относительная скорость проигрывания сигнала. Поэтому если дать ему значение 2, звук будет выше в два раза (например, входная частота 440 Hz, а на выходе будет 880 Hz). </para>

<para>Параметр <emphasis>frequency</emphasis> используется для внутреннего переключения между разными частями сигнала. В зависимости от настроек звук будет боле или менее реалистичным. Советую начать со значений 5 или 10. </para>

</sect3>

<sect3 id="mref-synth-shelve-cutoff-sect">
<title>Synth&lowbar;SHELVE&lowbar;CUTOFF</title>
<anchor id="mref-synth-shelve-cutoff"/>

<mediaobject><imageobject><imagedata
fileref="images/Synth_SHELVE_CUTOFF.png" format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;SHELVE&lowbar;CUTOFF</phrase></textobject>
</mediaobject>

<para>Фильтрует все частоты выше заданного порога. </para>

</sect3>

<sect3 id="mref-synth-brickwall-limiter-sect">
<title>Synth&lowbar;BRICKWALL&lowbar;LIMITER</title>
<anchor id="mref-synth-brickwall-limiter"/>

<mediaobject><imageobject><imagedata
fileref="images/Synth_BRICKWALL_LIMITER.png"
                            format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;BRICKWALL&lowbar;LIMITER</phrase></textobject>
</mediaobject>

<para>Этот модуль обрезает сигнал таким образом, чтобы он попадал в диапазон [-1;1]. Но он не предотвращает искажение, возникающее при обрезании громкого сигнала. Его можно использовать как эффект (например, чтобы получить слегка обрезанную синусоидальную волну). Звук будет не таким резким, если пропустить сигнал через фильтр низких частот. </para>
</sect3>

<sect3 id="mref-synth-std-equalizer-sect">
<title>Synth&lowbar;STD&lowbar;EQUALIZER</title>
<anchor id="mref-synth-std-equalizer"/>

<mediaobject><imageobject><imagedata
fileref="images/Synth_STD_EQUALIZER.png" format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;STD&lowbar;EQUALIZER</phrase></textobject>
</mediaobject>

<para>Это неплохой эквалайзер. Его параметры: </para>

<variablelist>
<varlistentry>
<term>invalue, outvalue</term>
<listitem>
<para>Сигнал, который фильтрует эквалайзер. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>low</term>
<listitem>
<para>Как следует менять низкие частоты. Значение задаётся в децибелах. 0 значит, что их не нужно менять, -6 - понижены на 6 дб, +6 - повышены. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>mid</term>
<listitem>
<para>Как следует менять средние частоты. Значение задаётся в децибелах. (см. low). </para>
</listitem>
</varlistentry>

<varlistentry>
<term>high</term>
<listitem>
<para>Как следует менять высокие частоты. Значение задаётся в децибелах. (см. low). </para>
</listitem>
</varlistentry>

<varlistentry>
<term>frequency</term>
<listitem>
<para>Это средняя частота эквалайзера в Гц, средние частоты находятся вокруг этого спктра, нижние - ниже, верхние - выше. Заметьте, что частота не может быть выше половины частоты дискретизации, обычно это 22050 Гц, и ниже 1 Гц. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>q</term>
<listitem>
<para>Показывает, насколько широк спектр средних частот. Это должно быть положительное число &gt; 0. Значение 1 вполне приемлемо. С увеличением значения спектр становится уже, а с уменьшением - шире. </para>
</listitem>
</varlistentry>
</variablelist>

</sect3>

<sect3 id="mref-synth-rc-sect">
<title>Synth&lowbar;RC</title>
<anchor id="mref-synth-rc"/>

<mediaobject><imageobject><imagedata fileref="images/Synth_RC.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;RC</phrase></textobject>
</mediaobject>

<para>Фильтр всех частот вокруг некоторого пикового значения. Не рекомендуется указывать среднуюю частоту (она все равно не будет обрезана). Этот код довольно старый и, возможно, будет заменен новым фильтром, который будет принимать в качестве параметров понятные значения, а не странные f и b. </para>

<para>Попробуйте b=5, f=5 или b=10, f=10 или b=15, f=15. </para>

</sect3>

<sect3 id="mref-synth-moog-vcf-sect">
<title>Synth&lowbar;MOOG&lowbar;VCF</title>
<anchor id="mref-synth-moog-vcf"/>

<mediaobject><imageobject><imagedata fileref="images/Synth_MOOG_VCF.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;MOOG&lowbar;VCF</phrase></textobject>
</mediaobject>

<para>Отфильтровывает все частоты, выходящие за предел (фильтр четырехполюсника 24 дб, который фильтрует -24db в октаве выше пороговой частоты), есть возможность настроить резонанс фильтрации, 0 - без резонанса, 4 - собственные колебания. </para>

</sect3>

</sect2>

<sect2 id="mcat-synth-midi-sequencing">
<title>Midi + Синтезирование</title>

<sect3 id="mref-synth-midi-test-sect">
<title>Synth&lowbar;MIDI&lowbar;TEST</title>
<anchor id="mref-synth-midi-test"/>

<mediaobject><imageobject><imagedata fileref="images/Synth_MIDI_TEST.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;MIDI&lowbar;TEST</phrase></textobject>
</mediaobject>

<para>Загружает структуру инструмента из файла и регистрирует себя как midi-выход с &arts; &MIDI;-менеджером. Ноты, посланные на выход, будут создавать звучание инструмента. </para>

<note>
<para>Настраивать это в &artscontrol; удобнее, чем вручную в &arts-builder;. </para>
</note>

</sect3>

<sect3 id="mref-synth-sequence-sect">
<title>Synth&lowbar;SEQUENCE</title>
<anchor id="mref-synth-sequence"/>

<mediaobject><imageobject><imagedata fileref="images/Synth_SEQUENCE.png"
format="PNG"/></imageobject></mediaobject>

<para>Будет циклически проигрывать последовательность нот. Ноты разделены точками с запятой. Например: <literal>A-3;C-4;E-4;C-4;</literal>. Скорость дана в секундах на ноту, поэтому если вы хотите получить 120 уд./мин., нужно будет указать 0,5 секунд/нота, т. к. 60 секунд/0,5 секунд на ноту = 120 уд./мин. </para>

<para>Вы можете задать относительную длительность ноты, поставив двоеточие после ноты и записав длительность. <literal>A-3:2;C-4:0.5;D-4:0.5;E-4;</literal>. </para>

<para>С помощью модуля Synth&lowbar;SEQUENCE можно получить дополнительную информацию о проигрываемой ноте. 0 значит, что она только что началась, 1 - закончилась. Эту информацию использует Synth&lowbar;PSCALE (см. ниже). </para>
</sect3>

<sect3 id="mref-synth-sequence-freq-sect">
<title>Synth&lowbar;SEQUENCE&lowbar;FREQ</title>
<anchor id="mref-synth-sequence-freq"/>

<mediaobject><imageobject><imagedata fileref="images/Synth_SEQUENCE_FREQ.png"
format="PNG"/></imageobject></mediaobject>

<para>Этот модуль работает как Synth&lowbar;SEQUENCE, только вам нужно указывать не имена нот, а частоты. </para>

</sect3>

</sect2>

<sect2 id="mcat-synth-samples">
<title>Сэмплы</title>

<sect3 id="mref-synth-play-wav-sect">
<title>Synth&lowbar;PLAY&lowbar;WAV</title>
<anchor id="mref-synth-play-wav"/>

<mediaobject>
<imageobject><imagedata fileref="images/Synth_PLAY_WAV.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;PLAY&lowbar;WAV</phrase></textobject>
</mediaobject>

<para>Проигрывает файлы <literal role="extension">wav</literal>., если у вас есть libaudiofile. Как только модуль будет создан, воспроизведение файла начнётся. </para>

<para>И остановится, как только он закончится. Параметр скорости может использоваться, чтобы задать скорость воспроизведения, 1,0 - обычная скорость (записи). </para>
<!-- TODO: KDE2.2: check that this really works together in instruments with
the done parameter things ;) -->
</sect3>

</sect2>

<sect2 id="mcat-synth-soundio">
<title>Ввод и вывод звука</title>

<sect3 id="mref-synth-play-sect">
<title>Synth&lowbar;PLAY</title>
<anchor id="mref-synth-play"/>

<mediaobject>
<imageobject><imagedata fileref="images/Synth_PLAY.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;PLAY</phrase></textobject>
</mediaobject>

<important>
<para>Вам, скорее всего, не понадобится этот модуль, если, конечно, вы не пишете отдельное приложение. В &artsd; уже включен такой модуль, а создать ещё один Synth&lowbar;PLAY не удастся. </para>
</important>

<para>Модуль Synth&lowbar;PLAY передаст сигнал на звуковую карту. Левый и правый каналы должны содержать <emphasis>нормализованный</emphasis> выход для каналов. Если он не будет помещаться в диапазон -1..1, он будет обрезан. </para>

<para>Как уже говорилось, может быть только один Synth&lowbar;PLAY, который будет обращаться к звуковой карте напрямую. Смешивать аудиопотоки перед воспроизведением можно с помощью шин. Модуль Synth&lowbar;AMAN&lowbar;PLAY может использоваться для получения выходного сигнала в &artsd;. </para>

<para>Заметьте, что Synth&lowbar;PLAY осуществляет синхронизацию всей структуры. Это значит, что: нет Synth&lowbar;PLAY = нет синхронизации = нет звука. Один объект Synth&lowbar;PLAY нужен обязательно. </para>

</sect3>

<sect3 id="mref-synth-record-sect">
<title>Synth&lowbar;RECORD</title>
<anchor id="mref-synth-record"/>

<mediaobject><imageobject><imagedata fileref="images/Synth_RECORD.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;RECORD</phrase></textobject>
</mediaobject>

<important>
<para>Вам, скорее всего, не понадобится этот модуль, если, конечно, вы не пишете отдельное приложение. В &artsd; уже включен такой модуль, а создать ещё один Synth&lowbar;RECORD не удастся. </para>
</important>

<para>Synth&lowbar;RECORD записывает сигнал, поступающий со звуковой карты. Левый и правый каналы содержат вход для каналов (между -1 и 1). </para>

<para>Как уже говорилось, может быть только один модуль Synth&lowbar;RECORD, который будет иметь прямой доступ к звуковой карте. Для записи сигнала в нескольких местах используются шины. Synth&lowbar;AMAN&lowbar;RECORD получает что-то вроде входа в artsd. Чтобы это работало, &artsd; должен быть запущен со <emphasis>использованием двустороннего режима</emphasis>. </para>
</sect3>

<sect3 id="mref-synth-aman-play-sect">
<title>Synth&lowbar;AMAN&lowbar;PLAY</title>
<anchor id="mref-synth-aman-play"/>

<mediaobject><imageobject><imagedata fileref="images/Synth_AMAN_PLAY.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;AMAN&lowbar;PLAY</phrase></textobject>
</mediaobject>

<para>Модуль Synth&lowbar;AMAN&lowbar;PLAY выводит сигнал. Очень хорошо, если сигнал нормализован (между -1 и 1), но это необязательно. </para>

<para>С помощью аудиоменеджера модуль определяет, где должен проигрываться сигнал. Управлять аудиоменеджером можно в &artscontrol;. Чтобы управление тало понятнее, назовите как-нибудь сигнал. Это можно сделать, задав <emphasis>title</emphasis>. Ещё одна удобная черта: аудиоменеджер хранит информацию о том, где был воспроизведён сигнал в прошлый раз. Конечно, для этого нужно как-то различать сигналы. Поэтому <emphasis>autoRestoreID</emphasis> должен иметь уникальное значение. </para>
</sect3>

<sect3 id="mref-synth-aman-record-sect">
<title>Synth&lowbar;AMAN&lowbar;RECORD</title>
<anchor id="mref-synth-aman-record"/>

<mediaobject><imageobject><imagedata
fileref="images/Synth_AMAN_RECORD.png" format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;AMAN&lowbar;RECORD</phrase></textobject>
</mediaobject>

<para>Synth&lowbar;AMAN&lowbar;RECORD  записывает сигнал со внешнего источника (напрмер, микрофона) в &artsd;. Выходной сигнал будет нормальзован (между -1 и 1). </para>

<para>С помощью аудиоменеджера модуль определяет, где должен проигрываться сигнал. Управлять аудиоменеджером можно в &artscontrol;. Чтобы управление тало понятнее, назовите как-нибудь сигнал. Это можно сделать, задав <emphasis>title</emphasis>. Ещё одна удобная черта: аудиоменеджер хранит информацию о том, где был воспроизведён сигнал в прошлый раз. Конечно, для этого нужно как-то различать сигналы. Поэтому <emphasis>autoRestoreID</emphasis> должен иметь уникальное значение. </para>
</sect3>

<sect3 id="mref-synth-capture-sect">
<title>Synth&lowbar;CAPTURE</title>
<anchor id="mref-synth-capture"/>

<mediaobject><imageobject><imagedata fileref="images/Synth_CAPTURE.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;CAPTURE</phrase></textobject>
</mediaobject>

<para>Synth&lowbar;CAPTURE запишет аудио сигнал в файл .wav на диск. Именем файла всегда будет <filename>/tmp/mcop-<replaceable>имя_пользователя</replaceable>/capture.wav</filename> </para>
</sect3>

</sect2>

<sect2 id="mcat-synth-tests">
<title>Тесты</title>

<sect3 id="mref-synth-nil-sect">
<title>Synth&lowbar;NIL</title>
<anchor id="mref-synth-nil"/>

<mediaobject><imageobject><imagedata fileref="images/Synth_NIL.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;NIL</phrase></textobject>
</mediaobject>

<para>Ничего не делает, но нужен в тестах. </para>

</sect3>

<sect3 id="mref-synth-debug-sect">
<title>Synth&lowbar;DEBUG</title>
<anchor id="mref-synth-debug"/>

<mediaobject><imageobject><imagedata fileref="images/Synth_DEBUG.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;DEBUG</phrase></textobject>
</mediaobject>

<para>Можно использовать для устранения ошибок. Выводит значение сигнала (invalue) через определённый интервал (1 секунда) и указанный вами комментарий. Таким образом вы сможете отследить сигналы и их диапазоны. </para>
</sect3>

<sect3 id="mref-synth-midi-debug-sect">
<title>Synth&lowbar;MIDI&lowbar;DEBUG</title>
<anchor id="mref-synth-midi-debug"/>

<mediaobject><imageobject><imagedata fileref="images/Synth_MIDI_DEBUG.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;MIDI&lowbar;DEBUG</phrase></textobject>
</mediaobject>

<para>Нужен, чтобы посмотреть, как действительно события &MIDI; попадают в &arts;. </para>

<para>Во время работы MIDI&lowbar;DEBUG &artsserver; будет печатать такие строки: </para>

<screen><computeroutput>201 100753.837585 on 0 42 127</computeroutput></screen>

<screen><computeroutput>202 101323.128355 off 0 42</computeroutput></screen>

<para>В первой строке говорится, что прошло 00753 мс (это 100 секунд) с момента запуска MIDI&lowbar;DEBUG, на канал 0 поступило событие &MIDI;. Его громкость 127 (максимально возможная). В следущей строке событие освобождается. </para>
</sect3>

<sect3 id="mref-synth-data-sect">
<title>Synth&lowbar;DATA</title>
<anchor id="mref-synth-data"/>

<mediaobject><imageobject><imagedata fileref="images/Synth_DATA.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;DATA</phrase></textobject>
</mediaobject>

<para>Создаёт сигнал с постоянным числом. </para>
<!-- TODO: this doesn't really belong in test, does it? -->
</sect3>
</sect2>

<sect2 id="mcat-synth-osc-mod">
<title>Осцилляция и модуляция</title>

<sect3 id="mref-synth-frequency-sect">
<title>Synth&lowbar;FREQUENCY</title>
<anchor id="mref-synth-frequency"/>

<mediaobject><imageobject><imagedata fileref="images/Synth_FREQUENCY.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;FREQUENCY</phrase></textobject>
</mediaobject>

<para>Осцилляторам &arts; нужна не частота как входной параметр, а положение в волне. Она должна быть между 0 и 1 для отображения стандартного объекта Synth&lowbar;WAVE&lowbar;SIN в диапазон 0..2*Пи. Synth&lowbar;FREQUENCY используется для генерации колебательных значений из частоты. </para>
</sect3>

<sect3 id="mref-synth-fm-source-sect">
<title>Synth&lowbar;FM&lowbar;SOURCE</title>
<anchor id="mref-synth-fm-source"/>

<mediaobject><imageobject><imagedata fileref="images/Synth_FM_SOURCE.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;FM&lowbar;SOURCE</phrase></textobject>
</mediaobject>

<para>Используется для модуляции частоты. Укажите частоту ввода; на ввод модулятора подайте сигнал. Уровень модуляции задайте как, скажем, 0.3. Частота будет модулироваться. Просто попробуйте. </para>

<para>Замечательно работает вместе с осцилляорами Synth&lowbar;WAVE&lowbar;SIN. </para>
</sect3>

</sect2>

<sect2 id="mcat-synth-waveforms">
<title>Формы сигналов</title>

<sect3 id="mref-synth-wave-sin-sect">
<title>Synth&lowbar;WAVE&lowbar;SIN</title>
<anchor id="mref-synth-wave-sin"/>

<mediaobject><imageobject><imagedata fileref="images/Synth_WAVE_SIN.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;WAVE&lowbar;SIN</phrase></textobject>
</mediaobject>

<para>Синусоидальный сигнал. На вход ставится pos signal из Synth&lowbar;FREQUENCY или Synth&lowbar;FM&lowbar;SOURCE, а на выходе получается синусоидальный сигнал. Pos signal указывает на позицию в волне, а диапазон 0..1 отображается в 0..2*Пи. </para>

</sect3>

<sect3 id="mref-synth-wave-tri-sect">
<title>Synth&lowbar;WAVE&lowbar;TRI</title>
<anchor id="mref-synth-wave-tri"/>

<mediaobject><imageobject><imagedata fileref="images/Synth_WAVE_TRI.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;WAVE&lowbar;TRI</phrase></textobject>
</mediaobject>

<para>Треугольный сигнал. На вход подается pos signal из Synth&lowbar;FREQUENCY или Synth&lowbar;FM&lowbar;SOURCE, а на выходе получаются треугольные колебания. Pos signal указывает на позицию в волне, а диапазон 0..1 отображается в 0..2*Пи. Будьте внимательны, входной сигнал <emphasis>должен</emphasis>быть в диапазоне 0..1, чтобы получить какой-нибудь результат. </para>
</sect3>

<sect3 id="mref-synth-noise-sect">
<title>Synth&lowbar;NOISE</title>
<anchor id="mref-synth-noise"/>

<mediaobject><imageobject><imagedata fileref="images/Synth_NOISE.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;NOISE</phrase></textobject>
</mediaobject>

<para>Генератор шумов. Генерирует случайный сигнал в пределах -1 и 1. </para>

</sect3>

<sect3 id="mref-synth-wave-square-sect">
<title>Synth&lowbar;WAVE&lowbar;SQUARE</title>
<anchor id="mref-synth-wave-square"/>

<mediaobject><imageobject><imagedata
fileref="images/Synth_WAVE_SQUARE.png" format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;WAVE&lowbar;SQUARE</phrase></textobject>
</mediaobject>

<para>Прямоугольный сигнал. На вход ставится pos signal из Synth&lowbar;FREQUENCY или Synth&lowbar;FM&lowbar;SOURCE, а на выходе получаются прямоугольные колебания. Pos signal указывает на позицию в волне, а диапазон 0..1 отображается в 0..2*Пи. Будьте внимательны, входной сигнал <emphasis>должен</emphasis> быть в диапазоне 0..1, чтобы получить какой-нибудь результат. </para>
</sect3>

<sect3 id="mref-synth-wave-softsaw-sect">
<title>Synth&lowbar;WAVE&lowbar;SOFTSAW</title>
<anchor id="mref-synth-wave-softsaw"/>

<mediaobject><imageobject><imagedata
fileref="images/Synth_WAVE_SOFTSAW.png" format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;WAVE&lowbar;SOFTSAW</phrase></textobject>
</mediaobject>

<para>Пилообразный сигнал, похожий на сигнал Synth&lowbar;WAVE&lowbar;TRI. На вход ставится pos signal из Synth&lowbar;FREQUENCY или Synth&lowbar;FM&lowbar;SOURCE, а на выходе получаются зубчатые колебания. Pos signal указывает на позицию в волне, а диапазон 0..1 отображается в 0..2*Пи. Будьте внимательны, входной сигнал <emphasis>должен</emphasis> быть в диапазоне 0..1, чтобы получить какой-нибудь результат. </para>
</sect3>

<sect3 id="mref-synth-wave-pulse-sect">
<title>Synth&lowbar;WAVE&lowbar;PULSE</title>
<anchor id="mref-synth-wave-pulse"/>

<mediaobject><imageobject><imagedata fileref="images/Synth_WAVE_PULSE.png"
format="PNG"/></imageobject>
<textobject><phrase>Synth&lowbar;WAVE&lowbar;PULSE</phrase></textobject>
</mediaobject>

<para>Импульсные колебания. Очень похожи на прямоугольные сигналы (Synth_WAVE_RECT), но для них можно задать соотношение <emphasis>dutycycle</emphasis>. На вход дается pos signal из Synth&lowbar;FREQUENCY или Synth&lowbar;FM&lowbar;SOURCE, а на выходе получаются импульсы. Pos signal указывает на позицию в волне, а диапазон 0..1 отображается в 0..2*Пи. Будьте внимательны, входной сигнал <emphasis>должен</emphasis> быть в диапазоне 0..1, чтобы получить какой-нибудь результат. </para>
</sect3>
</sect2>
<sect2 id="mcat-synth-misc">
<title>Прочее</title>

<sect3 id="mref-synth-compressor-sect">
<title>Synth&lowbar;COMPRESSOR</title>
<anchor id="mref-synth-compressor"/>

<mediaobject>
<imageobject><imagedata fileref="images/Synth_COMPRESSOR.png"
               format="PNG"/></imageobject></mediaobject>

<para>Сокращает динамический диапазон сигнала. Компрессоры полезны, например, для нормализации громкости микрофона. </para>

<para>Как только входной сигнал достигает определённого уровня (порога), сигнал сжимается. Это достигается умножением всего, что выше порога на коэффициент - число от 0 до 1. И весь сигнал умножается на выходной коэффициент. </para>

<para>Параметры attack и release задерживают начало и конец сжатия. Используйте их, если хотите, например, слышать громкое вступление ударных. Значения параметров задаются в миллисекундах. Со значением 0 может усилиться шум. </para>

</sect3>
</sect2>
</sect1>

<sect1 id="visual-modules-reference">
<title>Описание визуальных модулей</title>

<para>Их описание пока не готово. </para>
</sect1>

</chapter>