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.dllare 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/bin64folder. Copy the relevant DLL (FMOD, JOLT, WebView2) intoC:\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.