Difference between revisions of "Wrappers"

From Emulation General Wiki
Jump to navigation Jump to search
(2000's and later APIs)
(rewrote the lead and comparisons just enough to fix the existing problems for now)
Line 1: Line 1:
 
{{WIP}}
 
{{WIP}}
A '''wrapper''' is a common name for a [[Compatibility layers|compatibility/translation layer]] that translates from one ''graphics API'' to another. This can be used to run software on systems they were not designed for. Such as running old PC games made for 3Dfx Glide graphics card on modern Windows 10 systems, or running modern Windows-only DirectX 11 games on Linux.
+
A '''wrapper''' is a common name for a technology used to transparently replace calls made to one graphics API with calls made to another. This can be used to run software on systems they were not designed for, such as running old PC games made for 3Dfx Glide graphics card on modern Windows 10 systems, or running modern Windows-only DirectX 11 games on Linux. A wrapper often takes the form of a shared library that replaces the original, though it can also be a standalone interceptor. Wrappers aren't needed for OpenGL since its APIs don't require much translation. Despite this, [https://www.collabora.com/news-and-blog/blog/2018/10/31/introducing-zink-opengl-implementation-vulkan/ a wrapper was created for it anyway].
  
 
==90's APIs==
 
==90's APIs==
Line 66: Line 66:
 
===Comparisons===
 
===Comparisons===
 
;[http://www.zeus-software.com/downloads/nglide nGlide]  
 
;[http://www.zeus-software.com/downloads/nglide nGlide]  
A closed-source 3Dfx Voodoo Glide wrapper. It allows you to play games designed for 3Dfx Glide API without the need for having 3Dfx Voodoo graphics card. All three API versions are supported, Glide 2.11, Glide 2.60 and Glide 3.10. nGlide emulates Glide environment with Direct3D 9 and version 2.0 implemented Vulkan support, which also makes it work under Linux using [[Wine]] Staging 2.10.0 or newer.<ref name="nglidevulkan">http://www.zeus-software.com/forum/viewtopic.php?f=2&t=2044</ref> Glide wrapper also supports high resolution modes. This is currently the best Glide wrapper. Has a [http://www.zeus-software.com/downloads/nglide/compatibility compatibility list].
+
Currently the best Glide wrapper, but it's closed-source. All three public API versions are supported; 2.11, 2.60 and 3.10, and it reads them using Direct3D 9. Vulkan output was added in 2.0, which allows it to work under Linux using [[Wine]] 2.10.0 and newer.<ref name="nglidevulkan">http://www.zeus-software.com/forum/viewtopic.php?f=2&t=2044</ref> nGlide also supports high resolution modes. See the [http://www.zeus-software.com/downloads/nglide/compatibility compatibility list].
  
 
;[http://dege.freeweb.hu/ dgVoodoo 2]
 
;[http://dege.freeweb.hu/ dgVoodoo 2]
A closed-source wrapper for old graphics API's for Windows. The API's it currently can wrap are: Glide 2.11, Glide 2.45, Glide 3.1, Glide 3.1 Napalm, DirectX 1-7 (all versions of DirectDraw and Direct3D up to version 7), Direct3D 8.1 and Direct3D 9. This wrapper can use Direct3D 11 with different device types as wrapping output such as hardware or software rendering.
+
Despite the name, dgVoodoo 2 reimplements more than Glide. It replaces multiple APIs; Glide 2.11, 2.45, 3.1, 3.1 Napalm, all versions of DirectDraw and Direct3D up to version 7, Direct3D 8.1, and Direct3D 9. This wrapper outputs Direct3D 11 with different device types as wrapping output such as hardware or software rendering.
  
 
;[[Wine]]
 
;[[Wine]]
Wine works mostly well for running older DirectX games. It is possible to use Wine's wrapper in Windows using different forks.
+
A compatibility layer for Linux. On its own, Wine works pretty well for running older DirectX games. Some forks allow Wine's built-in reimplementations to run under Windows.
  
 
;[https://www.dxgl.org/ DXGL]  
 
;[https://www.dxgl.org/ DXGL]  
A free replacement for the Windows ddraw.dll library, running on OpenGL. It is designed to overcome driver bugs, particularly in Windows Vista and newer operating systems. It also adds various enhancements to the graphics output such as display scaling and filtering options. DXGL supports the DirectX 7.0 graphics APIs, however it is currently under development and does not work with many programs.
+
A free replacement for ddraw.dll outputting OpenGL. It's designed to overcome driver bugs, mainly in Windows Vista and beyond. It adds various rendering enhancements such as display scaling and filtering options. DXGL also supports Direct3D 7, however it's currently under development and doesn't work with many programs.
  
 
==2000's and later APIs==
 
==2000's and later APIs==
Line 162: Line 162:
 
===Comparisons===
 
===Comparisons===
 
;[https://github.com/doitsujin/dxvk DXVK]  
 
;[https://github.com/doitsujin/dxvk DXVK]  
A Vulkan-based translation layer for Direct3D 9-11, which allows running Windows 3D applications on Linux using [[Proton]] or [[Wine]].
+
A wrapper for Direct3D 9-11. DXVK was designed to speed up support for Direct3D 11 games in [[Wine]] and, later, [[Proton]] since a native implementation seemed unlikely.
  
 
:;[https://github.com/Joshua-Ashton/d9vk D9VK]  
 
:;[https://github.com/Joshua-Ashton/d9vk D9VK]  
:is a  Direct3D 9 to Vulkan translation layer based off DXVK's codebase. Has been merged into DXVK as of version 1.5.
+
:A fork for Direct3D 9, originally created when DXVK was designed for Direct3D 10 and 11. Was merged back into the main project in version 1.5.  
  
 
;[[Wine]]  
 
;[[Wine]]  
Has an internal graphics API wrapper for Direct3D 1-11 using OpenGL. It works mostly well for older games, but is slower and has more bugs than newer wrappers using Vulkan, such as DXVK. It is possible to use Wine's wrapper in Windows using different forks.
+
Has an internal graphics API wrapper for Direct3D 1-11 using OpenGL. It works mostly well for older games, but is slower and has more bugs than newer wrappers using Vulkan, such as DXVK. It's possible to use Wine's wrapper in Windows using different forks.
  
 
;[https://github.com/iXit/wine-nine-standalone Gallium Nine]
 
;[https://github.com/iXit/wine-nine-standalone Gallium Nine]
Gallium nine is an open-source implementation of DirectX 9. Gallium Nine makes it possible to run Direct3D 9 applications on Linux natively, i.e. without any calls translation which allows for a near native speed. It's only available if you are using a Gallium based graphics driver. Currently it's recommended for AMD and Intel cards, but not for nVidia cards.
+
An open-source implementation of the Direct3D 9 library. Gallium Nine is different since it uses calls native to Linux as opposed to another graphics API like Vulkan. This allows applications to run at near-native speeds. The catch is that it relies on Gallium, Linux's open source 3D renderer, and any driver that doesn't use Gallium is less likely to work (such as NVIDIA's proprietary drivers).
  
 
;[https://source.winehq.org/git/vkd3d.git/ vkd3d]  
 
;[https://source.winehq.org/git/vkd3d.git/ vkd3d]  
is an internal Wine wrapper for Direct3D 12 to Vulkan translation. Sponsored by Valve. Currently a work in progress.
+
A work-in-progress Direct3D 12 to Vulkan wrapper created for Wine by Valve.
  
 
;[https://github.com/disks86/VK9 VK9]  
 
;[https://github.com/disks86/VK9 VK9]  
runs Direct3D 9 applications on Windows or Linux (with [[Wine]]) over Vulkan.
+
A Direct3D 9 wrapper that outputs to Vulkan.
  
 
==External links==
 
==External links==
[https://www.gamingonlinux.com/articles/dxvk-102-is-out-with-some-bug-fixes-d9vk-seems-to-be-progressing-nicely.13868/comment_id=151939 State of Direct3D 9-12 translation layers] by DXVK author YoRHa-2B (2019-04-02)
+
* [https://www.gamingonlinux.com/articles/dxvk-102-is-out-with-some-bug-fixes-d9vk-seems-to-be-progressing-nicely.13868/page=2#r151939 State of Direct3D 9-12 translation layers] by DXVK author YoRHa-2B (2019-04-02)
  
 
==References==
 
==References==
 
{{Reflist}}
 
{{Reflist}}

Revision as of 15:08, 19 December 2019

A wrapper is a common name for a technology used to transparently replace calls made to one graphics API with calls made to another. This can be used to run software on systems they were not designed for, such as running old PC games made for 3Dfx Glide graphics card on modern Windows 10 systems, or running modern Windows-only DirectX 11 games on Linux. A wrapper often takes the form of a shared library that replaces the original, though it can also be a standalone interceptor. Wrappers aren't needed for OpenGL since its APIs don't require much translation. Despite this, a wrapper was created for it anyway.

90's APIs

Name Operating System(s) Latest Version Translates Into Active Recommended
nGlide Windows 2.10 Glide Vulkan, Direct3D 9
dgVoodoo 2 Windows 2.62.3 Glide, DirectX 1-9 Direct3D 11
Wine DirectX Windows, Linux, macOS 9.0 (Linux, macOS)
9.7 Windows
DirectX 1-11 OpenGL
DXGL Windows 0.5.17 DirectX 1-7 OpenGL WIP
Glidos Windows 1.53b Glide (DOS) ? ?
OpenGlide Windows 0.09 Alpha Glide OpenGL ?
psVoodoo Windows 0.13 Glide Direct3D 9 ?

Comparisons

nGlide

Currently the best Glide wrapper, but it's closed-source. All three public API versions are supported; 2.11, 2.60 and 3.10, and it reads them using Direct3D 9. Vulkan output was added in 2.0, which allows it to work under Linux using Wine 2.10.0 and newer.[1] nGlide also supports high resolution modes. See the compatibility list.

dgVoodoo 2

Despite the name, dgVoodoo 2 reimplements more than Glide. It replaces multiple APIs; Glide 2.11, 2.45, 3.1, 3.1 Napalm, all versions of DirectDraw and Direct3D up to version 7, Direct3D 8.1, and Direct3D 9. This wrapper outputs Direct3D 11 with different device types as wrapping output such as hardware or software rendering.

Wine

A compatibility layer for Linux. On its own, Wine works pretty well for running older DirectX games. Some forks allow Wine's built-in reimplementations to run under Windows.

DXGL

A free replacement for ddraw.dll outputting OpenGL. It's designed to overcome driver bugs, mainly in Windows Vista and beyond. It adds various rendering enhancements such as display scaling and filtering options. DXGL also supports Direct3D 7, however it's currently under development and doesn't work with many programs.

2000's and later APIs

Name Operating System(s) Latest Version Translates Into Active Recommended
DXVK Linux 1.5 Direct3D 9-11 Vulkan
Wine Direct3D Windows, Linux, macOS 9.0 (Linux, macOS)
9.7 Windows
Direct3D 1-11 OpenGL
Gallium Nine Linux 0.5 Direct3D 9 Native ~ WIP
vkd3d Linux 1.1 Direct3D 12 Vulkan WIP
MoltenVK macOS, iOS 1.0.39 Vulkan Metal ?
Zink Linux Git OpenGL Vulkan ?
D9VK Linux Git Direct3D 9 Vulkan
d3d8to9 Windows 1.10.0 Direct3D 8 Direct3D 9
DXUP Windows, Linux Git Direct3D 9-10 Direct3D 11
VK9 Windows, Linux 0.29.0 Direct3D 9 Vulkan

Comparisons

DXVK

A wrapper for Direct3D 9-11. DXVK was designed to speed up support for Direct3D 11 games in Wine and, later, Proton since a native implementation seemed unlikely.

D9VK
A fork for Direct3D 9, originally created when DXVK was designed for Direct3D 10 and 11. Was merged back into the main project in version 1.5.
Wine

Has an internal graphics API wrapper for Direct3D 1-11 using OpenGL. It works mostly well for older games, but is slower and has more bugs than newer wrappers using Vulkan, such as DXVK. It's possible to use Wine's wrapper in Windows using different forks.

Gallium Nine

An open-source implementation of the Direct3D 9 library. Gallium Nine is different since it uses calls native to Linux as opposed to another graphics API like Vulkan. This allows applications to run at near-native speeds. The catch is that it relies on Gallium, Linux's open source 3D renderer, and any driver that doesn't use Gallium is less likely to work (such as NVIDIA's proprietary drivers).

vkd3d

A work-in-progress Direct3D 12 to Vulkan wrapper created for Wine by Valve.

VK9

A Direct3D 9 wrapper that outputs to Vulkan.

External links

References