Bitweise Flags

Bitweise Flags sind Mengen von Variablen, üblicherweise 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 tun dies schnell und effizient, weil sie auf der Bit-Ebene arbeiten. Verwandte Flags in derselben Gruppe erhalten in der Regel komplementäre Werte, die verschiedene Bit-Positionen in einem einzelnen Wert (z. B. Hexadezimal) darstellen, sodass mehrere Flageinstellungen durch einen einzigen Wert dargestellt werden können.

Zum Beispiel wird im WebGPU API ein GPUBuffer-Objektinstanz mithilfe der GPUDevice.createBuffer()-Methode erstellt. Wenn Sie diese Methode aufrufen, definieren Sie eine usage-Eigenschaft im Descriptor, die ein oder mehrere Flags enthält, die verschiedene erlaubte Nutzungen dieses Buffers ermöglichen.

const descriptor = {
  usage: GPUBufferUsage.COPY_SRC | GPUBufferUsage.MAP_WRITE,
};

Diese Werte werden innerhalb desselben Namensraums definiert, und jeder hat einen Hexadezimalwert:

Wenn Sie die GPUBuffer.usage-Eigenschaft abfragen, erhalten Sie eine einzelne Dezimalzahl zurück, die die Summe der verschiedenen Dezimalwerte für die unterschiedlichen Nutzungs-Flags darstellt. Im obigen Beispiel würde das Abfragen von GPUBuffer.usage für den GPUBuffer, der mit der zuvor angegebenen Nutzung erstellt wurde, Folgendes zurückgeben:

• Dezimaläquivalent von GPUBufferUsage.COPY_SRC, 4
• Hinzufügen von GPUBufferUsage.MAP_WRITE's Dezimaläquivalent, 2
• Ergibt 6.

Aufgrund der gewählten Werte für die verschiedenen Flags ist jede Kombination von Werten eindeutig, so dass 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 gesetzt sind, indem Sie den bitweisen Und-Operator verwenden:

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