File: chap8.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 (45 lines) | stat: -rw-r--r-- 1,973 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
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE chapter>

<!-- 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"
	 xmlns:xi="http://www.w3.org/2001/XInclude" version="5.0">
  <title>Your audio data in AgsAudioSignal</title>
  <para>
    AgsAudioSignal is the object orientated representation of your audio data.
    It has a GList with data pointer to audio buffers. There convenience functions
    to resize the stream.
  </para>

  <itemizedlist mark="bullet">
    <listitem>
      <code language="C">void ags_audio_signal_stream_resize(AgsAudioSignal*, guint)</code>
    </listitem>
    <listitem>
      <code language="C">void ags_audio_signal_stream_safe_resize(AgsAudioSignal*, guint)</code>
    </listitem>
    <listitem>
      <code language="C">void ags_audio_signal_add_stream(AgsAudioSignal*)</code>
    </listitem>
  </itemizedlist>

  <para>
    There exists a safe resize function because the audio signal might be in use
    and it doesn't allow to shrink beyond used entries. This could be fatal if
    an effect processor is using the stream and it gets freed as it uses it.
  </para>

  <para>
    <code language="C">void ags_audio_signal_duplicate_stream(AgsAudioSignal*, AgsAudioSignal*)</code>
    can be used to blue-print one audio signals buffer to an other audio signal. Or you might call
    <code language="C">AgsAudioSignal* ags_audio_signal_get_template(GList*)</code>
    from your AgsRecycling internal GList of audio signals to get the template.
  </para>
</chapter>