Bitweise Flags

Bitweise Flags sind Mengen von Variablen, normalerweise einfache Zahlenwerte, die verwendet werden können, um spezifische Nutzungen oder Funktionen einer Methode oder einer anderen Code-Struktur zu aktivieren oder zu deaktivieren. Sie können dies schnell und effizient tun, da sie auf der Bit-Ebene arbeiten. Verwandte Flags in derselben Gruppe bekommen in der Regel komplementäre Werte, die verschiedene Bit-Positionen in einem einzelnen Wert (z. B. Hexadezimal) repräsentieren, sodass mehrere Flag-Einstellungen durch einen einzigen Wert dargestellt werden können.

Zum Beispiel wird im WebGPU API eine GPUBuffer-Objektinstanz mit der Methode GPUDevice.createBuffer() erstellt. Wenn Sie diese Methode aufrufen, definieren Sie eine usage-Eigenschaft im Deskriptor, die ein oder mehrere Flags enthält, die verschiedene erlaubte Nutzungen dieses Puffers aktivieren.

js
usage: GPUBufferUsage.COPY_SRC | GPUBufferUsage.MAP_WRITE;

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

Nutzungs-Flag Hexadezimale Darstellung Dezimaläquivalent
GPUBufferUsage.MAP_READ 0x0001 1
GPUBufferUsage.MAP_WRITE 0x0002 2
GPUBufferUsage.COPY_SRC 0x0004 4
GPUBufferUsage.COPY_DST 0x0008 8
GPUBufferUsage.INDEX 0x0010 16
GPUBufferUsage.VERTEX 0x0020 32
GPUBufferUsage.UNIFORM 0x0040 64
GPUBufferUsage.STORAGE 0x0080 128
GPUBufferUsage.INDIRECT 0x0100 256
GPUBufferUsage.QUERY_RESOLVE 0x0200 512

Wenn Sie die Eigenschaft GPUBuffer.usage abfragen, erhalten Sie eine einzelne Dezimalzahl zurück, die die Summe der verschiedenen Dezimalwerte für die verschiedenen Nutzungs-Flags ist. Um auf das obenstehende Beispiel zurückzukommen, würde die Abfrage von GPUBuffer.usage für den GPUBuffer, erstellt mit der vorher angegebenen Nutzung, Folgendes zurückgeben:

  • Dezimaläquivalent von GPUBufferUsage.COPY_SRC, 4
  • Addiere das Dezimaläquivalent von GPUBufferUsage.MAP_WRITE, 2
  • Ergibt 6.

Aufgrund der gewählten Werte für die verschiedenen Flags ist jede Kombination von Werten einzigartig, sodass das Programm auf einen Blick erkennen kann, welche Flags von einem einzelnen Wert gesetzt sind. Zusätzlich können Sie einfach testen, welche Flags im kombinierten Wert gesetzt sind, indem Sie den bitweisen AND-Operator verwenden:

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

Siehe auch