Chapter 5 · The TnpixPreset Interface

5.1Functions

Function Returns What it does

folder() string The presets folder: the one chosen on the Presets rollout, remembered on this computer, or Documents\TenPix Cloth\Material Presets.

setFolder path boolean Chooses the presets folder and remembers it.

names material string The presets in the folder that belong to this kind of material, one name per line.

save material path boolean Saves every dial of the material, with its tick, to the file.

load material path integer Loads a preset: every dial returns to its default and then takes the preset's value. Returns how many values were applied, or −1 if refused. Undoable.

text material string The material's current values in preset form.

recycle path boolean Moves a preset file to the Windows Recycle Bin.

why() string What the last save, load, setFolder or recycle did, or why it was refused. After a load it reads applied N missing M unknown K bad B.

Function	Returns	What it does
`folder()`	string	The presets folder: the one chosen on the Presets rollout, remembered on this computer, or `Documents\TenPix Cloth\Material Presets`.
`setFolder path`	boolean	Chooses the presets folder and remembers it.
`names material`	string	The presets in the folder that belong to this kind of material, one name per line.
`save material path`	boolean	Saves every dial of the material, with its tick, to the file.
`load material path`	integer	Loads a preset: every dial returns to its default and then takes the preset's value. Returns how many values were applied, or −1 if refused. Undoable.
`text material`	string	The material's current values in preset form.
`recycle path`	boolean	Moves a preset file to the Windows Recycle Bin.
`why()`	string	What the last `save`, `load`, `setFolder` or `recycle` did, or why it was refused. After a load it reads applied N missing M unknown K bad B.