part_system_create_layer


La description

Cette fonction va créer un nouveau système de particules sur une couche donnée. Vous donnez l'ID de couche unique renvoyé par la fonction layer_create() ou le nom de la couche à utiliser comme chaîne - par exemple "instance_layer" - et ensuite marquer le système comme étant persistant ou non. Si le système est marqué comme persistant, il sera conservé dans toutes les pièces après sa création (et assigné une couche gérée si la couche initiale n'existe pas dans les pièces suivantes), mais si la persistance n'est pas signalée, le système sera automatiquement détruit à la fin de la pièce où il a été créé (c'est la même chose que si vous aviez appelé la fonction part_system_destroy et détruira également tous les émetteurs associés au système). La fonction renverra une valeur d'ID unique pour le système de particules qui doit être utilisé dans tous les autres appels de fonction où vous devez fournir un ID système.

IMPORTANT! Si vous marquez le système de particules comme persistant, alors il (et tous les émetteurs qui lui sont assignés) devront être nettoyés manuellement en utilisant les fonctions de destruction appropriées lorsqu'il n'est pas utilisé, sinon vous risquez une fuite de mémoire qui aura un impact négatif sur votre partie finale.


Syntaxe:

part_system_create_layer(layer_id, persistent);

Argument La description
layer La valeur de l'ID de couche ou la chaîne à laquelle affecter le système de particules (peut être n'importe quel type de couche)
persistent Marquer le système de particules comme persistant (réglé sur true ) ou non (réglé sur false )


Résultats:

Real (unique particle system ID value)


Exemple:

global.p_sys = part_system_create_layer("effects_layer", true);

Le code ci-dessus va créer un nouveau système de particules sur le calque donné et le signaler comme persistant sur les pièces suivantes. L'ID du système de particules est stocké dans une variable d'étendue globale pour référence future.