Files
Triforce-Source/tests/test_bc_raw_targets.py
ruckus7382sfgsgdf 34b3683441 Triforce v0.2.0
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-10 19:32:48 -06:00

72 lines
3.4 KiB
Python

"""A BC texture can be rendered and cleared through a raw (one texel a block) view, sized in blocks, and OoT's noise pass runs
where those views can be made.
OoT renders the slices of two 64^3 BC4 noise volumes as RGBA16UI targets while an area loads (program 53509044401d78d2).
BC images had no colour attachment usage, so those views were not made; the pass ran over no target at the texels' 64 x 64,
and it was left out by default after it lost the device on first starts. The volumes stayed zero and the foliage's dithered
LOD crossfade, which reads them, left trees bare at mid distance (issue 1151).
python -I -B tests/test_bc_raw_targets.py
"""
from pathlib import Path
import re
import unittest
ROOT = Path(__file__).resolve().parents[1]
def block(text, marker):
start = text.index(marker)
end = text.index("{", start) + 1
depth = 1
while depth:
depth += (text[end] == "{") - (text[end] == "}")
end += 1
return text[start:end]
class BcRawTargetTests(unittest.TestCase):
@classmethod
def setUpClass(cls):
cls.tex = (ROOT / "gpu" / "vk" / "vk_texture.cpp").read_text(encoding="utf-8")
cls.draw = (ROOT / "gpu" / "vk" / "vk_draw.cpp").read_text(encoding="utf-8")
cls.xfer = (ROOT / "gpu" / "vk" / "vk_xfer.cpp").read_text(encoding="utf-8")
def test_bc_images_take_colour_attachment_usage_asked_with_the_3d_flags(self):
raw = self.tex.index("Raw storage views address one compressed block per texel")
branch = self.tex[raw:self.tex.index("CUBE_COMPATIBLE_BIT", raw)]
self.assertIn("VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT", branch)
self.assertRegex(branch, r"x\.usage \|= VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT;")
self.assertIn("VK_IMAGE_CREATE_2D_ARRAY_COMPATIBLE_BIT | (dev.view_2d_of_3d", branch)
def test_a_refused_bc_image_is_made_again_without_the_attachment_usage_first(self):
fallback = self.tex.index("// (a compressed image refused:")
begin = self.tex.rfind("} else if (", 0, fallback)
self.assertGreaterEqual(begin, 0)
chain = self.tex[begin:]
chain = chain[:chain.index("logf(\"vk: image %ux%ux%u")]
self.assertIn("!create_image(ci, x.image, x.allocation", chain)
attach = chain.index("ci.usage &= ~VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT")
storage = chain.index("ci.usage &= ~VK_IMAGE_USAGE_STORAGE_BIT")
self.assertLess(attach, storage)
def test_raw_views_of_bc_targets_are_sized_in_blocks(self):
targets = block(self.draw, "Targets targets(NvnState& s)")
self.assertRegex(targets, r"if \(bc\(tex->format\) && !bc\(f\)\) w = \(w \+ 3\) / 4, h = \(h \+ 3\) / 4;")
self.assertLess(targets.index("w = (w + 3) / 4"), targets.index("at.width = at.width ?"))
def test_clears_through_raw_views_are_sized_in_blocks(self):
clear = block(self.xfer, "void clear_tex(")
self.assertIn("raw ? (lw + 3) / 4 : lw", clear)
self.assertIn("ri.renderArea = {{0, 0}, {aw, ah}};", clear)
self.assertIn("const VkClearRect rect{{{rx, ry}, {rw, rh}}, 0, 1};", clear)
def test_the_noise_pass_is_left_out_only_while_its_targets_have_no_view(self):
line = re.search(r'const char\* list = .*RX_VK_SKIP_PROG.*;', self.draw).group(0)
self.assertNotIn("53509044401d78d2", line)
self.assertRegex(self.draw, r"default_list && cp->key == 0x53509044401d78d2ull && !at\.n")
if __name__ == "__main__":
unittest.main()