#include "graphics/shader/recompiler/ir/passes/ResourceMaterialization.h" #include "graphics/guest_gpu/gpu_format.h" #include "graphics/shader/recompiler/ir/ValueProgram.h" #include "graphics/shader/shaderBindings.h" #include #include #include namespace Libs::Graphics::ShaderRecompiler::IR { namespace { constexpr uint64_t AddressMask = 0x0000ffffffffffffull; Decoder::ImageDimension DescriptorDimension(const DescriptorValue& descriptor, Decoder::ImageDimension requested) { const bool is_array = requested == Decoder::ImageDimension::Dim1DArray || requested == Decoder::ImageDimension::Dim2DArray || requested == Decoder::ImageDimension::Dim2DMsaaArray; switch (static_cast((descriptor.dwords[3] >> 28u) & 0xfu)) { case Prospero::ImageType::kColor1D: return Decoder::ImageDimension::Dim1D; case Prospero::ImageType::kColor1DArray: if (is_array) { return Decoder::ImageDimension::Dim1DArray; } return Decoder::ImageDimension::Dim1D; case Prospero::ImageType::kColor3D: return Decoder::ImageDimension::Dim3D; case Prospero::ImageType::kCube: return Decoder::ImageDimension::Dim2DArray; case Prospero::ImageType::kColor2DArray: if (is_array) { return Decoder::ImageDimension::Dim2DArray; } return Decoder::ImageDimension::Dim2D; case Prospero::ImageType::kColor2DMsaaArray: if (is_array) { return Decoder::ImageDimension::Dim2DMsaaArray; } return Decoder::ImageDimension::Dim2DMsaa; case Prospero::ImageType::kColor2D: return Decoder::ImageDimension::Dim2D; case Prospero::ImageType::kColor2DMsaa: return Decoder::ImageDimension::Dim2DMsaa; default: return Decoder::ImageDimension::Unknown; } } bool NullImageDescriptor(const DescriptorValue& descriptor) { return descriptor.dwords[0] == 0 && (descriptor.dwords[1] & 0xffu) == 0; } bool ValidImageDescriptor(const DescriptorValue& descriptor) { const auto type = static_cast((descriptor.dwords[3] >> 28u) & 0xfu); const auto format = static_cast((descriptor.dwords[1] >> 20u) & 0x1ffu); if (type < Prospero::ImageType::kColor1D || format == Prospero::BufferFormat::kInvalid) { return false; } if (type == Prospero::ImageType::kColor2DMsaa || type == Prospero::ImageType::kColor2DMsaaArray) { const auto base_level = (descriptor.dwords[3] >> 12u) & 0xfu; const auto fragments = (descriptor.dwords[3] >> 16u) & 0xfu; const auto max_mip = (descriptor.dwords[5] >> 4u) & 0xfu; return base_level == 0 && fragments >= 1 && fragments <= 3 && max_mip == fragments; } return true; } uint32_t DescriptorImageSwizzle(const DescriptorValue& descriptor) { return descriptor.dwords[3] & 0xfffu; } bool DescriptorIsCube(const DescriptorValue& descriptor) { return static_cast((descriptor.dwords[3] >> 28u) & 0xfu) == Prospero::ImageType::kCube; } uint32_t StorageMipCount(const ImageResource& image, const DescriptorValue& descriptor) { if (image.mip_mode != ImageMipMode::DynamicStorage || NullImageDescriptor(descriptor)) { return 1; } const auto base = (descriptor.dwords[3] >> 12u) & 0xfu; const auto last = (descriptor.dwords[3] >> 16u) & 0xfu; return base <= last ? last - base + 1u : 0u; } bool DecodeBufferDescriptor(const DescriptorValue& descriptor, ShaderBufferResource& result) { if (descriptor.dword_count != std::size(result.fields)) { return false; } std::copy_n(descriptor.dwords.begin(), std::size(result.fields), result.fields); return true; } uint64_t AddressSpecialization(const AddressResource& resource, const ResourceSnapshot::Address& snapshot) { return resource.kind == ResourceKind::Flat || resource.unbased ? snapshot.binding_base : snapshot.guest_base - snapshot.binding_base; } bool IsImageOp(ValueOpcode op) { switch (op) { case ValueOpcode::ImageQueryDimensions: case ValueOpcode::ImageQueryLod: case ValueOpcode::ImageRead: case ValueOpcode::ImageWrite: case ValueOpcode::ImageSampleRaw: case ValueOpcode::ImageGatherRaw: case ValueOpcode::ImageAtomicIAdd32: case ValueOpcode::ImageAtomicUMin32: case ValueOpcode::ImageAtomicUMax32: case ValueOpcode::ImageAtomicAnd32: case ValueOpcode::ImageAtomicOr32: case ValueOpcode::ImageAtomicXor32: return true; default: return false; } } } // namespace bool ValidateResourceSnapshot(const Program& program, const ResourceSnapshot& snapshot, std::string* error) { if (!program.resource_tracking_complete) { if (error != nullptr) { *error = "shader resources were not tracked"; } return false; } if (snapshot.buffers.size() != program.info.buffers.size() || snapshot.images.size() != program.info.images.size() || snapshot.samplers.size() != program.info.samplers.size() || snapshot.addresses.size() != program.info.addresses.size()) { if (error != nullptr) { *error = "resource snapshot does not match dense shader topology"; } return false; } if (program.values == nullptr || snapshot.flattened_srt.size() != program.values->srt_reads.size()) { if (error != nullptr) { *error = "flattened SRT snapshot does not match the shader plan"; } return false; } if (program.binding_layout_complete) { for (const auto reg: program.bindings.user_data_registers) { if (reg < program.user_data_base || reg - program.user_data_base >= snapshot.user_data.size()) { if (error != nullptr) { *error = fmt::format("runtime snapshot is missing user SGPR {}", reg); } return false; } } } for (uint32_t i = 0; i < program.info.buffers.size(); i++) { const auto alias = program.info.buffers[i].image_alias; if (alias != BufferResource::NoImageAlias && alias >= program.info.images.size()) { if (error != nullptr) { *error = fmt::format("buffer resource {} has invalid image alias {}", i, alias); } return false; } } const auto CheckWidth = [&](const auto& values, uint32_t width, const char* kind) { for (uint32_t i = 0; i < values.size(); i++) { if (values[i].dword_count != width) { if (error != nullptr) { *error = fmt::format("{} descriptor {} has {} dwords", kind, i, values[i].dword_count); } return false; } } return true; }; for (uint32_t i = 0; i < snapshot.addresses.size(); i++) { if (snapshot.addresses[i].binding_base > snapshot.addresses[i].guest_base) { if (error != nullptr) { *error = fmt::format("address resource {} binds above its guest base", i); } return false; } } return CheckWidth(snapshot.buffers, 4, "buffer") && CheckWidth(snapshot.images, 8, "image") && CheckWidth(snapshot.samplers, 4, "sampler"); } bool ValidateResourceSpecialization(const Program& program, const ResourceSnapshot& snapshot, std::string* error) { if (!ValidateResourceSnapshot(program, snapshot, error)) { return false; } for (uint32_t i = 0; i < program.info.buffers.size(); i++) { const auto& buffer = program.info.buffers[i]; ShaderBufferResource descriptor; if (!DecodeBufferDescriptor(snapshot.buffers[i], descriptor)) { if (error != nullptr) { *error = fmt::format("buffer descriptor {} has invalid width", i); } return false; } if (buffer.packed_stride != descriptor.PackedStride() || buffer.descriptor_format != descriptor.Format() || buffer.descriptor_swizzle != descriptor.DstSelXYZW()) { if (error != nullptr) { *error = fmt::format("buffer descriptor {} no longer matches specialization", i); } return false; } } for (uint32_t i = 0; i < program.info.images.size(); i++) { const auto& image = program.info.images[i]; const auto& descriptor = snapshot.images[i]; const auto mip_count = StorageMipCount(image, descriptor); if (mip_count == 0u || mip_count != image.mip_count) { if (error != nullptr) { *error = fmt::format("storage image descriptor {} changed mip range", i); } return false; } if (NullImageDescriptor(descriptor)) { bool canonical_kind = image.kind == ResourceKind::Image || image.kind == ResourceKind::StorageImage; if (image.atomic) { canonical_kind = image.kind == ResourceKind::StorageImageUint; } if (image.dimension != Decoder::ImageDimension::Dim2D || image.cube || !canonical_kind) { if (error != nullptr) { *error = fmt::format( "image descriptor {} no longer matches canonical null specialization", i); } return false; } continue; } const auto dimension = DescriptorDimension(descriptor, image.dimension); if (dimension == Decoder::ImageDimension::Unknown || dimension != image.dimension || DescriptorIsCube(descriptor) != image.cube) { if (error != nullptr) { *error = fmt::format("image descriptor {} no longer matches specialized dimension: " "{:08x},{:08x},{:08x},{:08x},{:08x},{:08x},{:08x},{:08x}", i, descriptor.dwords[0], descriptor.dwords[1], descriptor.dwords[2], descriptor.dwords[3], descriptor.dwords[4], descriptor.dwords[5], descriptor.dwords[6], descriptor.dwords[7]); } return false; } if (image.kind == ResourceKind::Image || image.kind == ResourceKind::ImageUint || image.kind == ResourceKind::StorageImage || image.kind == ResourceKind::StorageImageUint) { const bool storage = image.kind == ResourceKind::StorageImage || image.kind == ResourceKind::StorageImageUint; if (storage && image.storage_swizzle != DescriptorImageSwizzle(descriptor)) { if (error != nullptr) { *error = fmt::format("storage image descriptor {} changed swizzle", i); } return false; } const auto format = static_cast((descriptor.dwords[1] >> 20u) & 0x1ffu); const bool raw_sint_storage = storage && format == Prospero::BufferFormat::k32SInt && !image.read && !image.atomic; const bool uint_descriptor = Prospero::IsUintTextureFormat(format) || raw_sint_storage; const auto uint_program = image.kind == ResourceKind::ImageUint || image.kind == ResourceKind::StorageImageUint; if (uint_descriptor != uint_program && !(image.atomic && uint_program)) { if (error != nullptr) { *error = fmt::format( "image descriptor {} no longer matches specialized format: " "{:08x},{:08x},{:08x},{:08x},{:08x},{:08x},{:08x},{:08x}", i, descriptor.dwords[0], descriptor.dwords[1], descriptor.dwords[2], descriptor.dwords[3], descriptor.dwords[4], descriptor.dwords[5], descriptor.dwords[6], descriptor.dwords[7]); } return false; } if (image.depth_compare && uint_program) { if (error != nullptr) { *error = fmt::format("integer image descriptor {} uses depth comparison", i); } return false; } } } for (uint32_t i = 0; i < program.info.addresses.size(); i++) { if (program.info.addresses[i].specialized_base != AddressSpecialization(program.info.addresses[i], snapshot.addresses[i])) { if (error != nullptr) { *error = fmt::format("address resource {} no longer matches specialization", i); } return false; } } return true; } bool MaterializeResources(const Program& program, const SrtRuntime& runtime, ResourceSnapshot& snapshot, std::string* error) { if (!program.resource_tracking_complete) { if (error != nullptr) { *error = "shader resources were not tracked"; } return false; } std::vector requests; requests.reserve(program.info.buffers.size() + program.info.images.size() + program.info.samplers.size() + program.info.addresses.size()); for (const auto& buffer: program.info.buffers) { requests.push_back({buffer.source, buffer.first_use_pc}); } for (const auto& image: program.info.images) { requests.push_back({image.source, image.first_use_pc}); } for (const auto& sampler: program.info.samplers) { requests.push_back({sampler.source, sampler.first_use_pc}); } for (const auto& address: program.info.addresses) { if (!address.unbased) { requests.push_back({address.source, address.first_use_pc}); } } std::vector values; std::vector flattened_srt; if (!EvaluateRuntimeSources(program, requests, runtime, values, flattened_srt, error)) { return false; } ResourceSnapshot next; auto cursor = values.begin(); next.buffers.assign(cursor, cursor + program.info.buffers.size()); cursor += program.info.buffers.size(); for (auto& descriptor: next.buffers) { ShaderBufferResource buffer; if (DecodeBufferDescriptor(descriptor, buffer) && buffer.Type() != 0) { descriptor.dwords.fill(0); } } next.images.assign(cursor, cursor + program.info.images.size()); cursor += program.info.images.size(); for (auto& descriptor: next.images) { if (!ValidImageDescriptor(descriptor)) { descriptor.dwords.fill(0); } } next.samplers.assign(cursor, cursor + program.info.samplers.size()); cursor += program.info.samplers.size(); for (const auto& address: program.info.addresses) { if (!address.unbased) { const auto value = *cursor++; auto base = (static_cast(value.dwords[0]) | static_cast(value.dwords[1]) << 32u) & AddressMask; if (address.kind == ResourceKind::ScalarBuffer) { base &= ~uint64_t {3}; } const auto before = static_cast(-static_cast(address.min_offset)); uint64_t binding_base = 0; if (address.kind == ResourceKind::Flat) { binding_base = base & ~(FlatAddressWindowSize - 1u); } else if (base >= before) { binding_base = base - before; } next.addresses.push_back({base, binding_base}); } else { if (!runtime.flat_memory_base.has_value()) { if (error != nullptr) { *error = fmt::format("unbased {} address at pc 0x{:08x} requires runtime " "guest-address translation", address.kind == ResourceKind::Flat ? "FLAT" : "global/scratch", address.first_use_pc); } return false; } next.addresses.push_back({*runtime.flat_memory_base, *runtime.flat_memory_base}); } } next.flattened_srt = std::move(flattened_srt); next.user_data.assign(runtime.user_data.begin(), runtime.user_data.end()); if (!ValidateResourceSnapshot(program, next, error)) { return false; } snapshot = std::move(next); return true; } bool SpecializeResources(Program& program, const ResourceSnapshot& snapshot, std::string* error) { if (!program.resource_tracking_complete || program.shader_info_complete || program.binding_layout_complete) { if (error != nullptr) { *error = !program.resource_tracking_complete ? "shader resources were not tracked" : "resource specialization is too late"; } return false; } if (!ValidateResourceSnapshot(program, snapshot, error)) { return false; } auto next = program.info; for (uint32_t i = 0; i < next.buffers.size(); i++) { ShaderBufferResource descriptor; if (!DecodeBufferDescriptor(snapshot.buffers[i], descriptor)) { if (error != nullptr) { *error = fmt::format("buffer descriptor {} has invalid width", i); } return false; } next.buffers[i].packed_stride = descriptor.PackedStride(); next.buffers[i].descriptor_format = descriptor.Format(); next.buffers[i].descriptor_swizzle = descriptor.DstSelXYZW(); } for (uint32_t i = 0; i < next.addresses.size(); i++) { next.addresses[i].specialized_base = AddressSpecialization(next.addresses[i], snapshot.addresses[i]); } for (uint32_t i = 0; i < next.images.size(); i++) { const auto& descriptor = snapshot.images[i]; auto& image = next.images[i]; image.mip_count = StorageMipCount(image, descriptor); if (image.mip_count == 0u) { if (error != nullptr) { *error = fmt::format("storage image descriptor {} has an invalid mip range", i); } return false; } if (NullImageDescriptor(descriptor)) { image.dimension = Decoder::ImageDimension::Dim2D; image.cube = false; switch (image.kind) { case ResourceKind::ImageUint: image.kind = ResourceKind::Image; break; case ResourceKind::StorageImageUint: if (!image.atomic) { image.kind = ResourceKind::StorageImage; } break; default: break; } continue; } const auto descriptor_dimension = DescriptorDimension(descriptor, image.dimension); if (descriptor_dimension == Decoder::ImageDimension::Unknown) { if (error != nullptr) { *error = fmt::format( "image descriptor {} has unsupported type {}: {:08x},{:08x},{:08x},{:08x}," "{:08x},{:08x},{:08x},{:08x}", i, (descriptor.dwords[3] >> 28u) & 0xfu, descriptor.dwords[0], descriptor.dwords[1], descriptor.dwords[2], descriptor.dwords[3], descriptor.dwords[4], descriptor.dwords[5], descriptor.dwords[6], descriptor.dwords[7]); } return false; } image.dimension = descriptor_dimension; image.cube = DescriptorIsCube(descriptor); if (image.kind == ResourceKind::StorageImage || image.kind == ResourceKind::StorageImageUint) { image.storage_swizzle = DescriptorImageSwizzle(descriptor); } const auto format = static_cast((descriptor.dwords[1] >> 20u) & 0x1ffu); const bool storage = image.kind == ResourceKind::StorageImage || image.kind == ResourceKind::StorageImageUint; const bool raw_sint_storage = storage && format == Prospero::BufferFormat::k32SInt && !image.read && !image.atomic; const bool uint_image = Prospero::IsUintTextureFormat(format) || raw_sint_storage; if (uint_image) { switch (image.kind) { case ResourceKind::Image: image.kind = ResourceKind::ImageUint; break; case ResourceKind::StorageImage: image.kind = ResourceKind::StorageImageUint; break; default: break; } } } if (program.values == nullptr) { if (error != nullptr) { *error = "typed SSA is not ready"; } return false; } auto memory_info = program.values->memory_info; for (const auto* block: program.values->blocks) { for (const auto& inst: *block) { if (!IsImageOp(inst.GetOpcode())) { continue; } const auto index = inst.Flags().index; if (index >= memory_info.size()) { if (error != nullptr) { *error = fmt::format("typed image instruction has invalid memory metadata {}", index); } return false; } auto& memory = memory_info[index]; if (memory.resource >= next.images.size()) { if (error != nullptr) { *error = fmt::format("typed image instruction has invalid resource {}", memory.resource); } return false; } const auto& image = next.images[memory.resource]; memory.kind = image.kind; memory.image_dimension = image.dimension; memory.image_cube = image.cube; } } program.info = std::move(next); program.values->memory_info = std::move(memory_info); return true; } } // namespace Libs::Graphics::ShaderRecompiler::IR