Repository navigation
Tessera 1.2.3
Tessera 1.2.3 — bug fixes and optimisation: 10-bit frames go straight to the display, Visual C++ installers run quietly.
Fixes
-
10-bit frames no longer go through the macOS window compositor. D3DMetal shows DXGI swap chains in the 10-bit R10G10B10A2 format through a Metal layer in the RGB10A2 pixel format. macOS never sends that format directly to the display, so every frame was first copied by the window compositor. That meant an extra full-screen pass on the GPU, extra delay, dropped frames whenever a game ran faster than the display refreshes, and frames shown on the compositor's timing instead of the display's own. Tessera's Metal layer now uses BGR10A2 for these swap chains: the same 10 bits per colour with red and blue stored in the other order, which macOS shows directly ("Direct" instead of "Composited" in Apple's Metal HUD). D3DMetal converts into it with its own pass, so colours are unchanged. This applies to D3D11 and D3D12 through D3DMetal. DXMT and MoltenVK (Vulkan, and WineD3D on top of it) keep their format, because MoltenVK draws straight into the layer and the swap would turn red into blue there.
Measured on an M3 Max with a 120 Hz ProMotion display, D3D12 at about 175 frames a second:1.2.2 1.2.3 presentation (Metal HUD) Composited Direct frames that never reached the screen 22% 1% finished frame to screen, median / 95% 13.6 / 19.2 ms 7.8 / 10.5 ms frames shown per second (Metal HUD) ~100 ~168 Below the display's refresh rate, with the CPU as the limit, timing and mouse-to-screen time stayed the same (about 80 frames a second in both). The gain shows when a game is GPU-bound or faster than the display.
Checked with 10-bit D3D11 and D3D12 test programs through D3DMetal (Direct, colours correct, 21 ms mouse-to-screen at 80 frames a second), the same programs through DXMT and through WineD3D with MoltenVK (unchanged, colours correct), and with 8-bit games on D3DMetal (Unity) and on MoltenVK (Godot), which are unchanged and already Direct. -
Visual C++ installers in Steam's first-start scripts run quietly. Install scripts of older games start Microsoft's Visual C++ redistributable without switches, so it opened its licence window and waited for a click. When a script gives no switches, Tessera now adds the quiet switch (
/q). Tested with the 2005 SP1 package: it installs with no window.
Settings for testing
Environment variables in a game's Tessera settings: TESSERA_PRESENT_LOG=/path/file logs, for every frame, when the game asked for a drawable and when that frame reached the screen, plus the layer's format and settings. TESSERA_METAL_DRAWABLES=2|3 and TESSERA_METAL_VSYNC=0|1 replace the frame-queue length and vsync that the graphics layer asks for. TESSERA_METAL_DIRECT_FORMAT=0 turns the 10-bit change off.
Known issues
- DirectX's own installer (DXSETUP) can't run silently under Wine: it fails to verify the signatures of its .cab files. Games whose first start runs it still show its setup wizard.
- Some DirectDraw / Direct3D 7 games (around 2000) start but show a black screen.
- Setup re-signs Steam.app, so macOS asks again for Steam's microphone access; games with voice chat wait until you answer.
- Anti-cheat protected multiplayer games do not run.
Updating
Download Tessera-1.2.3.dmg, replace Tessera in Applications and open it once: it updates its files in Steam by itself.
Sources
tessera-runtime-src-1.2.3.tar.xz holds the exact sources of the runtime's LGPL libraries (Wine with Tessera's changes, FreeType, GnuTLS, Nettle, GMP, FFmpeg, GStreamer and GLib), MoltenVK 1.4.2 as released with the build script that applies Tessera's change, the Steam bridge, and the build scripts.
Licences
Every component this release includes, with its licence (full texts: Tessera-licences.zip, also inside the app in Contents/Resources/Licenses):
- D3DMetal (Apple Game Porting Toolkit redistributables, version 3.0): Apple's licence; included unmodified and distributed free of charge, non-commercially only (licence sections 2A(iii) and 2C). Text:
D3DMetal - Apple Game Porting Toolkit License.txtandD3DMetal - Acknowledgements.txt. - Wine 11.0: GNU LGPL 2.1 or later; built with its bundled libraries Capstone, compiler-rt, FAudio, FluidSynth, GSM 06.10, libjpeg (based in part on the work of the Independent JPEG Group), JPEG XR, Little CMS, OpenLDAP, mpg123, musl, libpng, libtiff, LibTomCrypt, vkd3d, libxml2, libxslt and zlib (each under its own licence); Unicode data: Unicode License v3.
- DXMT: MIT; contains LLVM (Apache License 2.0 with LLVM exceptions).
- MoltenVK: Apache License 2.0; contains SPIRV-Cross (Apache License 2.0) and cereal (BSD).
- FreeType: FreeType License. GnuTLS: GNU LGPL 2.1 or later. Nettle, GMP: GNU LGPL 3 or later (with the GNU GPL 3 text). FFmpeg: GNU LGPL 2.1 or later.
- GStreamer, GLib, proxy-libintl: GNU LGPL 2.1 or later. libffi: MIT. PCRE2, orc: BSD.
- Steam bridge: Valve Proton's lsteamclient (BSD 3-clause) with the Steamworks SDK headers Valve publishes with it (Valve's SDK licence).
Source code the LGPL requires:tessera-runtime-src-1.2.3.tar.xznext to this release.