<br />
<b>Warning</b>:  Undefined array key "translationlc" in <b>/usr/www/users/fabook/_diggets/doc/v2/lib/plugins/translation/action.php</b> on line <b>237</b><br />
<br />
<b>Warning</b>:  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 <b>/usr/www/users/fabook/_diggets/doc/v2/inc/Action/Export.php</b> on line <b>104</b><br />
<br />
<b>Warning</b>:  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 <b>/usr/www/users/fabook/_diggets/doc/v2/inc/Action/Export.php</b> on line <b>104</b><br />
<br />
<b>Warning</b>:  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 <b>/usr/www/users/fabook/_diggets/doc/v2/inc/Action/Export.php</b> on line <b>104</b><br />
====== 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 (<installation-directory>).

Inside the Delphi IDE go to:
  * Menu: **Components > Install packages**
  * Move to directory: "<installation-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 "**<installation-directory>\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 "**<installation-directory>\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**:

<code>
f.e. "C:\Program Files (x86)\Embarcadero\Studio\21.0\bin\"
</code>

  - Copy FMOD (audio library) DLL to BDS directory
    * "**<installation-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!**