FLsetSnapGroup

FLsetSnapGroup — Determines the snapshot group for FL valuators.

Description

FLsetSnapGroup determines the snapshot group of valuators declared after it.

Syntax

FLsetSnapGroup igroup

Initialization

igroup -- (optional) an integer number referring to a snapshot-related group of widget. It allows to get/set, or to load/save the state of a subset of valuators.

[Note] Note

The igroup parameter has not been yet fully implemented in the current version of csound. Please do not rely on it yet.

Performance

For purposes of snapshot saving, widgets can be grouped, so that snapshots affect only a defined group of widgets. The opcode FLsetSnapGroup is used to specify the group for all widgets declared after it, until the next FLsetSnapGroup statement.

FLsetSnapGroup determines the snapshot group of a declared valuator. To make a valuator belong to a stated group, you have to place FLsetSnapGroup just before the declaration of the widget itself. The group stated by FLsetSnapGroup lasts for all valuators declared after it, until a new FLsetSnapGroup statement with a different group is encountered. If no FLsetSnapGroup statement are present in an orchestra, the default group for all widgets will be group zero.

See Also

FLgetsnap, FLsetsnap, FLloadsnap, FLsavesnap

Credits

Author: Gabriel Maldonado

New in version 4.22