FLgetsnap

FLgetsnap — Retrouve un instantané FLTK antérieurement enregistré.

Description

Retrouve un instantané FLTK antérieurement enregistré (en mémoire), c'est-à-dire fixe tous les valuateurs aux valeurs correspondantes enregistrées dans l'instantané.

Syntaxe

inumsnap FLgetsnap index [, igroup]

Initialisation

inumsnap -- nombre courant d'instantanés.

index -- un nombre faisant référence de manière univoque à un instantané. Plusieurs instantanés peuvent être enregistrés dans la même banque.

igroup -- (facultatif) un nombre entier faisant référence à un groupe de widgets en relation avec un instantané. Cela permet de lire/écrire, ou charger/sauvegarder l'état d'un sous-ensemble de valuateurs. La valeur par défaut est zéro qui fait référence au premier groupe. Le numéro de groupe est déterminé par l'opcode FLsetSnapGroup.

[Note] Note

Le paramètre igroup n'a pas encore été complètement implémenté dans la version actuelle de Csound. Prière de ne pas s'y fier.

Exécution

FLgetsnap retrouve un instantané FLTK antérieurement enregistré (en mémoire), c'est-à-dire fixe tous les valuateurs aux valeurs correspondantes enregistrées dans l'instantané. L'argument index doit faire référence de manière univoque à un instantané existant. Si l'argument index fait référence à un instantané vide ou à un instantané qui n'existe pas, rien ne se produit. FLsetsnap retourne le nombre courant d'instantanés (argument inumsnap).

Pour économiser la mémoire, les widgets peuvent être groupés afin que les instantanés n'affectent qu'un groupe défini de widgets. L'opcode FLsetSnapGroup est utilisé pour spécifier le groupe de tous les widgets déclarés après lui jusqu'à la prochaine instruction FLsetSnapGroup.

Voir aussi

FLloadsnap, FLrun, FLsavesnap, FLsetsnap, FLsetSnapGroup, FLupdate

Crédits

Auteur : Gabriel Maldonado

Nouveau dans la version 4.22