freebsd-ports/emulators/wine
Gerald Pfeifer d57dd6618f Update from Wine 4.0.3 and the Wine 4.0 release series to Wine 5.0.
This represents a year of development effort with over 7,400 individual
changes.  This port and the wine-devel port have been in sync as closely
as possible, and this update is mostly copying over from the -devel port
minus support for the Wine Staging patchset (and STAGING option).

Highlights of this new release include built-in modules in PE format,
multi-monitor support, Vulkan 1.1 support, and an XAudio2 reimplementation.

This also comes with updates of the emulators/wine-gecko and
emulators/wine-mono ports to match their -devel counterparts:
version 2.47.1 for wine-gecko and version 4.9.4 for wine-mono.

And we "lose" four local patches that got integrated or became obsolete
upstream.

The following is a more detailed list extracted from the extensive
release notes:

== Graphics

- Multiple display adapters and monitors are properly supported, including
  dynamic configuration changes.
- The Vulkan driver supports up to version 1.1.126 of the Vulkan spec.
- The WindowsCodecs library is able to convert more bitmap formats,
  including palette-indexed formats.

== Direct3D

- Fullscreen Direct3D applications inhibit the screensaver.
- DXGI swapchain presents inform the application when the corresponding
  window is minimized. This typically allows applications to reduce CPU
  usage while minimized, and is in some cases required to allow the
  application window to be restored again.
- Switching between fullscreen and windowed modes using the standard
  Alt+Enter combination is implemented for DXGI applications.
- The following features are implemented for Direct3D 12 applications:
  - Switching between fullscreen and windowed.
  - Changing display modes.
  - Scaled presents.
  - Swap intervals.
  These features were previously already implemented for earlier
  versions of the Direct3D API.
- The handling of various edge cases is improved. Among others:
  - Out of range reference values for the alpha and stencil tests.
  - Sampling 2D resources with 3D samplers and vice versa.
  - Drawing with mapped textures and buffers.
  - Usage of invalid DirectDraw clipper objects.
  - Creating Direct3D devices on invalid Windows, like the desktop window.
  - Viewports with a minimum Z larger than or equal to the maximum Z.
  - Resources bound through both shader-resource views and render-target
    or depth-stencil views at the same time.
  - Blits between formats with and without alpha components.
  Since well-behaved applications don't rely on these edge cases, they
  typically only affect one or two applications each. There are
  nevertheless quite a number of them.
- Dirty texture regions are tracked more accurately for Direct3D 8 and 9
  texture uploads.
- Uploads of S3TC-compressed 3D textures require less address space.
  Since 3D textures can be potentially large, and address space
  exhaustion is a concern for 32-bit applications, S3TC-compressed 3D
  textures are uploaded per-slice, instead of in a single upload.
- The ID3D11Multithread interface is implemented.
- Various lighting calculation fixes and improvements for older DirectDraw
  applications have been made.
- Limited support for blits across swapchains is implemented.
- More shader reflection APIs are implemented.
- The wined3d CPU blitter can handle compressed source resources.
  Support for compressed destination resources was already implemented
  in a previous release.
- The Direct3D graphics card database recognizes more graphics cards.
- New HKEY_CURRENT_USER\Software\Wine\Direct3D registry keys:
  - "shader_backend" (REG_SZ)
    The shader backend to use. Possible values are "glsl" (default)
    for GLSL, "arb" for ARB vertex/fragment programs and "none" to
    disable shader support.
  - "strict_shader_math" (REG_DWORD)
    Enable (0x1) or disable (0x0, default) stricter translation of
    Direct3D shaders, potentially at a performance cost. This
    currently only makes a difference with the default GLSL shader
    backend in combination with the proprietary NVIDIA drivers.
- Deprecated HKEY_CURRENT_USER\Software\Wine\Direct3D registry key:
  - "UseGLSL"
    This has been superseded by the "shader_backend" setting above.

== D3DX

- Support for compressing textures using S3TC-compression.
- Various operations, like e.g. texture fills, on unmappable surfaces
  are implemented more correctly. Previously their implementation
  relied on the underlying Direct3D implementation not enforcing
  mapping restrictions.
- Various improvements and fixes have been made to the effect framework.

== Kernel

- Most of the functions that used to be in Kernel32 are moved to
  KernelBase, to follow the architecture of recent Windows versions.
- Libraries of the wrong 32/64-bitness are ignored when found in the
  search path, to enable loading the correct one if it's found further
  in the path.
- Kernel objects are better emulated for device drivers that expect to
  manipulate objects from the kernel side.
- The kernel-level synchronization objects like spin locks, fast
  mutexes, remove locks, and resource variables are implemented.
- The system battery state is properly reported to applications.

== User interface

- Minimized windows are displayed using their title bar instead of the
  old Windows 3.1-style icons.
- The new button styles Split Buttons and Command Links are implemented.
- The Edit control sets margins correctly also for CJK fonts.

== Desktop integration

- Symbolic links to the corresponding Unix directories are created for
  the 'Downloads' and 'Templates' folders.

== Input devices

- Plug & Play device drivers can be installed and loaded on startup.
- Game controllers are better supported, including proper support for
  hat switch, wheel, gas and brake controls.

== .NET

- The Mono engine is updated to version 4.9.4, including parts of the
  Windows Presentation Foundation (WPF) framework.
- The Gecko and Mono add-ons support shared installation, where the
  files are used directly from a global location under /usr/share/wine
  instead of being copied into every new prefix.

== Internet and networking

- The Gecko engine is refreshed to support recent toolchains.
- A number of new HTML APIs are implemented.
- MSHTML supports some SVG elements.
- Error object and exception propagation are supported in VBScript.
- A number of VBScript builtin functions are implemented.
- JScript EcmaScript compliant mode supports more features.
- JScript and VBScript script objects expose type info interfaces.
- The HTTP proxy configuration can be retrieved through DHCP.
- Passport HTTP redirects are supported.
- The HTTP service and corresponding client-side library (HTTPAPI) are
  partially implemented.

== Cryptography

- ECC (elliptic-curve) keys are supported when using GnuTLS.
- Importing keys and certificates from PFX blobs is implemented.
- The PBKDF2 key derivation algorithm is supported.

== Text and fonts

- OpenType positioning features are supported in DirectWrite, and
  enabled for Latin script by default, including kerning.
- Font data access is made safer by validating the various data tables
  before using them.
- DirectWrite interfaces are updated to a recent SDK, implementing
  some of the latest API additions.

== Audio / Video

- The XAudio2 libraries are reimplemented to use the external FAudio
  library, for better compatibility.
- The Media Foundation libraries are fleshed out, including:
  - Support for builtin and user async work queues.
  - Ability to submit periodic callbacks, waiting, scheduled, and
    regular work items, with support for item priority.
  - Support for media event queues.
  - Various core API to handle media type objects, stream and
    presentation descriptors, object attributes, byte stream objects,
    samples and buffers.
  - Initial Source Resolver implementation.
  - Initial implementation of Source Reader API.
  - Implementation for Sample Grabber object.
  - Core support for building topology objects.
  - Builtin presentation clock implementation, started implementing
    Media Session functionality.
- The video capture filter has been ported to use v4l2 instead of the
  deprecated v4l1 API, allowing the use of some cameras which do not
  support v4l1.
- Support for YUV to RGB translation and reading from v4l2 devices
  using mmap() has been removed; we now depend on libv4l2 for both of
  these things.
- The builtin AVI, MPEG-I, and WAVE decoders have been removed; we now
  depend on GStreamer or the Mac QuickTime Toolkit to decode such
  media files.
- Some more VMR7 configuration APIs are implemented.
- The sound drivers support per-channel volume adjustments.

== Internationalization

- Unicode character tables are based on version 12.1.0 of the standard.
- Unicode normalization is implemented.
- The geographic region id is automatically set in the registry based
  on the current locale. It can be modified if necessary under
  HKEY_CURRENT_USER\Control Panel\International\Geo.
- The Sinhalese and Asturian locales are supported.
- Codepage 28601 (Latin/Thai) is supported.

== RPC/COM

- The typelib marshaller supports complex structs and arrays.
- There is an initial implementation of the Windows Script runtime library.
- There is an initial implementation of the Microsoft ActiveX Data
  Objects (ADO) library.

== Installers

- Microsoft Installer (MSI) Patch Files are supported.
- The WUSA tool (Windows Update Standalone Installer) supports
  installing .MSU update files.

== PE modules

- The actual PE binaries are copied into the Wine prefix instead of
  the fake DLL files. This makes the prefix look more like a real
  Windows installation, at the cost of some extra disk space.
- Modules that have been converted to PE can use standard wide-char C
  functions, as well as wide-char character constants like L"abc".
  This makes the code easier to read.
- Not all modules have been converted to PE yet; this is an ongoing
  process that will continue during the Wine 5.x development series.

== Development tools / Winelib

- The Visual Studio remote debugger can be used to debug applications
  running under Wine.
- The Debug Engine library (DBGENG) is partially implemented.
- The Resource Compiler and IDL Compiler support a '--sysroot' option
  to allow locating header files in cross-compile environments.
- Winegcc supports the options '--target', '--wine-objdir',
  '--winebuild' and '-fuse-ld' that make it easier to use as a
  cross-compiler, or with custom toolchains.
- The wine/unicode.h header is no longer available to applications,
  since the functions will ultimately be removed and replaced by the
  standard C runtime wide character functions.

== Build infrastructure

- The 'fastcall' calling convention is supported in spec files. It
  uses the correct name mangling for Windows builds.
- A '-import' entry point flag is supported in spec files, to mark
  functions that need a hotpatch code prefix to be generated for their
  import thunks.
- Winebuild supports a '--builtin' option to add a special signature
  to PE binaries to mark them as Wine builtins.

== Builtin applications

- The CHCP tool is implemented. It allows setting the console codepage.
- The MSIDB tool is implemented. It allows manipulating MSI databases.

== Performance improvements

- The various time functions use higher performance system clocks if
  available, to reduce the overhead in the rendering loop of many games.
- File lookups take advantage of the ext4 filesystem case folding
  support if it's enabled on the directory being searched.
- No-data style listboxes (LBS_NODATA) have better performance for
  large numbers of items.
- Slim Reader/Writer locks, keyed events, and condition variables use
  futexes on Linux to avoid wineserver round trips.

== New external dependencies

- The FAudio library is used to implement XAudio2.
- The Inotify library is used for file change notifications on BSD
  platforms.
- The Video4Linux version 2 library is used instead of version 1.
2020-01-31 08:23:04 +00:00
..
files Update from Wine 4.0.3 and the Wine 4.0 release series to Wine 5.0. 2020-01-31 08:23:04 +00:00
distinfo Update from Wine 4.0.3 and the Wine 4.0 release series to Wine 5.0. 2020-01-31 08:23:04 +00:00
Makefile Update from Wine 4.0.3 and the Wine 4.0 release series to Wine 5.0. 2020-01-31 08:23:04 +00:00
pkg-descr Add a note how to work around Wine issuing an error message of 2019-08-10 17:48:18 +00:00
pkg-plist Update from Wine 4.0.3 and the Wine 4.0 release series to Wine 5.0. 2020-01-31 08:23:04 +00:00