Bitweise Flags

Bitweise Flags sind Mengen von Variablen, in der Regel einfache Zahlenwerte, die verwendet werden können, um bestimmte Verwendungen oder Funktionen einer Methode oder einer anderen Code-Struktur ein- oder auszuschalten. Sie können dies schnell und effizient tun, da sie auf Bit-Ebene operieren. Verwandte Flags in derselben Gruppe werden im Allgemeinen mit komplementären Werten versehen, die unterschiedliche Bitpositionen in einem einzelnen Wert (z.B. hexadezimal) repräsentieren, sodass mehrere Flag-Einstellungen durch einen einzigen Wert dargestellt werden können.

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

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

Diese Werte werden im selben Namespace definiert, und jeder hat einen hexadezimalen Wert:

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 darstellt. Zurückkehrend zu dem obigen Beispiel, würde das Abfragen von GPUBuffer.usage für den GPUBuffer, der mit der zuvor spezifizierten Nutzung erstellt wurde, 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 aus einem einzigen Wert gesetzt sind. Darüber hinaus können Sie einfach 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
}