Advanced Gtk+ Sequencer
====

Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.  This file is offered as-is,
without any warranty.

jkraehemann@gmail.com

It is recommended to have a realtime kernel in conjunction with ags in order to do more computing expensive synthesis.

Please visit http://rt.wiki.kernel.org for more information.

Following site gives you advice in configuring ALSA

http://www.alsa-project.org/main/index.php/Low_latency_howto

You might want to disable systemd accounting.

https://www.freedesktop.org/software/systemd/man/systemd.resource-control.html

$ systemd-run -p CPUAccounting=false -p MemoryAccounting=false -p TasksAccounting=false -p IOAccounting=false -p BlockIOAccounting=false --scope gsequencer

If you have pulseaudio running you might run `gsequencer` with pasuspender like:

$ pasuspender -- gsequencer

Purpose
====

The Advanced Gtk+ Sequencer framework is related to audio computation by representing it within a tree structure. It does various
abstraction and the base library can serve as fundament of any application.

libags provides an application context and a threaded tree. Which is synchronized by hard-realtime fashion. In terms of deterministic
dead-line. Each tic of the used threads has to fulfill its work in order to proceed. The file object might be used for light-weight
composition or persistency.

libags-audio is built upon libags and provides a tree of audio signals. They can be computed in parallel. One key feature is the
nested recycling tree. It allows to share audio data across channels. Further it avoids to wedge the parallel tree. There is support
for free plugin standards like LADPSA, DSSI and Lv2. So it does give support to read or write MIDI data.

libags-gui is a standalone library providing additional Gtk+-2.0 widgets.

GSequencer is the main application providing a Gtk+-2.0 GUI. Allowing you to edit or record notation. It is designed to be accessible
you should be able to control the entire application by keyboard. Likewise it implements various Atk interfaces. The frontend to AGS
requires to add machines by menubar and link them appropriately with properties dialog. It is available of the context menu. Note you can't
create any loops within the tree.

General Notes on Licensing
====

Following images are used by the documentation and hence are distributed under the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation.

* docs/images/ags_export_window.png
* docs/images/ags_machine_properties-input.png
* docs/images/ags_machine_properties-resize_channels.png
* docs/images/ags_navigation.png
* docs/images/ags_synth.png
* docs/images/ags_audio_preferences.png
* docs/images/ags_ffplayer.png
* docs/images/ags_ladspa_browser.png
* docs/images/ags_machine_properties-link_input.png
* docs/images/ags_matrix.png
* docs/images/ags_panel.png
* docs/images/ags-toolbar.png
* docs/images/ags_drum.png
* docs/images/ags_generic_preferences.png
* docs/images/ags_machine_properties-output.png
* docs/images/ags_mixer.png
* docs/images/ags_performance_preferences.png
* docs/images/ags_server_preferences.png
* docs/images/AGS_iterator.png \
* docs/images/AGS_recall_lifecycle.png \
* docs/images/AGS_super-threaded.png

Following listings are used by the documentation and hence are distributed under the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation.

* docs/listings/effects_echo_channel.c
* docs/listings/file_property.c
* docs/listings/effects_echo_audio.c
* docs/listings/linking_prerequisites.c
* docs/listings/linking_safe.c
* docs/listings/effects_echo_audio_run.c
* docs/listings/effects_recall_container.c
* docs/listings/file_write.c
* docs/listings/add_pattern.c
* docs/listings/linking_unsafe.c
* docs/listings/thread_application_context.c
* docs/listings/effects_echo_channel_run.c
* docs/listings/audio.c
* docs/listings/pull_thread.c
* docs/listings/application_mutex.c
* docs/listings/audio_application_context.c
* docs/listings/recycling.c
* docs/listings/config.c
* docs/listings/pcm_info.c
* docs/listings/start_thread.c
* docs/listings/file_read.c
* docs/listings/complete_example.c

The Advanced Gtk+ Sequencer logo is used by the final binary hence it is applied under 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.

* gsequencer.share/images/ags.png

As well the desktop file:

* gsequencer.desktop.in

And so for the glib-object marshallers file:

* ags/object/ags_marshallers.list

Third-party files with uncertain copyright provided by gtk-doc:

* docs/reference/libags/Makefile.am
* docs/reference/libags/git.mk
* docs/reference/libags/gtk-doc.make
* docs/reference/libags-audio/Makefile.am
* docs/reference/libags-audio/git.mk
* docs/reference/libags-audio/gtk-doc.make
* docs/reference/libags-gui/Makefile.am
* docs/reference/libags-gui/git.mk
* docs/reference/libags-gui/gtk-doc.make
* docs/reference/libgsequencer/Makefile.am
* docs/reference/libgsequencer/git.mk
* docs/reference/libgsequencer/gtk-doc.make
* gtk-doc.make
* m4/gtk-doc.m4

Third-party files with uncertain copyright provided by autotools:

* compile
* compile.guess
* config.h.in
* config.rpath
* config.sub
* configure
* depcomp
* INSTALL
* install-sh
* ltmain.sh
* Makefile.in
* missing
* test-driver

Generated files with uncertain copyright done with glib-genmarshal

ags/object/ags_marshal.c
ags/object/ags_marshal.h

Third-party files with uncertain copyright provided by http://kxstudio.sf.net:

lv2/lv2plug.in/ns/lv2ext/lv2_programs.h

Third-party files with uncertain copyright provided by http://drobilla.net:

lv2.lib/mda/EPiano-presets.ttl
