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
`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" pan="0" 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>