Skip to content

Releases

Tessera 1.2.11.1

Choose a tag to compare

@pol1ermo pol1ermo released this 21 Nov 18:17

Tessera 1.2.11.1 — games reach Steam on every Mac (the fix for games that started without a window, sat at 100 % CPU or closed), Apple's D3DMetal 4.0 beta 3 with 3.0 kept beside it, DLSS through MetalFX, Microsoft's .NET Framework for the launchers that need it, colour emoji and Windows' UI font in launchers, Windows folders that repair themselves, and a dozen more fixes.

Please update from every earlier version. From 1.2.0 to 1.2.11, a game's first call to Steam never returned on any Mac that did not happen to have Valve's Windows Steam files from another tool (see the first fix).

New

  • Apple's D3DMetal 4.0 beta 3 (Game Porting Toolkit 4.0 beta 3) is the DirectX 10-12 translation on macOS 26.4 and later. Unreal Engine 5 games that stopped at start with 3.0 now run (Satisfactory: main menu, 34 fps at 3456 x 2234), and Direct3D 12 video textures (NV12) work.
    D3DMetal 3.0 stays in Tessera for macOS 15.4 to 26.3, where 4.0 does not load (Apple makes its shader library for macOS 26.4 and later), and as a choice per game: "D3DMetal 3.0" under Translation, for a game that misbehaves with the beta. On macOS 14.0 to 15.3 neither loads; DirectX 9-11 games go through DXVK there by themselves.
  • DLSS through MetalFX (a switch in each game's settings, D3DMetal 4): the game sees an NVIDIA graphics card, and the DLSS upscaling chosen in its graphics settings runs on Apple's MetalFX. Apple's stand-ins for NVIDIA's libraries are used only by games with the switch on, and are taken out of the game's Windows folder again when it is turned off.
    Checked in Satisfactory: DLSS is offered and active (2592 x 1676 to 3456 x 2234); 33.6 fps against 33.8 fps with the game's own FSR 3.1 at the same quality, so it is a choice of upscaler there, not a speed-up.
  • Microsoft's .NET Framework 4.8 for the launchers that need it. Wine's own .NET (Wine Mono) runs almost every .NET launcher, but not Assetto Corsa's (it cannot load the launcher's embedded browser). Tessera now asks once and installs Microsoft's .NET Framework 4.8 into that game's Windows folder only: 123 MB from Microsoft, checked against known checksums, about four minutes. Any game can be given it with the switch "Microsoft .NET Framework 4.8".
    Checked: Assetto Corsa's launcher opens to its language choice, main menu and Drive page; it stays installed when Tessera updates the Windows folder.

Fixes

  • Games reach Steam on every Mac (The Last of Us Part I and others started without a window and stayed at 100 % CPU, or closed). A Windows game talks to Steam through Valve's steamclient.dll / steamclient64.dll in a Steam folder, and Steam runs a game's first-start scripts with Valve's iscriptevaluator.exe. The Linux Steam client carries these Windows files; the Mac client does not. Tessera took them from Steam's legacycompat folder, where on the Mac it was made on another tool had put them, so there everything worked. On every other Mac they were missing, and two things went wrong:

    • Steam's first-start step failed at every start (the game log shows iscriptevaluator.exe ... exited with 1).
    • Tessera's own Steam library was put in the Steam folder as a stand-in, and since 1.2.0 Tessera's Wine linked that library's functions to themselves: the game's first call to Steam never returned.

    Now Tessera downloads Valve's own package from Valve's update server (29 MB, once, checked against its SHA-256) as soon as it opens, or at a game's start, keeps the six files in its own folder and puts copies where Steam and its script runner look for them (each game's Windows folder and Steam's legacycompat folder, as in the Linux client; "Remove from Steam" takes those out again). And the stand-in works again when the download is not possible.
    Checked on a Mac returned to a first-time state (Tessera removed, the other tool's files taken out): 1.2.11's behaviour reproduced exactly as reported, and gone with this build, both with Valve's files and with the stand-in.

  • A game's first start finds its Steam Cloud saves. Before the first start of a game with cloud saves, Steam makes the game's Windows folder path itself and puts the saves there. Tessera took that for another tool's Windows folder and set up its own beside it, where the game never saw the saves. Tessera now sets up the folder Steam made. (A game already started with an earlier Tessera keeps the folder it has.)

  • "Remove from Steam" can no longer leave Steam.app without its Info.plist. Removing deleted each of Valve's files before writing the original back; where macOS refused the write (App Management), Steam.app was left incomplete and could not open. The originals are now copied next to their places first and swapped in only when all of them arrived; a refusal leaves Steam.app as it was and says which switch to turn on. A Steam.app left incomplete by an earlier version is offered "Repair", and Tessera --restore-steam does the same from Terminal.

  • Windows programs start on macOS before 27 (also in 1.2.11): Tessera's Wine and GLib called pipe2(), a system function only macOS 27 has.

  • A Windows folder set up by Tessera 1.2.10 or earlier on macOS 14, 15 or 26 is completed by itself. There no Windows program could start before 1.2.11, yet the set-up was recorded as done: the folder was marked as having Microsoft's Visual C++ runtimes although every installer had stopped, and the shared template for new games was kept half-made. With 1.2.11 games then started without those runtimes (The Last of Us Part I opened a window and closed again). Tessera now looks for Microsoft's files, not only for its own mark: a folder without them gets them at the game's next start (two to three minutes, once), a half-made template is made again, and the mark is written only when the runtimes really are there.
    Checked on a macOS 15.7 test machine by replaying that history (1.2.9, 1.2.11, then this version): the damaged game folder got its runtimes, a new game got a complete folder, a third start changed nothing.

  • Videos that froze after a few frames play (Capcom Arcade 2nd Stadium: black screen while the sound played). A program reads a video's picture and sound one piece at a time; when it waited for sound that lies seconds further on in the file, the video in between had to be queued, and the queue was limited to 8 MB (a second and a half of this game's 45 Mbit/s movie). It then stopped for good. The queue may now hold 128 MB; ordinary playback still keeps a small queue. With D3DMetal 4's video textures the game now shows its intro, creates its save and reaches its menus.

  • A fullscreen game that minimizes itself for a question comes back by itself (BERSERK and the Band of the Hawk kept running minimized behind Steam after "Start the game in Windows 7 compatibility mode?"). The game waits to be activated after the question; when its question box closes and nothing is active, Tessera's Wine now activates the minimized window from the program's own message loop, as a switch from the Dock would.

  • Text in launchers that draw with DirectWrite (WPF and other .NET launchers, Chromium-based ones). Windows' UI font Segoe UI does not exist on a Mac, and programs fall back to it for Cyrillic, Greek and other scripts their own font lacks: such text came out as empty boxes (Borderlands 2's Russian launcher). Segoe UI now stands for Tahoma, and the Chinese, Japanese and Korean font names of 1.2.9 now reach DirectWrite too.

  • Colour emoji through DirectWrite. Emoji now fall back to the Mac's Apple Color Emoji font (as "Segoe UI Emoji"), and programs get each emoji's picture from it. (Checked with a test program; BeamNG's launcher itself not yet.)

  • Games started by their own launcher find Steam again. Borderlands 2's 2K launcher starts the game and closes; the game then stopped with "Steam must be running in order to launch Borderlands 2". Tessera's stand-in for the Windows Steam client now stays until every program started from the game has ended.

  • Games no longer stop behind "Steam would like to access files on a network volume". Some Windows programs look for files at paths of the computer they were built on, such as /home/jenkins/... (the VLC video player inside RUINER); on a Mac /home is an automount point, and macOS asked before Wine could look. Such paths now count as missing without touching /home.

  • The Visual Basic 6 runtime is in every game's Windows folder (608 KB from Microsoft's Windows XP SP3 package, checked against known checksums).

  • Decoded video comes in 2D buffers, as on Windows (IMF2DBuffer), for games that read frames line by line.

  • Steam's older DRM (CEG, 2009-2013 games) gets an answer, so the game does not wait 30 seconds for nothing; the game log says when a game asked.

  • Tessera's release check now refuses any file that needs a newer macOS than stated, and any system function an older macOS may not have that is called without a check.

Known issues

  • A few games with Valve's older CEG DRM need the Windows Steam client's own answer to start: Borderlands 2 RU edition, XCOM: Enemy Unknown, Hitman: Absolution / Sniper Challenge. The macOS Steam client cannot give it, and Tessera does not imitate DRM.
  • Anti-cheat protected multiplayer games do not run: Easy Anti-Cheat, BattlEye and Vanguard need a Windows kernel driver.
  • Games that need an OpenGL compatibility profile (id Tech 5: Wolfenstein: The Old Blood) stop at start: macOS offers OpenGL 3.2 and later only as core profiles.
  • Assetto Corsa's launcher draws its page in the top-left part of the screen on a Retina display.
  • The first setup has to re-sign Steam.app, so macOS asks once for Steam's microphone access.

Checked before this build

  • From a first-time state on macOS 27.2 (M3 Max): Tessera removed with its own "Remove", its folders, the game's Windows folder and the other tool's Steam files taken away, then installed from the disk image and set up in Steam....
Read more

Tessera 1.2.11

Choose a tag to compare

@pol1ermo pol1ermo released this 21 Nov 14:13

Tessera 1.2.11 — games start on macOS 14, 15 and 26. Until now no Windows game started on any macOS before 27.

Fixes

  • Windows programs start on macOS before 27. Every Windows program stopped the moment it started: the game's log in ~/Library/Logs/Tessera shows "game exited with 11", also for Steam's install step before the game. Tessera's Wine called pipe2(), a system function that only macOS 27 has, for its connection to the Wine server in every program. Tessera is built on macOS 27 for macOS 14 and later, and on an older macOS that call goes nowhere and ends the program. Wine now uses pipe(), which every macOS has, as it did before macOS 27 existed. This was in every Tessera release so far; 1.2.10's change (two files marked for macOS 27.2) did not cure it.

  • The same call is out of GLib, which GStreamer uses for game videos and sound: it would have ended a game at its first video.

  • Tessera's release check now lists every system function that an older macOS may not have, in every program and library, and fails on any that is not checked before it is called.

    Checked: Wine's ntdll has the same 901 functions as 1.2.9's, with the two that open pipes changed; no file in Tessera refers to pipe2() any more; on macOS 27.2 a Windows test program starts and a video decodes to the same 161 frames as before.

Everything else is unchanged from 1.2.9.

Known issues

  • Tessera has only been run on macOS 27 and (from this version) checked for macOS 14 to 26 by its build; if a game does not start on an older macOS, the game's log in ~/Library/Logs/Tessera helps to find out why.
  • The Visual Basic 6 runtime is not included: Microsoft no longer offers it as a separate download. Programs written in Visual Basic 6 that do not bring it stop at start.
  • Borderlands 2: the game closes right after its launcher starts it (an older Steam DRM start check that Tessera does not answer yet); the launcher's text shows as empty boxes.
  • Capcom Arcade 2nd Stadium (Direct3D 12 only) stays black while its intro movie's sound plays.
  • 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.
  • Games that check for old OpenGL extension names (id Tech 5: Wolfenstein: The Old Blood) stop at start: macOS offers OpenGL 3.2 and later only as core profiles, which do not list those extensions.
  • Some .NET launchers rely on behaviour where Wine Mono differs from Microsoft's .NET Framework; Assetto Corsa's own launcher stops with an error (the game itself runs).
  • A game's window was once seen opening behind Steam's window after the game's own message box (BERSERK and the Band of the Hawk); Mission Control brings it forward.

Updating

Download Tessera-1.2.11.dmg, replace Tessera in Applications and open it once: it updates its files in Steam by itself. Then start the game from Steam; the first start of each game takes a minute or two longer, once, while its Windows folder is set up.

Sources

tessera-runtime-src-1.2.11.tar.xz holds the exact sources of the runtime's LGPL libraries (Wine with Tessera's changes, FreeType, GnuTLS, Nettle, GMP, FFmpeg, GStreamer, GLib and OpenAL Soft with Tessera's one-line build fix), MoltenVK 1.4.2 as released with the build script that applies Tessera's change, the DXVK and MoltenVK sources with the script that builds them, the Steam bridge, and the build scripts; they are 1.2.10's, with pipe2() out of Wine's ntdll and the build script that takes it out of GLib. Wine Mono 10.4.1 and Wine Gecko 2.47.4 are included unchanged; their sources are wine-mono-10.4.1-src.tar.xz and wine-gecko-2.47.4-src.tar.xz. Tessera-licences.zip holds the licence texts.

Tessera 1.2.10

Choose a tag to compare

@pol1ermo pol1ermo released this 21 Nov 13:42

Use Tessera 1.2.11 instead. 1.2.10 does not cure "game exited with 11" on macOS before 27: the cause was a different one (a system function that only macOS 27 has), fixed in 1.2.11. What 1.2.10 changed is correct but was not the reason games did not start.

Tessera 1.2.10 — games start again on Macs that are not on the newest macOS. In 1.2.9 no Windows game started there.

Fixes

  • Games start on macOS versions before 27.2 again. Two of 1.2.9's files were marked for macOS 27.2, the version they were built on: Wine's start-up program, through which every Windows program starts, and the Steam bridge. On any older macOS every Windows program stopped the moment it started, so no game ran at all; the game's log in ~/Library/Logs/Tessera shows "game exited with 11", also for Steam's install step before it. Both files are now made for macOS 11 and later, with the same code as before, and Tessera's release check now refuses any file that needs a newer macOS than Tessera states (14.0).
    Checked: the start-up program's machine code is identical to 1.2.9's; the Steam bridge has the same functions, built for macOS 11; a Windows test program starts through 1.2.10's launcher and runtime; every other file in Tessera was already made for macOS 11 to 14, apart from two parts by other makers that state their own minimum (one part of Apple's D3DMetal: macOS 15.4; DXMT's Metal bridge: macOS 15).

Everything else is unchanged from 1.2.9.

Known issues

  • The Visual Basic 6 runtime is not included: Microsoft no longer offers it as a separate download. Programs written in Visual Basic 6 that do not bring it stop at start.
  • Borderlands 2: the game closes right after its launcher starts it (an older Steam DRM start check that Tessera does not answer yet); the launcher's text shows as empty boxes.
  • Capcom Arcade 2nd Stadium (Direct3D 12 only) stays black while its intro movie's sound plays.
  • 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.
  • Games that check for old OpenGL extension names (id Tech 5: Wolfenstein: The Old Blood) stop at start: macOS offers OpenGL 3.2 and later only as core profiles, which do not list those extensions.
  • Some .NET launchers rely on behaviour where Wine Mono differs from Microsoft's .NET Framework; Assetto Corsa's own launcher stops with an error (the game itself runs).
  • A game's window was once seen opening behind Steam's window after the game's own message box (BERSERK and the Band of the Hawk); Mission Control brings it forward.

Updating

Download Tessera-1.2.10.dmg, replace Tessera in Applications and open it once: it updates its files in Steam by itself. Games then start as before; nothing in your games' Windows folders changes.

Sources

tessera-runtime-src-1.2.10.tar.xz holds the exact sources of the runtime's LGPL libraries (Wine with Tessera's changes, FreeType, GnuTLS, Nettle, GMP, FFmpeg, GStreamer, GLib and OpenAL Soft with Tessera's one-line build fix), MoltenVK 1.4.2 as released with the build script that applies Tessera's change, the DXVK and MoltenVK sources with the script that builds them, the Steam bridge, and the build scripts; they are 1.2.9's, with the Steam bridge's build script now stating the oldest macOS. Wine Mono 10.4.1 and Wine Gecko 2.47.4 are included unchanged; their sources are wine-mono-10.4.1-src.tar.xz and wine-gecko-2.47.4-src.tar.xz. Tessera-licences.zip holds the licence texts.

Tessera 1.2.9

Choose a tag to compare

@pol1ermo pol1ermo released this 20 Nov 18:49

Tessera 1.2.9 — what games expect from a Windows PC: Microsoft's Visual C++ runtimes, MFC and DirectX extras in every game's Windows folder, OpenAL and the Internet Explorer engine built in, Chinese, Japanese and Korean text, and no more AMD driver warning in Unreal Engine 5 games.

Fixes

  • Microsoft's Visual C++ 2005–2022 runtimes (with MFC), MFC 4.2 and the DirectX 9.0c parts Wine lacks are in every game's Windows folder. A Windows PC has them from other programs; a game's Windows folder only had Wine's own reimplementations, plus whatever the game's Steam install step added. Programs that need MFC 4.2 or MFC 10–14 stopped at start ("mfc42.dll was not found"), games using XACT 2.1–2.10 audio or D3DCSX found no such DLL, and games relying on the real Visual C++ runtime ran on Wine's approximation. Microsoft's licence does not let Tessera ship these files, so Tessera downloads Microsoft's own installers from Microsoft as soon as you open it (about 195 MB, once, each checked against a known checksum). The Steam page shows whether they are downloaded, the download's progress, or why it failed, with Try Again. A new game gets them instantly from Tessera's template; a game set up before gets them at its next start (about 50 seconds, once). A game started before the download is done fetches what is missing itself; without internet, games start with Wine's own versions, which stay as the fallback.
    Checked: opening Tessera with nothing downloaded fetched all 14 files from Microsoft in about 20 seconds, the Steam page going from its progress bar to "downloaded"; a game started while one was missing fetched it itself. A test program loads 256 of 264 Windows DLLs games commonly use from 32-bit games (1.2.8: 242) and 248 from 64-bit games (1.2.8: 243) — MFC 4.2 and 10–14, XACT 2.1–2.10, D3DCSX and OpenAL now load. R.E.P.O., KovaaK's, Buckshot Roulette and METAL GEAR start normally after the one-time install; Fallout: New Vegas installs, its launcher detects the video hardware and the game reaches its main menu at 120 frames per second.
  • OpenAL is built in. Windows has no OpenAL of its own, and neither had Wine: games that use OpenAL32.dll without shipping it stopped at start unless Creative's old installer had run. Tessera now carries OpenAL Soft 1.25.2 (open source) and puts it where that installer would; a game that brings its own OpenAL32.dll keeps using that one.
    Checked: OpenAL opens the Mac's sound output from 64-bit and 32-bit programs.
  • Embedded web pages work (the Internet Explorer engine). Launchers and installers that show news, licence texts or sign-in pages in an embedded Internet Explorer had nothing to draw with: the engine was off so that Wine would not ask to download it. Tessera now carries Wine Gecko 2.47.4, and the engine is on.
    Checked: an HTML page is parsed and its text read back, from 64-bit and 32-bit programs.
  • Chinese, Japanese and Korean text shows. Windows names its fonts for these languages MS Gothic, SimSun, Microsoft YaHei, Malgun Gothic and so on; a Mac has none of them, so every Chinese, Japanese or Korean character in windows, dialogs and launchers drawn with Windows fonts — Tahoma, Segoe UI and MS Shell Dlg included — showed as an empty box. Those names now stand for the Mac's own fonts of each language (Hiragino Sans and Mincho, Heiti and Songti, Apple SD Gothic Neo), which the fallback lists of the other fonts already pointed to.
    Checked: Japanese, Chinese and Korean characters are drawn in Tahoma, MS Shell Dlg, Segoe UI, Arial, Microsoft Sans Serif and MS Gothic (1.2.8: empty boxes in all of them), in new and in existing Windows folders.
  • No more "The installed version of the AMD graphics driver has known issues" in Unreal Engine 5 games. D3DMetal presents the Mac's GPU to games as an AMD card and writes the driver version 30.0.15.1233; Unreal Engine 5 treats AMD drivers older than 30.0.14011.2006 as buggy and asked at every start (BIGFOOT, Chained Together). Games now read the AMD driver version Wine itself reports (35.0.21025.1024).
    Checked: Chained Together (Unreal Engine 5, Direct3D 12) opens straight to its main menu (1.2.8: the box at every start);
    after D3DMetal starts, the version games read is 35.0.21025.1024 (1.2.8: 30.0.15.1233).

Known issues

  • The Visual Basic 6 runtime is not included: Microsoft no longer offers it as a separate download. Programs written in Visual Basic 6 that do not bring it stop at start.
  • Borderlands 2: the game closes right after its launcher starts it (an older Steam DRM start check that Tessera does not answer yet); the launcher's text shows as empty boxes.
  • Capcom Arcade 2nd Stadium (Direct3D 12 only) stays black while its intro movie's sound plays.
  • 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.
  • Games that check for old OpenGL extension names (id Tech 5: Wolfenstein: The Old Blood) stop at start: macOS offers OpenGL 3.2 and later only as core profiles, which do not list those extensions.
  • Some .NET launchers rely on behaviour where Wine Mono differs from Microsoft's .NET Framework; Assetto Corsa's own launcher stops with an error (the game itself runs).
  • A game's window was once seen opening behind Steam's window after the game's own message box (BERSERK and the Band of the Hawk); Mission Control brings it forward.

Updating

Download Tessera-1.2.9.dmg, replace Tessera in Applications and open it once: it updates its files in Steam by itself and downloads Microsoft's runtimes (about 195 MB; the Steam page shows when they are done). The first start of each game you already have then takes about a minute longer, once, while its Windows folder gets them.

Sources

tessera-runtime-src-1.2.9.tar.xz holds the exact sources of the runtime's LGPL libraries (Wine with Tessera's changes, FreeType, GnuTLS, Nettle, GMP, FFmpeg, GStreamer, GLib and OpenAL Soft with Tessera's one-line build fix), MoltenVK 1.4.2 as released with the build script that applies Tessera's change, the DXVK and MoltenVK sources with the script that builds them, the Steam bridge, and the build scripts. Wine Mono 10.4.1 and Wine Gecko 2.47.4 are included unchanged; their sources are wine-mono-10.4.1-src.tar.xz and wine-gecko-2.47.4-src.tar.xz. Tessera-licences.zip holds the licence texts.

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.
  • Wine Mono 10.4.1: MIT, LGPL, MS-PL, zlib, BSD/OpenSSL (BoringSSL) and GPL 2 with a linking exception (SharpZipLib).
  • DXVK 1.10.3 for macOS: zlib licence; contains the MinGW-w64 runtime (its notices) and OpenVR headers (BSD). MoltenVK for DXVK: Apache License 2.0 (with SPIRV-Cross and cereal).
  • Steam bridge: Valve Proton's lsteamclient (BSD 3-clause) with the Steamworks SDK headers Valve publishes with it (Valve's SDK licence).
  • Wine Gecko 2.47.4 (Wine's Internet Explorer engine, from Mozilla's code): Mozilla Public License 2.0.
  • OpenAL Soft 1.25.2: GNU LGPL 2.0 or later; contains PFFFT (BSD-style licence) and HRTF data made from the KEMAR measurements by Bill Gardner and Keith Martin, MIT Media Laboratory (free to use with credit).
  • Not included: Microsoft's Visual C++ runtimes 2005–2022 (with MFC), MFC 4.2 and parts of DirectX 9.0c (June 2010). Microsoft's licence does not allow Tessera to ship them; Tessera downloads Microsoft's own installers from Microsoft on your Mac, checks each against a known checksum and installs them into each game's Windows folder, where they are used under Microsoft's licence terms for those packages.
    Source code the LGPL and MPL require: tessera-runtime-src-1.2.9.tar.xz next to this release, wine-mono-10.4.1-src.tar.xz and wine-gecko-2.47.4-src.tar.xz.

Tessera 1.2.8

Choose a tag to compare

@pol1ermo pol1ermo released this 20 Nov 16:15

Tessera 1.2.8 — bug fixes: Steam Cloud syncs saves kept in Documents, Konami's Metal Gear collections draw their games, older Visual C++ install steps run quietly, and the app carries the licence texts of every component.

Fixes

  • Steam Cloud syncs saves kept in Documents. Steam maps a game's "My Documents" saves to the Windows XP folder name inside the game's Windows folder (…/steamuser/My Documents), as it does for Proton, whose Windows folders link that name to Documents. Tessera's did not: Steam watched a separate My Documents folder the game never uses, so saves in Documents (Skyrim, Borderlands 2 and many games of the 2000s and 2010s) were never uploaded, and downloaded ones landed beside the game's. Tessera now links My Documents, Application Data and Local Settings\Application Data to today's folders at every start; files Steam had put under the old names are merged into the new folders (never into a save folder the game already has), and the old folder is kept as "… BACKUP".
    Checked: Skyrim Special Edition, whose save lives in Documents: Steam's scan found no files before; now it finds the save at the game's exit and uploads it ("Upload OK").
  • METAL GEAR & METAL GEAR 2: Solid Snake shows its games. The collection's launcher (a Unity program) worked, but the games, which run in Konami's own engine (EngineSupport\stovk.bin next to the program), showed only black frames at 60 frames a second with D3DMetal; DXMT draws them correctly. Automatic now picks DXMT for programs of this engine.
    Checked: Automatic picks DXMT; METAL GEAR's title menu, difficulty choice and the first area of Outer Heaven draw correctly, keyboard play works and Steam's achievement pop-up appears.
  • Visual C++ 2010 and later install quietly when a game's script passes the old switch. Steam install scripts may run any Visual C++ package with /q:a, the quiet switch of the IExpress packages of Visual C++ 2005 and 2008. The installer of 2010 and later does not know it and waited at its licence window (Borderlands 2). Tessera now reads the installer's version and passes /q /norestart to version 10 and later.
    Checked: Borderlands 2's first-start script installs Visual C++ 2005, 2008 and 2010 SP1 without a window and the game's launcher opens.
  • Licence texts of every component. The Licenses folder inside the app now holds 36 texts: added the GNU GPL texts the LGPL 3 relies on, the libraries Wine builds into its DLLs (libjpeg, libpng, libtiff, zlib and 14 more), LLVM (inside DXMT), cereal and SPIRV-Cross (inside MoltenVK), the MinGW-w64 runtime and OpenVR headers (inside DXVK), the parts of Wine Mono (BoringSSL, SDL3, FAudio and others) and the Unicode data licence. Every earlier release now has Tessera-licences.zip with the same texts.

Known issues

  • Some Unreal Engine 5 games (BIGFOOT, Chained Together) show "The installed version of the AMD graphics driver has known issues" at every start: D3DMetal reports an AMD driver version older than Unreal accepts. Answer No and the game runs; a fix is being tested for the next version.
  • Borderlands 2: the game closes right after its launcher starts it (an older Steam DRM start check that Tessera does not answer yet); the launcher's text shows as empty boxes.
  • Capcom Arcade 2nd Stadium (Direct3D 12 only) stays black while its intro movie's sound plays.
  • The first time a game syncs after updating from 1.2.6 or earlier, Steam may report a conflict if another computer uploaded saves while the Mac could not sync. Keep the copy you want, usually the newer one on this 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.
  • Games that check for old OpenGL extension names (id Tech 5: Wolfenstein: The Old Blood) stop at start: macOS offers OpenGL 3.2 and later only as core profiles, which do not list those extensions.
  • Some .NET launchers rely on behaviour where Wine Mono differs from Microsoft's .NET Framework; Assetto Corsa's own launcher stops with an error (the game itself runs).
  • A game's window was once seen opening behind Steam's window after the game's own message box (BERSERK and the Band of the Hawk); Mission Control brings it forward.

Updating

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

Sources

tessera-runtime-src-1.2.8.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 DXVK and MoltenVK sources with the script that builds them, the Steam bridge, and the build scripts. Wine Mono 10.4.1 is included unchanged; its source is wine-mono-10.4.1-src.tar.xz. Tessera-licences.zip holds the licence texts.

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.
  • Wine Mono 10.4.1: MIT, LGPL, MS-PL, zlib, BSD/OpenSSL (BoringSSL) and GPL 2 with a linking exception (SharpZipLib).
  • DXVK 1.10.3 for macOS: zlib licence; contains the MinGW-w64 runtime (its notices) and OpenVR headers (BSD). MoltenVK for DXVK: Apache License 2.0 (with SPIRV-Cross and cereal).
  • 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.8.tar.xz next to this release, and wine-mono-10.4.1-src.tar.xz.

Tessera 1.2.7

Choose a tag to compare

@pol1ermo pol1ermo released this 20 Nov 09:45

Tessera 1.2.7 — bug fixes: Steam Cloud saves in Windows folders sync, Windows games start on Macs without Rosetta 2, a new DXVK graphics option runs Skyrim Special Edition, 32-bit DirectX 11 games start, .NET programs run, games whose Mac version is 32-bit can play their Windows version, Vulkan games no longer go black at sizes above the desktop, and the full-resolution desktop is used only where it is needed.

Fixes

  • Steam Cloud now finds saves kept in Windows folders. Many games save under Saved Games, Documents or AppData (Local, LocalLow, Roaming). Steam translates those folders into a game's Windows folder (compatdata/<id>/pfx/drive_c/users/steamuser/…) only for compatibility tools whose internal name contains "proton": it checks the name when it registers the tool, and otherwise logs "Unable to resolve path with root WinSavedGames". Tessera's tool was registered as "tessera", so Steam neither uploaded nor downloaded these saves, and games with existing cloud saves stopped at "Unable to Sync" before starting. The tool is now registered as "tessera_proton". Steam still shows "Tessera".
    Updating from 1.2.6 or earlier: Tessera shows "Needs repair: Steam has to restart once to finish the update". Click Repair: Tessera quits Steam, moves every game from the old name to the new one, and opens Steam again. Until then games keep working as before.
    Checked:
    • Saves in AppData\Local: Steam watches them inside the game's Windows folder, and the "Unable to Sync" prompt is gone.
    • Saves in AppData\LocalLow: Steam watches them and uploads them when the game closes ("Upload OK").
    • Updating a 1.2.6 setup: Repair renamed the default mapping and the tool, and the state is "ready". Games start through the renamed tool.
  • Windows games start on Macs without Rosetta 2. Tessera's Windows runtime runs Intel code through Apple's Rosetta 2. Apple-silicon Macs get Rosetta only when something asks for it, and Steam itself runs natively, so a Mac can have Steam and Tessera without Rosetta: then every Windows game failed to start, whatever the graphics setting. When Rosetta is missing, Tessera now asks before a game starts and installs it with Apple's softwareupdate (no administrator password needed); the Tessera app shows it too and Repair installs it.
    Checked: with Rosetta reported missing, the prompt appeared, Rosetta installed in about 5 seconds, and the program then started; the app showed the repair message and "ready" afterwards.
  • New graphics option: DXVK, which runs The Elder Scrolls V: Skyrim Special Edition. Skyrim Special Edition crashed about 12 seconds after starting, in the game's own code, with both of Tessera's Metal translations of Direct3D 11 (D3DMetal and DXMT): at the intro video, and with the intro skipped, at New Game. DXVK translates Direct3D 9–11 to Vulkan instead; Tessera now carries DXVK for macOS together with the MoltenVK version it is made for (with the MoltenVK Tessera uses for other games it crashes at once), both built from source, from the same open-source archive as Tessera's Wine; only games on DXVK use them. Automatic picks DXVK for Skyrim Special Edition; any game can choose it in its Graphics settings.
    Checked: started from Steam on Automatic, Skyrim Special Edition's launcher and the game itself run on DXVK: the intro plays well past the point where it crashed, the main menu opens and a saved game loads; a Unity Direct3D 11 game draws its main menu on DXVK too.
  • 32-bit Direct3D 11 games start. Automatic chose D3DMetal, which exists only for 64-bit programs, so a 32-bit game fell back to Wine's own Direct3D 11, which cannot create a device on macOS's OpenGL (Unity: "Failed to initialize graphics"). Automatic now picks DXMT, which has a 32-bit version, for 32-bit programs that use Direct3D 10/11 and for 32-bit Unity games; Direct3D 9 games are unaffected.
    Checked: a 32-bit Unity 5 game that showed "Failed to initialize graphics" runs (~220 frames a second); another 32-bit Unity 5 game that ran before still runs (Direct3D 11 feature level 11.1 through DXMT).
  • .NET Framework programs run. Tessera turned off Wine's .NET support (mscoree), so every .NET program, for example a game launcher written with Windows Forms, exited at once (exit code 53). The runtime now carries Wine Mono 10.4.1, the version this Wine asks for, where Wine looks for it, so .NET programs run and Wine never offers to download anything.
    Checked: a Windows Forms game launcher opens and starts its game; new Windows folders are created without any prompt.
  • Games whose Mac version can no longer run can play their Windows version. Steam installs a game's Mac version whenever one exists, and Tessera's default only covers games without one. Many older Mac versions are 32-bit programs, which macOS 10.15 and later refuse ("32-bit applications are no longer supported"). The Tessera app now lists installed games whose Mac programs are all 32-bit under Mac versions that can't run; Play the Windows Version quits Steam, sets Tessera for that one game and opens Steam again, which then downloads the Windows version in place of the Mac one.
    Checked: a game with a 32-bit Mac version switched to its Windows version (Steam downloaded 0.9 GB) and runs through Tessera; the check recognises 32-bit, 64-bit, Apple-silicon and universal programs correctly.
  • Vulkan games no longer go black on a desktop or display mode bigger than the screen. MoltenVK reports every frame as "suboptimal" when a swapchain's size differs from its window's layer in screen pixels, which is always the case on an emulated desktop larger than the screen; games then recreate the swapchain endlessly. Wine has a cure, swapchains created as deliberately scaled, but it never applied: the needed host extension (VK_EXT_surface_maintenance1) was enabled only if a flag was set that Wine clears one line earlier. Tessera's Wine now enables it before the flag is cleared and creates every swapchain as deliberately scaled (the game's own swapchain settings are kept); whether a swapchain still fits its window stays Wine's own check.
    Checked: a Godot 4 Vulkan game at 3456 × 2234: main menu at 120 frames a second with 5 swapchain creations, where it showed a black window with over a million; a Direct3D 9 game drawn through Vulkan and a Direct3D 11 game through D3DMetal are unchanged.
  • The full-resolution desktop only where it is needed. 1.2.6 started every game on the screen's full-size desktop because D3DMetal's resolution list stops at the desktop size. Chromium-based games (RPG Maker MV/MZ) then drew their page magnified and cut off, and older games' windows looked small. Tessera now reads the game's program: the full-size desktop is used for Unity games and 64-bit programs that link or delay-load DXGI or Direct3D 10–12, or load their renderer later (an Unreal start program); a 32-bit or .NET launcher gets it when its game folder holds such a 64-bit game. 32-bit programs (D3DMetal is 64-bit only), programs drawing through Direct3D 8/9, OpenGL or Vulkan, Chromium-based games and games on DXMT or WineD3D keep the Mac desktop size, where their resolution menus list every size anyway.
    Checked: an RPG Maker MV game draws its whole title screen again; a 32-bit Direct3D 9 game opens a normal-size window; Unity and Unreal games on D3DMetal still open at 3456 × 2234; an OpenGL test program draws correctly on both desktops.
  • Steam's install-script runner no longer decides a game's desktop size. Steam runs its install-script program in the game's Windows folder right before each start, and the game then joined that program's Wine session, with the desktop size chosen for the script program: a 32-bit game's launcher opened half off the screen. Steam's helper programs now use the size Tessera chose for the game, and a lingering helper session with the other size is ended before the game starts.
    Checked: the launcher opens centred, the game starts full screen.
  • More first-start installers run quietly. Steam install scripts that start an installer without switches leave its window waiting for a click, and the game never starts. Quiet switches are now added for Visual C++ 2015–2022 (VC_redist), OpenAL and the legacy PhysX system software, next to the earlier Visual C++ 2005–2013 and DirectX setup.

Known issues

  • The first time a game syncs after this update, Steam may report a conflict if another computer uploaded saves while the Mac could not sync. Keep the copy you want, usually the newer one on this 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.
  • Games that check for old OpenGL extension names (id Tech 5: Wolfenstein: The Old Blood) stop at start: macOS offers OpenGL 3.2 and later only as core profiles, which do not list those extensions.
  • Some .NET launchers rely on behaviour where Wine Mono differs from Microsoft's .NET Framework; Assetto Corsa's own launcher stops with an error (the game itself runs).
  • A game's window was once seen opening behind Steam's window after the game's own message box (BERSERK and the Band of the Hawk); Mission Control brings it forward.

Updating

Download Tessera-1.2.7.dmg, replace Tessera in Applications and open it once. It updates its files in Steam by itself; then click Repair once to finish the update.

Sources

tessera-runtime-src-1.2.7.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. The DXVK and MoltenVK sources and the script that builds them are included too. Wine Mono 10.4.1 is included unchanged; its source is wine-mono-10.4.1-src.tar.xz.

...

Read more

Tessera 1.2.6

Choose a tag to compare

@pol1ermo pol1ermo released this 19 Nov 22:36

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.

Tessera 1.2.5

Choose a tag to compare

@pol1ermo pol1ermo released this 19 Nov 15:09

Tessera 1.2.5 — bug fixes: games can offer every resolution the screen supports, and running setup again no longer makes macOS ask for Steam's permissions again.

Fixes

  • Resolutions up to the screen's full size. Tessera emulates display-mode changes, so a game switching resolution doesn't change your Mac's screen; the picture is scaled instead. The emulated list stopped at the Mac's desktop size. macOS runs the desktop in a scaled mode, for example "looks like" 2056 × 1329 on a 3456 × 2234 panel, so resolutions above it were missing (2560 × 1440, 2560 × 1600, 3200 × 1800, the panel's own 3456 × 2234).

    • Every game: the list now goes up to the largest mode the display really has.
    • Optional, per game: DXGI, which modern DirectX games use for their resolution menu (D3DMetal included), still lists only sizes up to the desktop. A new setting, "Resolutions up to …" in the game's Graphics settings in Tessera, makes that game's desktop the screen's full size, so its menu lists every size up to it. Bigger sizes are sharper but more work for the GPU, and small windows such as launchers look smaller. Switching it off returns the game to the Mac desktop size.

    Checked:

    • The Windows mode list (EnumDisplaySettings) and the DXGI list, with the setting off, on and off again.
    • A D3D11 program switching to 3456 × 2234 fills the whole screen with edges and centre in place, and mouse positions map to the new size (screen centre = 1728, 1116). The desktop returns to its size afterwards.
  • Setup keeps Steam's signature when nothing needs to change. Setup rewrote Steam.app's Info.plist and re-signed Steam.app every time, even when it was already set up. Each ad-hoc signature is new, so macOS treated Steam as a different app and asked again for permissions such as the microphone, and games with voice chat waited for an answer. Setup now leaves Steam.app alone when it already has Tessera's start-up entry and its signature is valid.
    Checked: running setup again on an already set-up Steam keeps Steam.app's code hash the same, the signature stays valid, and Steam starts and logs on. A first setup takes the same path as before, unchanged.

Known issues

  • 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.

Updating

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

Sources

tessera-runtime-src-1.2.5.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.5.tar.xz next to this release.

Tessera 1.2.4

Choose a tag to compare

@pol1ermo pol1ermo released this 19 Nov 14:46

Tessera 1.2.4 — bug fixes: DirectMusic no longer freezes games, and first-start installers run without clicks.

Fixes

  • DirectMusic could freeze a game before its first frame. Some games create their own DirectSound buffer, without position notifications, and hand it to DirectMusic (IDirectMusicPort::SetDirectSound). Wine's software synthesizer then waited forever for a notification, twice over:

    • while playing, for room in the buffer;
    • when the game switched the port off, for the buffer to finish playing. The game's main thread waits for that, so it hung on a black screen.

    Microsoft's DirectMusic checks the buffer's play position instead. Tessera's Wine now does the same when notifications are missing, and stops waiting when the buffer isn't playing.
    Checked with a DirectMusic test of both setups:

    • DirectMusic's own buffer: unchanged.
    • A game's buffer without notifications: was a permanent hang; now plays and switches off in 0.25 s.

    A Direct3D 7 game from 2000 that uses this setup now starts; before, it stayed black.

  • First-start installers no longer wait for clicks. Steam's install scripts for older games start Microsoft's DirectX setup (DXSETUP) and the Visual C++ installers without switches, so a setup wizard and a licence window waited for clicks. Where a script gives no switches, Tessera now adds the standard silent ones (/silent for DirectX, /q for Visual C++).
    DirectX setup's silent mode used to fail under Wine with internal error −9. Wine's System Restore stub (SRSetRestorePoint) reported failure together with a success status, a combination Windows never returns. It now answers like Windows does when System Restore is off.
    Checked:

    • A full first start through Steam: Visual C++ 2005 SP1 and the DirectX 9 components installed with only a short progress window, then the game started.
    • DirectX setup on its own: exit 0, with Microsoft's DirectX DLLs installed.

Known issues

  • 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.4.dmg, replace Tessera in Applications and open it once: it updates its files in Steam by itself.

Sources

tessera-runtime-src-1.2.4.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.4.tar.xz next to this release.

Tessera 1.2.3

Choose a tag to compare

@pol1ermo pol1ermo released this 19 Nov 14:28

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.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.3.tar.xz next to this release.