createValueSet

abstract fun createValueSet(name: String): ValueSetId

Create an empty value set in the scene. A value set holds alternative values for some scene variables. Write them with the target parameter of the setters. The scene saves its sets, and undo reverts their changes. Experimental: this API may change in a minor release.

Return

the id of the new set. The scene saves it, so it stays the same across saves and loads.

Parameters

name

the name of the set. It must be unique among the sets of the scene, must not be empty, and must not start or end with whitespace.