diff --git a/docs/modding/linux/tools_on_linux.md b/docs/modding/linux/tools_on_linux.md index 7b856f1c..4c604aed 100644 --- a/docs/modding/linux/tools_on_linux.md +++ b/docs/modding/linux/tools_on_linux.md @@ -50,13 +50,9 @@ Tools such as Hammer, HLMV and Faceposer can be run trivially using wine. Typica For Hammer: ```sh -wine bin/win64/hammer.exe -winecompat +wine bin/win64/hammer.exe ``` ->[!NOTE] -> `-winecompat` is completely optional for Hammer. It simply enables the Qt file browser dialog instead of using the native one provided by wine. -> This flag does nothing in HLMV and Faceposer, as those tools have no Qt integration. - Faceposer and HLMV both require the `-game` parameter to tell it which game to use. If running from the root of the game directory: ```sh wine bin/win64/hlmv.exe -game p2ce @@ -101,3 +97,12 @@ If you're still having issues, verify that `~/.steam/steam/steamapps/libraryfold You can adjust the default DPI of the applications using `winecfg`. Run `winecfg` in a terminal, navigate to "Graphics" and adjust the DPI as desired under the "Screen resolution" section. + +### Hammer performs terribly! + +This is a side effect of how the 2D viewports are rendered, when larger portions of the map are visible in the 2D viewports, Hammer will degrade in performance. + +If you're using Wine 11 you can disable winecompat by either removing `-winecompat` for Portal: Revolution or enabling `-nowinerenderfix` for P2:CE and Momentum Mod, which will resolve performance issues. However, this will introduce a single frame delay in your interactions in the viewports. +Forcing Wine to use Wayland as opposed to X11 can fix that issue, however the model browser won't work. + +If any of those are undesirable, one can simply resort to minimizing the amount drawn in the viewports by either zooming in or shifting the views away from the map. Disabling model rendering in the 2D viewports can also help improve performance a little as well. diff --git a/docs/modding/overview/launchoptions.md b/docs/modding/overview/launchoptions.md index 77eb9370..bc08bf8b 100644 --- a/docs/modding/overview/launchoptions.md +++ b/docs/modding/overview/launchoptions.md @@ -38,6 +38,7 @@ The following options are only available on Linux currently. # Hammer Options -| Option | Description | -| ----------- | ----------------------------------------------------------- | -| -winecompat | Enables the Qt file dialog in Hammer (on Linux) | +| Option | Description | +| ---------------- | ------------------------------------------------------------------------------------------------------------------- | +| -winecompat | Enables the Qt file dialog in Hammer and fixes 2D viewports in Wine 10 and below (on Linux) (Deprecated) | +| -nowinerenderfix | Disables the 2D viewport fixes (on Linux) |