Marqueurs binaires

Les marqueurs binaires sont un ensemble de variables, généralement des valeurs numériques, qui permettent d'activer ou désactiver des fonctionnalités d'une méthode ou autre. Ces opérations sont rapides, car elles s'appliquent au niveau binaire. Les marqueurs associés sont généralement des valeurs complémentaires, représentés par des bits différents d'une même valeur (généralement un nombre hexadécimal), afin qu'une même valeur numérique permette de combiner et représenter différents marqueurs.

Par exemple, quand on crée un objet GPUBuffer (en-US) avec la méthode GPUDevice.createBuffer() (en-US) de l'API WebGPU (en-US), on fournit une propriété usage dans le descripteur qui contient un ou plusieurs marqueurs pour activer certaines utilisation du tampon.

usage: GPUBufferUsage.COPY_SRC | GPUBufferUsage.MAP_WRITE;

Ces valeurs sont définies dans le même espace de nom et chacune prend une valeur hexadécimale différente :

Quand on consulte la propriété GPUBuffer.usage (en-US) d'un tampon, on obtient un seul nombre qui est la somme des différents marqueurs binaires. Si on récupère GPUBuffer.usage à partir de celui créé dans l'exemple précédent, on obtiendra la valeur décimale 6, car :

• La valeur décimale équivalente de GPUBufferUsage.COPY_SRC vaut 4
• La valeur décimale équivalente de GPUBufferUsage.MAP_WRITE vaut 2
• La somme de 4 et 2 donne 6.

Comme les valeurs de chaque marqueur se situent sur des bits différents de la valeur composite, chaque combinaison fournira une valeur unique. Le programme peut alors déterminer quels marqueurs sont actifs à partir d'une unique valeur. Il est aussi possible de tester les marqueurs présents sur une valeur composite à l'aide des opérateurs binaires :

if (buffer.usage & GPUBufferUsage.MAP_WRITE) {
  // Buffer possède le marqueur MAP_WRITE usage
}