Set Alpha Coefficient: ByName

Nécessite un shader compatible DX9.

ASTER::ACTION::ObjectControl::Set Alpha Coefficient; ByName

Modifier le coefficient alpha de rendu des instances pour les groupes de mouvements enregistrés dans le contrôleur.

Le mode graphique de l'application est réglé sur 16 millions de couleurs (couleur 24 bits).

Le coefficient alpha (également appelé canal alpha) est une valeur qui contrôle la transparence d’une image. Dans DirectX, le canal alpha est généralement représenté par 8 bits et peut avoir 256 niveaux de transparence de 0 (complètement transparent) à 255 (complètement opaque).

• 0 est complètement transparent

• 255 est complètement opaque

Le coefficient alpha d’une instance est un paramètre qui définit la transparence d’une instance spécifique lorsqu’elle est rendue. Il contrôle comment elle se superpose avec d’autres objets ou l’arrière-plan.

Comparaison avec la fonctionnalité standard CF25

Cette fonction est presque équivalente à la “Commande de changement de valeur du coefficient alpha” qui est également implémentée dans la fonctionnalité standard CF25. Elle est faite pour correspondre aux spécifications uniques de CF25, donc 0 est “complètement opaque” et 255 est “complètement transparent.”

Cette commande est implémentée pour prendre en charge les “modifications en vrac des valeurs” pour les instances cibles utilisant les noms de groupes de mouvements enregistrés avec le contrôleur de mouvement ASTER.

Cette commande change uniquement la valeur du coefficient alpha (transparence) sans changer les valeurs RVB.

En lien avec JSON, il est également possible de changer le coefficient alpha, y compris les valeurs RVB. Pour plus de détails, reportez-vous à la commande séparée.

Parameter.1

Spécification du nom du groupe de mouvement.

S'il existe deux groupes de mouvements ou plus enregistrés, vous pouvez définir le paramètre pour le groupe correspondant en spécifiant le nom du groupe.

Si vous envoyez une chaîne vide sans spécifier le nom du groupe, tous les groupes de mouvements actuellement enregistrés seront ciblés.

Parameter.2

Entrez une valeur de 0 à 255. Notez que 0 est complètement opaque, ce qui est à l’opposé des spécifications et descriptions générales.

Attention: Sur la conversion des types de nombres

Les valeurs envoyées à ASTER sont converties en un type entier non signé appelé size_t pour des raisons de sécurité.

Lorsqu’une valeur négative est entrée, elle est convertie de manière à ce que la valeur négative soit traitée comme un entier positif sous la forme du complément à deux.

Concrètement, si -1 est entré pour le paramètre.2, la valeur est convertie en 4'294'967'295 (0xFFFFFFFF), ce qui est la valeur maximale d’un entier non signé.

Si -2 est entré, cela devient 4'294'967'294 (0xFFFFFFFE).

Ensuite, puisque la valeur maximale est limitée à 255, les valeurs -1 et -2 deviennent finalement 255 pour le paramètre.2.