Warning: Undefined array key "translationlc" in /usr/www/users/fabook/_diggets/doc/v2/lib/plugins/translation/action.php on line 237
Warning: Cannot modify header information - headers already sent by (output started at /usr/www/users/fabook/_diggets/doc/v2/lib/plugins/translation/action.php:237) in /usr/www/users/fabook/_diggets/doc/v2/inc/Action/Export.php on line 104
Warning: Cannot modify header information - headers already sent by (output started at /usr/www/users/fabook/_diggets/doc/v2/lib/plugins/translation/action.php:237) in /usr/www/users/fabook/_diggets/doc/v2/inc/Action/Export.php on line 104
Warning: Cannot modify header information - headers already sent by (output started at /usr/www/users/fabook/_diggets/doc/v2/lib/plugins/translation/action.php:237) in /usr/www/users/fabook/_diggets/doc/v2/inc/Action/Export.php on line 104
====== Installation ======
We offer various ways to install Gorilla3D Addon Framework for Delphi.
You can use the embedded GetIt Package Manager inside of your IDE, our installer tool or install the packages manually.
- GetIt Package Manager
- Installer-Tool
- Manual Installation
- Delphi 10.3.0 - Delphi 11.2+
- Delphi 10.1.1 - 10.2.3
===== GetIt Package Manager =====
Embarcadero integrated Gorilla3D inside the IDE GetIt-Package-Manager for an easy installation process.
- Simply open up the GetIt-Package Manager dialog under: Tools > GetIt-Package-Manager
- Search for "Gorilla3D" in the top right search edit
- Select the item and click on "Install" to start the process
{{:1.0.0:g3d-ide-getit.jpg?nolink|}}
GetIt will do all the work for you including download, installation, configuration and the IDE restart afterwards.
__**Notice:**__ GetIt-Package-Manager can only be used for Developer-Edition installation. If you bought a commercial license please use our Installer-Tool
or the manual installation.
__**Notice:**__ Due to delays in version rollout, the version in GetIt will not always be the latest package. If you're looking for the newest version, we recommend our Installer-Tool.
===== Installer Tool =====
Gorilla Software provides an easy-to-use installer tool doing all the work for you to download, install and configure the packages in the IDE for you.
The tool is able to manage Developer-Edition downloads or Commercial-Edition downloads with your individual credentials.
Download the Zip-Archive, extract it and run the "Gorilla3DInstaller.exe".
[[https://www.gorilla3d.de/download/Gorilla3DInstaller.zip|Download Installer for Windows]]
**WARNING**: Previously manually installed packages have to be uninstalled before running the installer.
Otherwise path settings may be conflicting.
{{:1.0.0:g3d-installer-1.jpg?nolink&600|}}{{:1.0.0:g3d-installer-2.jpg?nolink&600|}}
Select the desired IDE version you want a package to install for.
Click "Install" to start the process.
The application will download, extract and configure everything for you.
===== Manual Installation =====
To install Gorilla3D packages correctly you have to follow the instructions.
==== Download ====
You can download the latest Developer-Edition packages for your specific Delphi DX version at [[https://gorilla3d.de/files/]]
Go to the "packages" folder, choose your Delphi IDE version and download the highest version.
Latest Package for Community Edition: [[https://gorilla3d.de/files/packages/10.4.2/Gorilla3D_Delphi_C%2B%2B_10.4.2_1.0.0.2573.zip|https://gorilla3d.de/files/packages/10.4.2/Gorilla3D_Delphi_C%2B%2B_10.4.2_1.0.0.2573.zip]]
**The Developer-Edition is free for development purposes and max. 5 developers. When releasing your project you need to purchase a commercial license!**
The free developer-edition contains the same features like the commercial version, it additionally contains multiple visual and hardcoded watermarks.
==== Unpack and Install ====
Unpack the downloaded zip-archive anywhere ().
Inside the Delphi IDE go to:
* Menu: **Components > Install packages**
* Move to directory: "\Win32\Release"
* Select the package files for installation:
* "Gorilla3D_Delphi_10_4_2_Sydney.bpl"
* "Gorilla3D_DesignTime_10_4_2.bpl"
* Click "Open"
{{ ::g3d-pckg-install.jpg?nolink&600 |}}
==== Configure ====
After packages were added, we need to configure compiled source-code (DCU) paths.
Because the IDE has changed over the years, some configurations have been moved.
=== Delphi 10.3.0 - Delphi 11.2+ ===
To insert DCU's go to:
- Menu: **Tools > Options > Language > Delphi-Options > Library**
- Select "Windows 32-Bit" platform on top
- Go to "**Library-Path**" input field and add the "**\Win32\Release\**"
- Repeat this analog for "Windows 64-Bit" and "Android" platforms
{{ ::g3d-dcu-install.jpg?nolink&600 |}}
=== Delphi 10.1.1 - 10.2.3 ===
To insert DCU's go to:
- Menu: **Tools > Options > Environmentoptions > Delphi-Options > Library**
- Select "Windows 32-Bit" platform on top
- Go to "**Library-Path**" input field and add the "**\Win32\Release\**"
- Repeat this analog for "Windows 64-Bit" and "Android" platforms
{{:1.0.0:g3d-ide-10.1.1.jpg?nolink|}}
==== Libraries ====
By manual installation we need to take care of a few DLL files.
The IDE should be able to find those files at DesignTime, because while working in Delphi, the current directory is the IDE binary folder and **not your project folder**:
f.e. "C:\Program Files (x86)\Embarcadero\Studio\21.0\bin\"
- Copy FMOD (audio library) DLL to BDS directory
* "**\lib\fmod\windows\fmodL.dll**" to "**C:\Program Files (x86)\Embarcadero\Studio\21.0\bin\**"
- Copy OpenSSL DLL files to BDS directory or ensure the system is able to find them automatically by environment variables
* OpenSSL is needed by the embedded AssetsStore to download prefabs from web
* "**libeay32.dll**" and "**ssleay32.dll**" to "**C:\Program Files (x86)\Embarcadero\Studio\21.0\bin\**"
* You can download OpenSSL at: [[https://www.openssl.org/source/|https://www.openssl.org/source/]]
__**Notice:**__ Take care of the IDE version used in the path. For community edition it is "21.0" for the latest Delphi IDE 11.2 it would be "22.0"!
==== Restart ====
After all steps were completed, you should restart the IDE.
__Remark:__ Using Gorilla3D package in you project will force the IDE to use OpenGL instead of DirectX.
**You can now start and enjoy the framework!**