The <tags> element

The <tags> element lives right below your top-level <DecentSampler> element. It allows you to specify details about the tags you use throughout your instrument. It is however not actually necessary to include a <tags> element for every tag you use. You only need to create this if you want to specify additional details about your tags.

The <tag> element

Underneath the <tags> element, you can have any number of <tag> elements. These specify details for each individual tag that you use throughout your sample mapping. Attributes:

Attribute		Description
name	(required)	The name of the tag, as used in the tags attribute of your samples, groups and bindings.
enabled	(optional)	Whether or not this tag is enabled. Possible values: true, false. Default: true
volume	(optional)	A number for 0.0 to 1.0 that specifies the initial volume for a tag. Default: 1.0
polyphony	(optional)	A whole number that specifies the number of voices allowed for this tag. Default: -1 (unlimited). Set to 1 for monophonic behavior.

Example

This example shows a tag configuration with polyphony control:

<tags>
  <tag name="voice1" volume="1" polyphony="12"/>
</tags>

The polyphony attribute can be controlled dynamically using bindings with the TAG_POLYPHONY parameter. This is useful for creating mono/poly switches:

<button x="740" y="130" width="12" height="12" style="image" value="0">
  <state name="Poly" mainImage="Images/Checkbox On.png">
    <binding type="general" level="tag" identifier="voice1" 
             parameter="TAG_POLYPHONY" translation="fixed_value" translationValue="12"/>
  </state>
  <state name="Mono" mainImage="Images/Checkbox Off.png">
    <binding type="general" level="tag" identifier="voice1" 
             parameter="TAG_POLYPHONY" translation="fixed_value" translationValue="1"/>
  </state>
</button>