Skip to content

Tessera 1.2.6

Choose a tag to compare

@pol1ermo pol1ermo released this 19 Nov 22:36
· 8 commits to main since this release

Tessera 1.2.6 — bug fixes: games start at the screen's full resolution, and a Direct3D 12 renderer that D3DMetal cannot run gets its engine's Direct3D 11 renderer.

Fixes

  • Every game can choose any resolution the screen has. Apple's DXGI in D3DMetal, which DirectX 11 and 12 games use for their resolution menu, lists display modes only up to the size Windows reports for the monitor. That was the Mac's scaled desktop size (it "looks like" 2056 × 1329 on a 3456 × 2234 panel), so bigger sizes were missing. Games now start on a desktop as big as the screen's largest real mode: they open at full resolution and their menus list every size up to it. The "Resolutions up to …" setting in a game's Graphics settings is now on by default. Switched off, that game uses the Mac desktop size again: lighter for the GPU, and launchers keep their normal size.
    Checked:

    • The DXGI mode list through D3DMetal with default settings: up to 3456 × 2234 (86 modes). With the setting off: up to 2056 × 1329. On again: 3456 × 2234.
    • The same list through DXMT and through WineD3D: up to 3456 × 2234.
    • A Unity game on D3DMetal (Direct3D 11) opens at 3456 × 2234 and runs at the display's 120 frames a second, presented directly.
  • D3DMetal refuses the indirect-draw setup of BeamNG's Direct3D 12 renderer; that engine now uses its Direct3D 11 renderer through DXMT. The engine's GPU-driven drawing builds a Direct3D 12 command signature that D3DMetal rejects (CreateCommandSignature returns E_INVALIDARG). The engine asks again every frame, about 120 times a second, and draws the scene without that geometry. With GPU-driven drawing turned off, D3DMetal's Direct3D 12 still drew the scene washed out, and the engine's Vulkan renderer stops while starting. Its Direct3D 11 renderer draws correctly, fastest through DXMT, and DXMT lists every resolution. Tessera now starts the engine with -gfx dx11 through DXMT, unless the game's own arguments choose a renderer.
    Measured on an M3 Max at the same place (standing still, 2056 × 1329):

    before 1.2.6
    frames per second 26.5 71.7
    1% low 21.2 fps 58.1 fps
    scene buildings, ground and vehicle missing complete

    The other ways were measured too: Direct3D 12 with GPU-driven drawing off, 77.7 fps but washed out; Direct3D 11 through D3DMetal, 61.6 fps; Vulkan does not start.
    Checked: a Direct3D 12 test program shows D3DMetal accepts the usual indirect-draw layouts (draw, indexed draw and dispatch, also with root constants, root views and vertex or index buffer views), so the refusal is specific to the layout this engine builds. Other games keep D3DMetal; only this engine's start changes.

Settings for testing

Environment variables in a game's Tessera settings:

  • TESSERA_GAME_ARGS=… adds arguments for the game after Steam's (separated by spaces).
  • TESSERA_ENGINE_SWITCHES=0 turns off the engine-specific start above.

Known issues

  • Steam Cloud does not sync saves that games keep in Windows folders (Saved Games, Documents, AppData). Before such a game starts, Steam may say "Unable to Sync": choose Play anyway. The saves stay on the Mac.
  • The first setup has to re-sign Steam.app, so macOS asks once for Steam's microphone access.
  • Anti-cheat protected multiplayer games do not run: Easy Anti-Cheat, BattlEye and Vanguard need a Windows kernel driver.

Updating

Download Tessera-1.2.6.dmg, replace Tessera in Applications and open it once: it updates its files in Steam by itself.

Sources

tessera-runtime-src-1.2.6.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.txt and D3DMetal - 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.6.tar.xz next to this release.