Windows (x86 / x64)

Windows is the primary development and deployment target for Gorilla3D. Both 32-Bit (Win32) and 64-Bit (Win64) builds are fully supported and receive the most extensive testing of all platforms.

Gorilla3D ships two graphics backends on Windows:

  • OpenGL (default) — supported on Win32 and Win64
  • Vulkan — supported on Win64 (experimental, opt-in)

When the Gorilla3D package is added to a project, the IDE is automatically forced to use the OpenGL renderer instead of DirectX in the FireMonkey designer. This is required for the framework's render passes and shaders to work consistently between design-time and run-time.

System Requirements

Component Minimum Recommended
Operating System Windows 10 Windows 10 / 11
Graphics API OpenGL 4.3 OpenGL 4.6 (2017+) or Vulkan 1.2
GPU OpenGL 4.3 capable, dedicated VRAM Dedicated GPU with up-to-date driver
CPU x86 (Win32) or x64 (Win64) x64 multi-core
Delphi IDE 10.1 Berlin 12 Athens / 13 Florence

For a list of GPUs that have been verified by us, see System Requirements.

Selecting the Graphics API

By default Gorilla3D initializes the OpenGL context. To switch to Vulkan (Win64 only), set the renderer before any TGorillaViewport is created — typically in the project source (.dpr) before Application.Initialize:

uses
  System.StartUpCopy,
  Gorilla.Context.Backend, // first unit!
  FMX.Forms, ...;

begin
{$IF Defined(MSWINDOWS) AND Defined(CPUX64)}
  // Force Vulkan as graphics backend (Win64) before Application.Initialize
  GorillaGraphicsBackend := gbVulkan;
{$ENDIF}

  Application.Initialize;
  Application.CreateForm(TForm1, Form1);
  Application.Run;
end.

If the requested API is not available on the target machine, the framework falls back to OpenGL and writes a notice to the IDE event log / runtime log.

Build & Deployment

Required runtime DLLs

Depending on the features used by your application, the following libraries must ship next to the executable (or be available on PATH):

Library x86 path x64 path Required for
libeay32.dll <install>\lib\OpenSSL\x86\ <install>\lib\OpenSSL\x64\ AssetsStore (HTTPS downloads)
ssleay32.dll <install>\lib\OpenSSL\x86\ <install>\lib\OpenSSL\x64\ AssetsStore (HTTPS downloads)
WebView2Loader.dll <install>\lib\WebView2\x86\ <install>\lib\WebView2\x64\ Sketchfab plugin login
fmodL.dll <install>\lib\fmod\windows\ - FMOD audio (Win32)
fmodL64.dll - <install>\lib\fmod\windows\ FMOD audio (Win64)
Jolt32.dll <install>\lib\Jolt\Windows\x86\ - JOLT physics (Win32)
Jolt64.dll - <install>\lib\Jolt\Windows\x64\ JOLT physics (Win64)

Add these files via Project > Deployment so they are copied into the build output, or use the IDE deployment target Local Folder during development.

Mayo file import & SketchUp

  • Mayo / OpenCascade based file importers are available at runtime on Windows only (both x86 and x64).
  • SketchUp (.skp) import is only supported on Win64 at runtime.

Verified Feature Matrix

The following matrix lists features that have been explicitly tested on Windows for the current release. Legend:

  • ✅ working
  • ❓ partially / not yet verified
  • ❌ not working / known issue

OpenGL (Win32 + Win64)

Feature OpenGL Win32/Win64
FMX Primitives ✅
FMX MaterialSources ✅
Gorilla3D Primitives ✅
Gorilla3D Model ✅
Gorilla3D Model — STATIC ✅
Gorilla3D Model — Uncached Animations ✅
Gorilla3D Model — Cached Animations ✅
Gorilla3D Model — Instancing ✅
Texture formats other than BGRA ✅
Default Materials (Lambert, Phong, BlinnPhong) ✅
Sharing a G3D material with multiple objects ✅
Cross-Material (FMX ↔ G3D) test ✅
Pure Color material (no texture) ✅
VertexColor material ✅
No-Lighting tests ✅
POM material ✅
PBR material ✅
Atlas material (nearest texture limit) ✅
SplatMap material (extensive texture mapping) ✅
Layered materials ✅
Layer3D / Layout3D ✅
TextLayer3D ✅
Material Behaviours — fragment shaders (color adjust, rim light, caustics) ✅
Material Behaviours — vertex shaders (wobble, wind) ✅
Depth render pass ✅
Blur render pass ✅
EmissiveBlur ✅
Global Illumination ✅
WBOIT rendering ✅
Composite rendering (final image of opaque + translucent) ✅
OutputLayers ✅
Skybox — Procedural ✅
Skybox — Blank ✅
Skybox — CubeMap ✅
Reflection render pass ✅
Refraction render pass ✅
Environment mapping ✅
MSAA ✅
FXAA ✅
PostFX (with concat) ✅
User shader via VertexShader / SurfaceShader properties ✅
Water surface material ✅
Particle system — untextured ✅
Particle system — textured (smoke emitter) ✅
Volume rendering ✅

OpenGL on Windows is the reference implementation — every Gorilla3D feature is verified here.

Vulkan (Win64)

Vulkan support on Win64 is feature-rich but still considered experimental. Most rendering features pass parity tests with OpenGL; a few are still in evaluation or known not to work yet.

Feature Vulkan Win64 Notes
FMX Primitives / MaterialSources ✅
Gorilla3D Primitives / Model / Animations / Instancing ✅
Texture formats other than BGRA ✅
Default / Color / VertexColor / No-Lighting / POM / PBR materials ✅
Atlas / SplatMap material ✅
Layered materials ❓ Not yet fully verified
Layer3D / Layout3D / TextLayer3D ❓ Not yet fully verified
Material Behaviours — fragment & vertex shaders ✅
Depth / Blur / EmissiveBlur ✅
Global Illumination ❌ Not implemented for Vulkan yet
WBOIT / Composite / OutputLayers ✅
Skybox (Procedural / Blank / CubeMap) ✅
Reflection / Refraction render pass ✅
Environment mapping ❓ Not yet fully verified
MSAA / FXAA / PostFX (concat) ✅
User shaders ✅
Water surface material ✅
Particle system — untextured / textured ✅
Volume rendering ❌ Not implemented for Vulkan yet

Use OpenGL if you depend on Global Illumination or Volume Rendering. Vulkan is a good choice for deterministic frame timing and lower CPU overhead on modern GPUs.

Troubleshooting

  • Black viewport / "OpenGL 4.3 not available" — install the latest GPU driver from the vendor (NVIDIA / AMD / Intel). The driver shipped with Windows Update is often outdated.
  • Vulkan validation errors — make sure the Vulkan Runtime is installed (it ships with current GPU drivers); otherwise fetch it from the LunarG SDK.
  • AssetsStore download fails — libeay32.dll / ssleay32.dll are missing or the system's OpenSSL version does not match the Indy build used by Delphi. Copy the DLLs from the Gorilla3D package as described above.
  • DLL not found at design time — the IDE looks for DLLs in its bin / bin64 folder. Copy the relevant DLL (FMOD, JOLT, WebView2) into C:\Program Files (x86)\Embarcadero\Studio\<ver>\bin[64]\.
  • Mismatched Win32 / Win64 DLLs — make sure the bitness of the DLL matches the active platform target. A Win64 project will silently fail to load Jolt32.dll.

Next Steps