atomic_and

Live Demo Pending

This intrinsic does not yet have a self-contained interactive preview. Compute-only and external-resource intrinsics need a different demo path than the current fragment and 3D showcases.

The atomic_and function atomically performs a bitwise AND between the current value and the input, storing the result. Returns the original value.

Signature

bwsl

atomic_and(dest, value)

Parameters

Parameter	Description
`dest`	Integer lvalue to modify atomically
`value`	Integer value to AND with

Return Value

Returns the original value at dest before the operation.

Example

bwsl

pipeline FlagClearing {
  pass "Main" {
    compute "Main" [64, 1, 1] {
    // Clear specific bit flag atomically
    int mask = ~(1 << bitPosition);  // All bits except the one to clear
    atomic_and(flags[index], mask);
    }
  }
}

Common Use Cases

Clear Bits

bwsl

// Clear specific flags
int clearMask = ~(FLAG_A | FLAG_B);
atomic_and(stateFlags, clearMask);

Mask Operations

bwsl

// Apply visibility mask
atomic_and(visibilityMask[tileId], objectMask);

Lock Bits

bwsl

// Clear lock bit
int unlockMask = ~LOCK_BIT;
atomic_and(lockState, unlockMask);

Accumulate Intersections

bwsl

// AND together intersection masks
atomic_and(intersectionMask, thisObjectMask);

Common Flags

bwsl

// Find flags common to all objects
atomic_and(commonFlags, objectFlags);
// After all threads: commonFlags has only bits set in ALL objects

Clear vs Set

Use atomic_and with inverted mask to clear bits. Use atomic_or to set bits.

Initialization

When accumulating with AND, initialize to all 1s (-1 or 0xFFFFFFFF) so the first AND doesn't clear everything.

Compiled Output

When compiled to GLSL:

glsl

atomicAnd(dest, value)

When compiled to HLSL:

hlsl

InterlockedAnd(dest, value, originalValue)

When compiled to SPIR-V:

Uses OpAtomicAnd instruction.

Test atomic_and in a live shader

Signature

Parameters

Return Value

Example

Common Use Cases

Clear Bits

Mask Operations

Lock Bits

Accumulate Intersections

Common Flags

Compiled Output

See Also