Added capability of customising minimum amplitude level of enclosures…

… added internally by GrandOrgue GrandOrgue#782

CHANGELOG.md

@@ -1,3 +1,4 @@
+- Added capability of customising minimum amplitude level of enclosures added internally by GrandOrgue https://github.com/GrandOrgue/grandorgue/issues/782
 - Increased the maximum number of user-defined temperaments to 999 https://github.com/GrandOrgue/grandorgue/issues/1982
 # 3.15.4 (2024-12-20)
 - Eliminated a MacOs debug alert when opening a settings dialog https://github.com/GrandOrgue/grandorgue/issues/2003

help/grandorgue.xml

@@ -5649,6 +5649,53 @@ role="bold">Group</emphasis> attribute are grouped in the same submenu.
 	</sect3>
       </sect2>
     </sect1>
+    <sect1>
+      <title>Enclosures</title>
+      <indexterm><primary>Organ settings.Enclosures</primary></indexterm>
+      <figure>
+	<title>Organ Settings dialog, Enclosures tab</title>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata scalefit="1" width="100%" fileref="images/organ_settings_enclosures.png"/>
+	  </imageobject>
+	</mediaobject>
+      </figure>
+      <para>
+	In its left box, this dialog displays all enclosures in the three: both
+	found in the definition file or added internally by GrandOrgue. They are
+	grouped by windchest. Now only the enclosures added internally are
+	allowed to change.
+      </para>
+      <simpara>
+	Select the element you wish to customize. The right controls are
+	populated with values picked from the organ definition file or the
+	current preset number if the latter was saved.
+      </simpara>
+      <simpara>
+	It is possible to select multiple elements at once, to e.g. update one
+	setting of multiple elements to the same value in a single operation.
+      </simpara>
+      <sect2>
+	<title>Affected windchests</title>
+	<para>
+	  The list of windchest the enclosure affects.
+	</para>
+	<para>
+	  The same enclosure appears under all the the windchests in tree.
+	</para>
+      </sect2>
+      <sect2>
+	<title>Minimum amplitude level</title>
+	<para>
+	  Linear sound amplitude scale factor when the enclosure is closed. The
+	  allowed range is {0, +10}.
+	</para>
+	<para>
+	  0 means full silence. 100 means the enclosure does not affect the
+	  windchests volume at all.
+	</para>
+      </sect2>
+    </sect1>
     <sect1>
       <title>Buttons row</title>
       <para>These buttons are used to drive the dialog and always act on the selected element.</para>