v0.0.5r3

[leegao]

See https://github.com/leegao/bionic-vulkan-wrapper/releases/tag/v0.0.4 for instructions on how to use it

Missing Feature/Extension emulation for Winlator Bionic on:

1. Adreno 6XX stuck on 512.502 (BCn)
2. Some Mali devices (e.g. Pixel 8)
3. Some Xclipse devices

Current staging build:

[v0.0.5r3] - Fixes a WSI validation error on Mali (and other) devices due to blitting
[v0.0.5r2] - Fix USE_VVL for newer Android devices, add DUMP_BCN_ARTIFACTS for debugging purposes that dumps all processed BCn objects
[v0.0.5r1] - Add vulkan validation layer integration (and ability to add new layers between the wrapper and libvulkan.so)
[v0.0.5r0] - Initial ClipDistance emulation, more complete cpu/gpu side decompression format support, more debugging tools
[v0.0.4r9] - Fixes a compute shader bug for some Mali drivers (can use bcn decoding without USE_CPU_BCN), thanks to Ahmed for helping debug #99
[v0.0.4r8] - Fixes USE_CPU_BCN problem in 4r7
[v0.0.4r7] - Adds GPU fault reporting dumps
[v0.0.4r6] - Reverts a buggy implementation of the inter-buffer GC, and various other improvements / refactorings
[v0.0.4r5] - Fixes a race condition, exposes more error logs from vulkan trace failures
[v0.0.4r4] - Reworked temporary object tracking to be tracked by a secondary command buffer, should reduce memory usage. Added watermarker and mask coloring for debugging. Added more feature faking for G57 r32p1.
[v0.0.4r3] - Reworked temporary object tracking to be tracked by the image, should reduce memory usage slightly, will change this to a thread soon. Also added debug color for buffer overflows in the shader (bright pixel), and fixed GPU faults for BC6 as well
[v0.0.4r2] - Make untracked buffers a non-fatal error, we may be leaking internal/staging vkBuffers out (e.g. WSI did have issues with incomplete buffer tracking too in the past) See #45
[v0.0.4r1] - Fix for GPU faults on BC7 due to register pressure, and add dualSrcBlend as a faked feature for Mali G715 on r38p1. See #43

New Environment Variables:

• MASK_BCN - can be a list of all, bc1, ..., bc7, 131, ..., 146 - skip BCn compute for select BC texture types (to debug GPU faults/hangs)
• WATERMARK_BCN - can be a list of all, bc1, ..., bc7, 131, ..., 146 - mark the bottom 32x32 block of pixels for every texture of this type with a solid color (to debug texture faults)
• USE_CPU_BCN - can be a list of all, bc1, ..., bc7, 131, ..., 146 - use CPU decoding for the selected formats instead of compute (if your game is hanging, try this)
• DISABLE_BCN - disable BCn emulation for specific texture formats (all, bc1 ... bc7, ...)
• WATERMARK_SIZE - how big the WATERMARK_BCN mark should be, from XXS ... S, M, L, ... XXL
• NO_BCN_EMULATION - Disable the BCn emulation path completely
• NO_BC123_EMULATION - Disable the BC1-BC3 emulation path completely
• LOG_DISASSEMBLY - Enables logging of transformed spirv code
• DISABLE_EXTERNAL_FD - For some games that tries to import external fd, it may fail on Proton for certain underlying drivers. This flag will disable this path in dxvk.
• FORCE_CLIP_DISTANCE - enable ClipDistance emulation even when the underlying driver supports it
• DISABLE_CLIP_DISTANCE - disable ClipDistance emulation even when the underlying driver does not support it
• WRAPPER_ONE_By_ONE - submits bcn tasks to the GPU one by one instead of inlined into the application's command buffer. Helps isolate which specific shader causes problems
• USE_VVL - make sure you also download and copy libVkLayer_khronos_validation.so into usr/lib as well, this will toggle on the Vulkan Validation layer
• DUMP_BCN_ARTIFACTS - dumps every decoded texture to a /sdcard/Documents/Wrapper/artifacts_... directory. This is extremely slow and creates lots of really large files. Use only when asked to.

Logging Instructions:

Validation Logs:

1. Create a directory (if it doesn't already exist) at /sdcard/Documents/Wrapper
2. Download libVkLayer_khronos_validation.so.zip
3. Extract the library, and in Winlator, copy it to the same directory that libvulkan_wrapper.so is in
4. Go to the Environment Variables view in your container settings
5. Add an entry for USE_VVL (upper case) to 1
6. Rerun the game
7. Grab the logs at /sdcard/Documents/Wrapper/vvl_*.txt and upload them here

Wrapper Logs:

1. Create a directory (if it doesn't already exist) at /sdcard/Documents/Wrapper
2. Go to the Environment Variables view in your container settings
3. Add an entry for WRAPPER_LOG_LEVEL (upper case) to debug (small case - NOTE: do not set to all as this can generate several gbs of logs)
4. Add another entry for LOG_DISASSEMBLY to 1
5. Rerun the game
6. Grab the logs at /sdcard/Documents/Wrapper/wrapper_*.txt and upload them here

See https://photos.app.goo.gl/6Ah6EkkjQpR2Rsih8

DXVK Logs:

1. Go to the Environment Variables view in your container settings (same as before)
2. Add an entry for DXVK_LOG_LEVEL (upper case) to debug (small case)
3. Add another entry for DXVK_LOG_PATH (upper case) set to /sdcard/Download

Run the game, then go to your Files app, go into Internal storage > Download, and look for $GAME_d3d11.log and upload it as well

Wine Logs:

1. Go to Winlator's settings
2. Scroll down to the Logs section and enable Wine debug and Box64 logs
3. Click on the little + button and also select vulkan and all of the d3d... entries too
4. Rerun the game
5. Grab the logs at /sdcard/Download/Winlator/logs

See https://photos.app.goo.gl/HQunEv1is28vRT9v6

BCn Artifacts:

1. Create a directory (if it doesn't already exist) at /sdcard/Documents/Wrapper
2. Go to the Environment Variables view in your container settings
3. Add an entry for DUMP_BCN_ARTIFACTS (upper case) to 1
4. Rerun the game
5. Zip the newest artifacts at the /sdcard/Documents/Wrapper/artifacts_... directory and upload it

---

Don't forget to set your video memory to the maximum: https://photos.app.goo.gl/53rAyWAZBEq75UxB8

What's Changed

• Initial harness for artifact recording by @leegao in Initial harness for artifact recording #128
• Finish DUMP_BCN_ARTIFACTS implementation by @leegao in Finish DUMP_BCN_ARTIFACTS implementation #130
• Fix BC6h staging buffer size calculation to use the correct texel str… by @leegao in Fix BC6h staging buffer size calculation to use the correct texel str… #132
• Fix Validation error in blit path that fails for Mali devices by @leegao in Fix Validation error in blit path that fails for Mali devices #134

Full Changelog: v0.0.5r1...v0.0.5r3

---

This discussion was created from the release v0.0.5r3.