// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project // SPDX-License-Identifier: GPL-3.0-or-later // SPDX-FileCopyrightText: Copyright 2021 yuzu Emulator Project // SPDX-License-Identifier: GPL-2.0-or-later #include "shader_recompiler/backend/spirv/emit_spirv_instructions.h" #include "shader_recompiler/backend/spirv/spirv_emit_context.h" namespace Shader::Backend::SPIRV { namespace { Id SubgroupScope(EmitContext& ctx) { return ctx.Const(static_cast(spv::Scope::Subgroup)); } bool StageSupportsSubgroups(EmitContext& ctx) { return ctx.profile.SupportsSubgroupStage(ctx.stage); } Id GetThreadId(EmitContext& ctx) { if (!StageSupportsSubgroups(ctx)) { return ctx.u32_zero_value; } return ctx.OpLoad(ctx.U32[1], ctx.subgroup_local_invocation_id); } Id WarpExtract(EmitContext& ctx, Id value) { const Id thread_id{GetThreadId(ctx)}; const Id local_index{ctx.OpShiftRightArithmetic(ctx.U32[1], thread_id, ctx.Const(5U))}; if (ctx.profile.has_broken_spirv_subgroup_mask_vector_extract_dynamic) { const Id c0_sel{ctx.OpSelect(ctx.U32[1], ctx.OpIEqual(ctx.U1, local_index, ctx.Const(0U)), ctx.OpCompositeExtract(ctx.U32[1], value, 0U), ctx.Const(0U))}; const Id c1_sel{ctx.OpSelect(ctx.U32[1], ctx.OpIEqual(ctx.U1, local_index, ctx.Const(1U)), ctx.OpCompositeExtract(ctx.U32[1], value, 1U), ctx.Const(0U))}; const Id c2_sel{ctx.OpSelect(ctx.U32[1], ctx.OpIEqual(ctx.U1, local_index, ctx.Const(2U)), ctx.OpCompositeExtract(ctx.U32[1], value, 2U), ctx.Const(0U))}; const Id c3_sel{ctx.OpSelect(ctx.U32[1], ctx.OpIEqual(ctx.U1, local_index, ctx.Const(3U)), ctx.OpCompositeExtract(ctx.U32[1], value, 3U), ctx.Const(0U))}; const Id c0_or_c1{ctx.OpBitwiseOr(ctx.U32[1], c0_sel, c1_sel)}; const Id c2_or_c3{ctx.OpBitwiseOr(ctx.U32[1], c2_sel, c3_sel)}; const Id c0_or_c1_or_c2_or_c3{ctx.OpBitwiseOr(ctx.U32[1], c0_or_c1, c2_or_c3)}; return c0_or_c1_or_c2_or_c3; } else { return ctx.OpVectorExtractDynamic(ctx.U32[1], value, local_index); } } Id LoadMask(EmitContext& ctx, Id mask) { const Id value{ctx.OpLoad(ctx.U32[4], mask)}; if (!ctx.profile.warp_size_potentially_larger_than_guest) { return ctx.OpCompositeExtract(ctx.U32[1], value, 0U); } return WarpExtract(ctx, value); } void SetInBoundsFlag(IR::Inst* inst, Id result) { IR::Inst* const in_bounds{inst->GetAssociatedPseudoOperation(IR::Opcode::GetInBoundsFromOp)}; if (!in_bounds) { return; } in_bounds->SetDefinition(result); in_bounds->Invalidate(); } Id ComputeMinThreadId(EmitContext& ctx, Id thread_id, Id segmentation_mask) { return ctx.OpBitwiseAnd(ctx.U32[1], thread_id, segmentation_mask); } Id ComputeMaxThreadId(EmitContext& ctx, Id min_thread_id, Id clamp, Id not_seg_mask) { return ctx.OpBitwiseOr(ctx.U32[1], min_thread_id, ctx.OpBitwiseAnd(ctx.U32[1], clamp, not_seg_mask)); } Id GetMaxThreadId(EmitContext& ctx, Id thread_id, Id clamp, Id segmentation_mask) { const Id not_seg_mask{ctx.OpNot(ctx.U32[1], segmentation_mask)}; const Id min_thread_id{ComputeMinThreadId(ctx, thread_id, segmentation_mask)}; return ComputeMaxThreadId(ctx, min_thread_id, clamp, not_seg_mask); } Id HostThreadId(EmitContext& ctx, Id thread_id) { if (!ctx.profile.warp_size_potentially_larger_than_guest) { return thread_id; } const Id partition_idx{ctx.OpShiftRightLogical(ctx.U32[1], GetThreadId(ctx), ctx.Const(5u))}; const Id partition_base{ctx.OpShiftLeftLogical(ctx.U32[1], partition_idx, ctx.Const(5u))}; return ctx.OpIAdd(ctx.U32[1], thread_id, partition_base); } Id GuestLane(EmitContext& ctx, Id index) { return ctx.OpBitwiseAnd(ctx.U32[1], index, ctx.Const(31U)); } Id ShuffleAbsolute(EmitContext& ctx, Id value, Id src_thread_id) { if (!ctx.profile.has_broken_spirv_subgroup_shuffle) { return ctx.OpGroupNonUniformShuffle(ctx.U32[1], SubgroupScope(ctx), value, src_thread_id); } Id result{ctx.u32_zero_value}; for (u32 lane = 0; lane < ctx.profile.max_subgroup_size; ++lane) { const Id read{ ctx.OpGroupNonUniformBroadcast(ctx.U32[1], SubgroupScope(ctx), value, ctx.Const(lane))}; const Id matches{ctx.OpIEqual(ctx.U1, src_thread_id, ctx.Const(lane))}; result = ctx.OpSelect(ctx.U32[1], matches, read, result); } return result; } Id ShuffleRelative(EmitContext& ctx, Id value, Id delta, Id src_thread_id, spv::Op op) { if (!ctx.profile.support_shuffle_relative) { return ShuffleAbsolute(ctx, value, HostThreadId(ctx, src_thread_id)); } const Id result{ctx.OpGroupNonUniformShuffleXor(ctx.U32[1], SubgroupScope(ctx), value, delta)}; ctx.opcode_rewrites.emplace_back(result.value, op); return result; } Id BroadcastLane(EmitContext& ctx, Id value, u32 lane) { Id result{ ctx.OpGroupNonUniformBroadcast(ctx.U32[1], SubgroupScope(ctx), value, ctx.Const(lane))}; if (!ctx.profile.warp_size_potentially_larger_than_guest) { return result; } const Id partition_idx{ctx.OpShiftRightLogical(ctx.U32[1], GetThreadId(ctx), ctx.Const(5u))}; for (u32 base = 32; base < ctx.profile.max_subgroup_size; base += 32) { const Id read{ctx.OpGroupNonUniformBroadcast(ctx.U32[1], SubgroupScope(ctx), value, ctx.Const(base + lane))}; const Id matches{ctx.OpIEqual(ctx.U1, partition_idx, ctx.Const(base >> 5))}; result = ctx.OpSelect(ctx.U32[1], matches, read, result); } return result; } } // Anonymous namespace Id EmitLaneId(EmitContext& ctx) { const Id id{GetThreadId(ctx)}; if (!ctx.profile.warp_size_potentially_larger_than_guest) { return id; } return ctx.OpBitwiseAnd(ctx.U32[1], id, ctx.Const(31U)); } Id EmitVoteAll(EmitContext& ctx, Id pred) { if (!StageSupportsSubgroups(ctx)) { return pred; } if (!ctx.profile.warp_size_potentially_larger_than_guest) { return ctx.OpGroupNonUniformAll(ctx.U1, SubgroupScope(ctx), pred); } const Id mask_ballot{ ctx.OpGroupNonUniformBallot(ctx.U32[4], SubgroupScope(ctx), ctx.true_value)}; const Id active_mask{WarpExtract(ctx, mask_ballot)}; const Id ballot{ WarpExtract(ctx, ctx.OpGroupNonUniformBallot(ctx.U32[4], SubgroupScope(ctx), pred))}; const Id lhs{ctx.OpBitwiseAnd(ctx.U32[1], ballot, active_mask)}; return ctx.OpIEqual(ctx.U1, lhs, active_mask); } Id EmitVoteAny(EmitContext& ctx, Id pred) { if (!StageSupportsSubgroups(ctx)) { return pred; } if (!ctx.profile.warp_size_potentially_larger_than_guest) { return ctx.OpGroupNonUniformAny(ctx.U1, SubgroupScope(ctx), pred); } const Id mask_ballot{ ctx.OpGroupNonUniformBallot(ctx.U32[4], SubgroupScope(ctx), ctx.true_value)}; const Id active_mask{WarpExtract(ctx, mask_ballot)}; const Id ballot{ WarpExtract(ctx, ctx.OpGroupNonUniformBallot(ctx.U32[4], SubgroupScope(ctx), pred))}; const Id lhs{ctx.OpBitwiseAnd(ctx.U32[1], ballot, active_mask)}; return ctx.OpINotEqual(ctx.U1, lhs, ctx.u32_zero_value); } Id EmitVoteEqual(EmitContext& ctx, Id pred) { if (!StageSupportsSubgroups(ctx)) { return ctx.true_value; } if (!ctx.profile.warp_size_potentially_larger_than_guest) { return ctx.OpGroupNonUniformAllEqual(ctx.U1, SubgroupScope(ctx), pred); } const Id mask_ballot{ ctx.OpGroupNonUniformBallot(ctx.U32[4], SubgroupScope(ctx), ctx.true_value)}; const Id active_mask{WarpExtract(ctx, mask_ballot)}; const Id ballot{ WarpExtract(ctx, ctx.OpGroupNonUniformBallot(ctx.U32[4], SubgroupScope(ctx), pred))}; const Id lhs{ctx.OpBitwiseXor(ctx.U32[1], ballot, active_mask)}; return ctx.OpLogicalOr(ctx.U1, ctx.OpIEqual(ctx.U1, lhs, ctx.u32_zero_value), ctx.OpIEqual(ctx.U1, lhs, active_mask)); } Id EmitSubgroupBallot(EmitContext& ctx, Id pred) { if (!StageSupportsSubgroups(ctx)) { return ctx.OpSelect(ctx.U32[1], pred, ctx.Const(1u), ctx.u32_zero_value); } const Id ballot{ctx.OpGroupNonUniformBallot(ctx.U32[4], SubgroupScope(ctx), pred)}; if (!ctx.profile.warp_size_potentially_larger_than_guest) { return ctx.OpCompositeExtract(ctx.U32[1], ballot, 0U); } return WarpExtract(ctx, ballot); } Id EmitSubgroupEqMask(EmitContext& ctx) { if (!StageSupportsSubgroups(ctx)) { return ctx.Const(1u); } return LoadMask(ctx, ctx.subgroup_mask_eq); } Id EmitSubgroupLtMask(EmitContext& ctx) { if (!StageSupportsSubgroups(ctx)) { return ctx.u32_zero_value; } return LoadMask(ctx, ctx.subgroup_mask_lt); } Id EmitSubgroupLeMask(EmitContext& ctx) { if (!StageSupportsSubgroups(ctx)) { return ctx.Const(1u); } return LoadMask(ctx, ctx.subgroup_mask_le); } Id EmitSubgroupGtMask(EmitContext& ctx) { if (!StageSupportsSubgroups(ctx)) { return ctx.u32_zero_value; } return LoadMask(ctx, ctx.subgroup_mask_gt); } Id EmitSubgroupGeMask(EmitContext& ctx) { if (!StageSupportsSubgroups(ctx)) { return ctx.Const(1u); } return LoadMask(ctx, ctx.subgroup_mask_ge); } Id EmitShuffleIndex(EmitContext& ctx, IR::Inst* inst, Id value, Id index, Id clamp, Id segmentation_mask) { const Id not_seg_mask{ctx.OpNot(ctx.U32[1], segmentation_mask)}; const Id thread_id{EmitLaneId(ctx)}; const Id min_thread_id{ComputeMinThreadId(ctx, thread_id, segmentation_mask)}; const Id max_thread_id{ComputeMaxThreadId(ctx, min_thread_id, clamp, not_seg_mask)}; const Id lhs{ctx.OpBitwiseAnd(ctx.U32[1], GuestLane(ctx, index), not_seg_mask)}; const Id src_thread_id{ctx.OpBitwiseOr(ctx.U32[1], lhs, min_thread_id)}; const Id in_range{ctx.OpSLessThanEqual(ctx.U1, src_thread_id, max_thread_id)}; SetInBoundsFlag(inst, in_range); if (!StageSupportsSubgroups(ctx)) { return value; } const IR::Value lane{inst->Arg(1).Resolve()}; const IR::Value segment{inst->Arg(3).Resolve()}; if (lane.IsImmediate() && segment.IsImmediate() && segment.U32() == 0) { return ctx.OpSelect(ctx.U32[1], in_range, BroadcastLane(ctx, value, lane.U32() & 31), value); } const Id shuffled{ShuffleAbsolute(ctx, value, HostThreadId(ctx, src_thread_id))}; return ctx.OpSelect(ctx.U32[1], in_range, shuffled, value); } Id EmitShuffleUp(EmitContext& ctx, IR::Inst* inst, Id value, Id index, Id clamp, Id segmentation_mask) { if (!StageSupportsSubgroups(ctx)) { SetInBoundsFlag(inst, ctx.false_value); return value; } const Id delta{GuestLane(ctx, index)}; const Id thread_id{EmitLaneId(ctx)}; const Id max_thread_id{GetMaxThreadId(ctx, thread_id, clamp, segmentation_mask)}; const Id src_thread_id{ctx.OpISub(ctx.U32[1], thread_id, delta)}; const Id in_range{ctx.OpSGreaterThanEqual(ctx.U1, src_thread_id, max_thread_id)}; SetInBoundsFlag(inst, in_range); const Id shuffled{ShuffleRelative(ctx, value, delta, src_thread_id, spv::Op::OpGroupNonUniformShuffleUp)}; return ctx.OpSelect(ctx.U32[1], in_range, shuffled, value); } Id EmitShuffleDown(EmitContext& ctx, IR::Inst* inst, Id value, Id index, Id clamp, Id segmentation_mask) { if (!StageSupportsSubgroups(ctx)) { SetInBoundsFlag(inst, ctx.false_value); return value; } const Id delta{GuestLane(ctx, index)}; const Id thread_id{EmitLaneId(ctx)}; const Id max_thread_id{GetMaxThreadId(ctx, thread_id, clamp, segmentation_mask)}; const Id src_thread_id{ctx.OpIAdd(ctx.U32[1], thread_id, delta)}; const Id in_range{ctx.OpSLessThanEqual(ctx.U1, src_thread_id, max_thread_id)}; SetInBoundsFlag(inst, in_range); const Id shuffled{ShuffleRelative(ctx, value, delta, src_thread_id, spv::Op::OpGroupNonUniformShuffleDown)}; return ctx.OpSelect(ctx.U32[1], in_range, shuffled, value); } Id EmitShuffleButterfly(EmitContext& ctx, IR::Inst* inst, Id value, Id index, Id clamp, Id segmentation_mask) { if (!StageSupportsSubgroups(ctx)) { SetInBoundsFlag(inst, ctx.false_value); return value; } const Id mask{GuestLane(ctx, index)}; const Id thread_id{EmitLaneId(ctx)}; const Id max_thread_id{GetMaxThreadId(ctx, thread_id, clamp, segmentation_mask)}; const Id src_thread_id{ctx.OpBitwiseXor(ctx.U32[1], thread_id, mask)}; const Id in_range{ctx.OpSLessThanEqual(ctx.U1, src_thread_id, max_thread_id)}; SetInBoundsFlag(inst, in_range); const Id shuffled{ctx.OpGroupNonUniformShuffleXor(ctx.U32[1], SubgroupScope(ctx), value, mask)}; return ctx.OpSelect(ctx.U32[1], in_range, shuffled, value); } Id EmitQuadBroadcast(EmitContext& ctx, Id value, Id lane) { if (ctx.profile.support_quad_shuffles) { return ctx.OpGroupNonUniformQuadBroadcast(ctx.U32[1], SubgroupScope(ctx), value, lane); } const Id base{ctx.OpBitwiseAnd(ctx.U32[1], GetThreadId(ctx), ctx.Const(~3u))}; const Id local_lane{ctx.OpBitwiseAnd(ctx.U32[1], lane, ctx.Const(3u))}; const Id src_thread_id{ctx.OpBitwiseOr(ctx.U32[1], base, local_lane)}; return ShuffleAbsolute(ctx, value, src_thread_id); } Id EmitQuadSwap(EmitContext& ctx, Id value, Id direction) { if (ctx.profile.support_quad_shuffles) { const Id result{ ctx.OpGroupNonUniformQuadBroadcast(ctx.U32[1], SubgroupScope(ctx), value, direction)}; ctx.opcode_rewrites.emplace_back(result.value, spv::Op::OpGroupNonUniformQuadSwap); return result; } const Id xor_mask{ctx.OpIAdd(ctx.U32[1], direction, ctx.Const(1u))}; return ctx.OpGroupNonUniformShuffleXor(ctx.U32[1], SubgroupScope(ctx), value, xor_mask); } Id EmitFSwizzleAdd(EmitContext& ctx, Id op_a, Id op_b, Id swizzle) { const Id three{ctx.Const(3U)}; Id mask{GetThreadId(ctx)}; mask = ctx.OpBitwiseAnd(ctx.U32[1], mask, three); mask = ctx.OpShiftLeftLogical(ctx.U32[1], mask, ctx.Const(1U)); mask = ctx.OpShiftRightLogical(ctx.U32[1], swizzle, mask); mask = ctx.OpBitwiseAnd(ctx.U32[1], mask, three); const Id modifier_a{ctx.OpVectorExtractDynamic(ctx.F32[1], ctx.fswzadd_lut_a, mask)}; const Id modifier_b{ctx.OpVectorExtractDynamic(ctx.F32[1], ctx.fswzadd_lut_b, mask)}; const Id result_a{ctx.OpFMul(ctx.F32[1], op_a, modifier_a)}; const Id result_b{ctx.OpFMul(ctx.F32[1], op_b, modifier_b)}; return ctx.OpFAdd(ctx.F32[1], result_a, result_b); } Id EmitDPdxFine(EmitContext& ctx, Id op_a) { return ctx.OpDPdxFine(ctx.F32[1], op_a); } Id EmitDPdyFine(EmitContext& ctx, Id op_a) { return ctx.OpDPdyFine(ctx.F32[1], op_a); } Id EmitDPdxCoarse(EmitContext& ctx, Id op_a) { return ctx.OpDPdxCoarse(ctx.F32[1], op_a); } Id EmitDPdyCoarse(EmitContext& ctx, Id op_a) { return ctx.OpDPdyCoarse(ctx.F32[1], op_a); } } // namespace Shader::Backend::SPIRV