Bitwise flags

Bitweise Flags sind Sätze von Variablen, meist einfache Zahlenwerte, die verwendet werden können, um bestimmte Nutzungen oder Funktionen einer Methode oder einer anderen Code-Struktur zu aktivieren oder zu deaktivieren. Sie können dies schnell und effizient tun, weil sie auf Bit-Ebene arbeiten. Verwandte Flags in derselben Gruppe werden im Allgemeinen komplementäre Werte zugewiesen, die unterschiedliche Bit-Positionen in einem einzigen Wert (z.B. hexadezimal) darstellen, sodass mehrere Flag-Einstellungen durch einen einzigen Wert dargestellt werden können.

Zum Beispiel wird im WebGPU API ein GPUBuffer-Objektinstanz mit der Methode GPUDevice.createBuffer() erstellt. Beim Aufruf dieser Methode definieren Sie eine usage-Eigenschaft im Deskriptor, die ein oder mehrere Flags enthält, die unterschiedliche erlaubte Nutzungen dieses Buffers aktivieren.

usage: GPUBufferUsage.COPY_SRC | GPUBufferUsage.MAP_WRITE;

Diese Werte sind innerhalb desselben Namespace definiert und jeder hat einen hexadezimalen Wert:

Wenn Sie die GPUBuffer.usage-Eigenschaft abfragen, erhalten Sie eine einzelne dezimale Zahl, die die Summe der verschiedenen dezimalen Werte für die verschiedenen Nutzungs-Flags ist. Bei Rückkehr zum obigen Beispiel würde die Abfrage von GPUBuffer.usage für den GPUBuffer, der mit dem zuvor spezifizierten usage erstellt wurde, Folgendes zurückgeben:

• Dezimales Äquivalent von GPUBufferUsage.COPY_SRC, 4
• Hinzufügen des dezimalen Äquivalents von GPUBufferUsage.MAP_WRITE, 2
• Ergibt 6.

Aufgrund der gewählten Werte für die unterschiedlichen Flags ist jede Kombination von Werten einzigartig, sodass das Programm auf einen Blick erkennen kann, welche Flags aus einem einzigen Wert gesetzt sind. Darüber hinaus können Sie leicht testen, welche Flags im kombinierten Wert mit dem Bitweisen Und-Operator gesetzt sind:

if (buffer.usage & GPUBufferUsage.MAP_WRITE) {
  // Buffer has MAP_WRITE usage
}