# SPDX-FileCopyrightText: 2026 Brad Barnett
#
# SPDX-License-Identifier: MIT
# Generated by tools/make_faces.py from audioinstruments._rack.instruments.string_ensemble.StringEnsemble: edit that, then run it again.
"""StringEnsemble, a fully polyphonic divide-down string machine with one shared envelope, a monophonic bass and a three-phase ensemble, inspired by the ARP/Eminent Solina String Ensemble."""
NAME = "string_ensemble"
DISPLAY_NAME = "String Ensemble"
CATEGORIES = ("Synth",)
VERSION = "0.5.3.dev1"
VENDOR = "PyDevices"
MACRO_LABELS = (
"crescendo",
"sustain_length",
"bass_volume",
"volume",
"tune",
"vel_vca",
)
MACRO_MODES = {
0: "UNIPOLAR",
1: "UNIPOLAR",
2: "UNIPOLAR",
3: "UNIPOLAR",
4: "BIPOLAR",
5: "UNIPOLAR",
}
PATCHES = {
0: ("Init", (50, 50, 63, 88, 63, 0)),
1: ("Full Strings", (50, 63, 57, 73, 63, 0)),
2: ("Slow Swell", (107, 88, 63, 91, 63, 0)),
3: ("High Violins", (31, 50, 63, 120, 63, 0)),
4: ("Dark Violas", (50, 63, 57, 73, 63, 0)),
5: ("Brass Section", (6, 25, 63, 101, 63, 0)),
6: ("Muted Horns", (38, 38, 63, 124, 63, 0)),
7: ("Strings and Brass", (38, 50, 63, 99, 63, 0)),
8: ("Dry Strings", (50, 50, 63, 88, 63, 0)),
9: ("Bass Pedal", (50, 50, 82, 82, 63, 0)),
10: ("Everything", (38, 63, 50, 63, 63, 0)),
11: ("Staccato Strings", (0, 0, 63, 88, 63, 0)),
}
[docs]
def create(sample_rate, channel_count=2, transport=None, **options):
"""A live String Ensemble. See ``audioinstruments.create`` for the options."""
from . import _build
return _build(NAME, sample_rate, channel_count, transport, options)