Set

The Set object is an object that displays one of multiple states. A typical use case for this type is a character where each state is a different expression. By setting a transition you can get a nice fading effect when transitioning between states.

Fig: Different states of a Set object

---

Usage

Example use cases:

• Characters.
• Images with multiple visual states.

---

Caveats

When a set is given a non-white color, non-normal blending or has a less than 100% opacity, the content of the Set needs to be rendered onto an internal texture (see Canvas). This state of rendering comes with a slight performance cost as well as minor visual discrepances.

---

Related articles

• NoveltyML reference for <Set>
• Scripting reference for Set

---

Sample NoveltyML

<Set name="My set">
	<State name="Happy">
		<Image texture="Happy face" />
	</State>
	<State name="Sad">
		<Image texture="Sad face" />
	</State>
</Set>