<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en-GB">
	<id>https://wiki.gideros.rocks/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Hgy29</id>
	<title>GiderosMobile - User contributions [en-gb]</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.gideros.rocks/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Hgy29"/>
	<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php/Special:Contributions/Hgy29"/>
	<updated>2026-11-17T14:43:08Z</updated>
	<subtitle>User contributions</subtitle>
	<generator>MediaWiki 1.43.11</generator>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Compiling_Gideros_Source&amp;diff=24648</id>
		<title>Compiling Gideros Source</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Compiling_Gideros_Source&amp;diff=24648"/>
		<updated>2025-09-05T12:40:11Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* 1.4.1 Install Android Studio and NDK */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;The following instructions are for developers who want to contribute to or otherwise experiment with the Gideros C/C++ engine and are &#039;&#039;not&#039;&#039; necessary for either building or deploying apps made with Gideros.&lt;br /&gt;
&lt;br /&gt;
The Gideros project consists of the Gideros Studio IDE, the Gideros SDK libraries, Gideros Texture Packer, Gideros Font Creator, &amp;quot;players&amp;quot; or export templates for all the platforms Gideros supports, all targets of all plugins, a daemon and a bridge. The build system is flexible, so you only need the tools for the targets you are interested in deploying to with Qt (and MSYS2 on Windows) being a realistic minimum.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div class=&amp;quot;noautonum&amp;quot;&amp;gt;__TOC__&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 1. Requirements ==&lt;br /&gt;
=== 1.1 Install QT ===&lt;br /&gt;
https://www.qt.io/download-open-source/&lt;br /&gt;
&lt;br /&gt;
Recommended version 6.3 with MinGW &amp;lt;br /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Double click on the downloaded file and follow instructions. When installing, expand the tree view and ensure you have ticked the MinGW child option of the Qt version checkbox, as well as the MinGW option in the Tools section.&lt;br /&gt;
Beside main QT package, you&#039;ll need the following additional components:&lt;br /&gt;
* WebSocket additional library&lt;br /&gt;
* Multimedia additional library&lt;br /&gt;
* Qt5 Compatibility addon&lt;br /&gt;
  &lt;br /&gt;
(MAC) Move the created folder into your user account folder &lt;br /&gt;
&lt;br /&gt;
(LINUX) &lt;br /&gt;
On Debian 11:&lt;br /&gt;
echo &amp;quot;deb http://deb.debian.org/debian bullseye-backports main&amp;quot; &amp;gt;&amp;gt;/etc/apt/sources.list&lt;br /&gt;
apt update&lt;br /&gt;
apt install qt6-base-dev qt6-websockets-dev qt6-multimedia-dev qt6-5compat-dev&lt;br /&gt;
&lt;br /&gt;
Depending on your distribution, you may need to install qt5 websocket lib seperately (sudo apt-get install libqt5websockets5-dev)&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
===1.2 (PC) Install MSYS2 Console===&lt;br /&gt;
    https://msys2.github.io/ &lt;br /&gt;
&lt;br /&gt;
Double click on the downloaded file (msys2-i686) and follow instructions. &lt;br /&gt;
&lt;br /&gt;
Open 32 bit MSYS2 shell: msys2_shell.cmd&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
pacman -Sy pacman&lt;br /&gt;
pacman -Syu&lt;br /&gt;
pacman -Su&lt;br /&gt;
pacman -S tar&lt;br /&gt;
pacman -S zip&lt;br /&gt;
pacman -S unzip&lt;br /&gt;
pacman -S git&lt;br /&gt;
pacman -S base-devel&lt;br /&gt;
pacman -S python&lt;br /&gt;
#For compiling win32/32bit under a MinGW64&lt;br /&gt;
pacman -S mingw-w64-i686-toolchain&lt;br /&gt;
pacman -S mingw-w64-i686-glew&lt;br /&gt;
pacman -S mingw-w64-i686-curl&lt;br /&gt;
pacman -S mingw-w64-i686-libpng&lt;br /&gt;
#For compiling win32/64bit under a MinGW64&lt;br /&gt;
pacman -S mingw-w64-x86_64-toolchain&lt;br /&gt;
pacman -S mingw-w64-x86_64-glew&lt;br /&gt;
pacman -S mingw-w64-x86_64-curl&lt;br /&gt;
pacman -S mingw-w64-x86_64-libpng&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.3 (Mac) Install Git &amp;amp; xcpretty ===&lt;br /&gt;
    http://git-scm.com/downloads&lt;br /&gt;
    &lt;br /&gt;
Ctrl + right click, open with « Install program.app » Follow instructions keeping default values as they are. &lt;br /&gt;
&lt;br /&gt;
(MAC) open a terminal window &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
git config -global user.name &amp;quot;your git login&amp;quot; &lt;br /&gt;
git config -global user.email &amp;quot;your git email&amp;quot;&lt;br /&gt;
sudo gem install xcpretty&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
=== 1.3.1 (Linux/Debian) Install Git, build-tools ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
apt install git build-essential libxcb-xinerama0 libgl1-mesa-dev libz-dev libasound2-dev libglew-dev libglfw3-dev libcurl4-openssl-dev patchelf zip libv4l-dev&lt;br /&gt;
git config --global user.email &amp;quot;your git email&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.4 (PC) Android requirements ===&lt;br /&gt;
&lt;br /&gt;
==== 1.4.1 Install Android Studio and NDK ====&lt;br /&gt;
&lt;br /&gt;
    https://developer.android.com/studio/index.html&lt;br /&gt;
    https://developer.android.com/ndk/downloads/older_releases.html&lt;br /&gt;
&lt;br /&gt;
Recommended NDK is 28c (the x86_64 version)&lt;br /&gt;
&lt;br /&gt;
Once downloaded, copy the contents of the NDK to your home or C: folder, rename the folder that you copied to &#039;android-ndk&#039;, for example you will end up with &#039;c:\android-ndk&#039; and below that folders that say build, meta, platforms, etc.&lt;br /&gt;
&lt;br /&gt;
==== 1.4.2 Install Ant (no longer required but kept util someone confirms this)====&lt;br /&gt;
    https://ant.apache.org/&lt;br /&gt;
&lt;br /&gt;
Once downloaded, copy the contents of the install archive/zip file to your home folder or C: drive.&lt;br /&gt;
Eg: so you have a folder called c:\apache-ant-1.10.5 with bin, etc, lib, manual folders within that.&lt;br /&gt;
&lt;br /&gt;
==== 1.4.3 Mix Old and New Tools (no longer required but kept util someone confirms this) ====&lt;br /&gt;
&lt;br /&gt;
Gideros uses Ant to build the player, unfortunately the tools to support Ant are now missing from the latest Android tools.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
There is a fix for this:&lt;br /&gt;
&lt;br /&gt;
# Rename the existing &#039;tools&#039; folder in the Android SDK folder to &#039;tools_new&#039;.&lt;br /&gt;
# Download an older (March 2016) version of the tools and copy that folder to the Android SDK folder.&lt;br /&gt;
# Copy the contents of &#039;tools_new&#039; over the contents of &#039;tools&#039;.&lt;br /&gt;
&lt;br /&gt;
Here is where you can download the compatible set of tools from:&lt;br /&gt;
&lt;br /&gt;
(PC) https://dl.google.com/android/repository/tools_r25.2.5-windows.zip&lt;br /&gt;
&lt;br /&gt;
(MAC) https://dl.google.com/android/repository/tools_r25.2.5-macosx.zip&lt;br /&gt;
&lt;br /&gt;
(LINUX) https://dl.google.com/android/repository/tools_r25.2.5-linux.zip&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.5 Install Java ===&lt;br /&gt;
You need the Java JDK&lt;br /&gt;
https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.6 (PC) Install Visual Studio ===&lt;br /&gt;
    https://www.visualstudio.com/downloads/&lt;br /&gt;
&lt;br /&gt;
Install [https://developer.microsoft.com/en-us/windows/downloads/windows-8-1-sdk Win 8.1 SDK]&lt;br /&gt;
&lt;br /&gt;
Install [https://marketplace.visualstudio.com/items?itemName=AdMediator.MicrosoftAdvertisingSDKforWindowsandWindowsPhone8x Microsoft Advertising SDK for Windows and Windows Phone 8.x]&lt;br /&gt;
&lt;br /&gt;
Ensure that you have MSBuild v12 or v14 installed (building with the makefile will fail with an incorrect version).&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.7 (MAC) Install Xcode ===&lt;br /&gt;
    https://itunes.apple.com/fr/app/xcode/id497799835?mt=12&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.8 (Mac) ensure xcode command line tools are working ===&lt;br /&gt;
(MAC) Open a terminal window &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
sudo xCodebuild -license &lt;br /&gt;
quit&lt;br /&gt;
agree&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br /&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.9 Install Python ===&lt;br /&gt;
https://www.python.org/downloads/release/python-2712/&lt;br /&gt;
&lt;br /&gt;
You need Python 2.7.12 or later to install emscripten properly.&lt;br /&gt;
&lt;br /&gt;
Once installed, add it to your command line path, eg: c:\python27, on windows you can do this by right-clicking on &#039;myComputer&#039; or &#039;This PC&#039;, go to &#039;Properties&#039;, click &#039;Advanced System Settings&#039;, Click &#039;Environmental Variables&#039;, double-click &#039;Path&#039;, add &#039;c:\python27&#039;.&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.10 Install emscripten ===&lt;br /&gt;
    http://kripken.github.io/emscripten-site/&lt;br /&gt;
&lt;br /&gt;
You need this is you want to build for HTML5 + Facebook games.&lt;br /&gt;
&lt;br /&gt;
Using a shell or MSYS2 (previously installed) on windows, go to your home or C: folder and type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://github.com/juj/emsdk.git&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Once that has completed open a command prompt in that folder on Windows, on other system just cd to the folder.&lt;br /&gt;
&lt;br /&gt;
Using emsdk, install and activate all the latest packages:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
#(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install latest&lt;br /&gt;
emsdk activate latest&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(PC) Type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
emsdk_env.bat&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(MAC) Type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
source ./emsdk_env.sh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To use incoming branch of emscripten, use these commands instead:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
#(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install sdk-incoming-64bit&lt;br /&gt;
emsdk activate sdk-incoming-64bit&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To further use Gideros own git fork of emscripten:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
cd emscripten/incoming&lt;br /&gt;
# Add a git remote link to your own repository.&lt;br /&gt;
git remote add gideros https://github.com/gideros/emscripten.git&lt;br /&gt;
# Obtain the changes in your link.&lt;br /&gt;
git fetch gideros&lt;br /&gt;
# Switch the emscripten-incoming tool to use your fork.&lt;br /&gt;
git checkout -b gideros_incoming --track gideros/incoming&lt;br /&gt;
#Get back to emscripten directory and rebuild&lt;br /&gt;
cd ../..&lt;br /&gt;
emsdk install sdk-incoming-64bit&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
These can also be installed within emsdk: git, crunch, and spidermonkey&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install git-1.9.4&lt;br /&gt;
emsdk install crunch-1.03&lt;br /&gt;
emsdk install spidermonkey-37.0.1-64bit&lt;br /&gt;
emsdk activate git-1.9.4&lt;br /&gt;
emsdk activate crunch-1.03&lt;br /&gt;
emsdk activate spidermonkey-37.0.1-64bit&lt;br /&gt;
(PC) emsdk_env.bat&lt;br /&gt;
(MAC) source ./emsdk_env.sh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(PC) Make sure the environment variable EM_CONFIG is set to the location of your emscripten config file.&lt;br /&gt;
&lt;br /&gt;
The emscripten build also needs the CMake command.  You can download it and extract it to your home or C: folder.  Don&#039;t forget to add it&#039;s path to the end of the EMSDKPATH in Makefile.def.&lt;br /&gt;
&lt;br /&gt;
https://cmake.org/download/&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.11 Install Steam SDK ===&lt;br /&gt;
    https://partner.steamgames.com/?goto=%2Fdownloads%2Fsteamworks_sdk.zip&lt;br /&gt;
&lt;br /&gt;
Extract the archive/zip file to your home or C: folder, for example if the file is called &#039;steamworks_sdk_142.zip&#039; then you will have a &#039;c:\steamworks_sdk_142&#039; folder with a solder called &#039;sdk&#039; within it.  The sdk folder contains other folders such as glmgr, public, tools, etc.&lt;br /&gt;
&lt;br /&gt;
This is necessary for the Steam plugin.&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.12 Install Gideros ===&lt;br /&gt;
&lt;br /&gt;
==== 1.12.1 Fetch gideros source code ====&lt;br /&gt;
(PC) Open MSYS2 32 bit shell&lt;br /&gt;
&lt;br /&gt;
(MAC/Linux) Open a terminal&lt;br /&gt;
&lt;br /&gt;
Navigate to the folder where you into to work.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    git clone https://github.com/gideros/gideros &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== 1.12.2 Configure scripts ====&lt;br /&gt;
Make a copy of the file gideros/scripts/Makefile.def.example, rename it to Makefile.def and update the file copy according &lt;br /&gt;
to your installation. Ensure that the QT\_ARCH and QT_TOOLSARCH paths are formatted correctly according to your Qt &lt;br /&gt;
install directory structure (see below that they are named differently by Qt).&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;&#039;&#039;&#039;Example:&#039;&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;On PC:&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
For Qt:&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;gt;QTBASEDIR=/c/Qt&lt;br /&gt;
QT_ARCH=mingw53_32&lt;br /&gt;
QT_TOOLSARCH=mingw530_32&lt;br /&gt;
QTVER=5.9.1&lt;br /&gt;
QT5ICUVER=59&lt;br /&gt;
&lt;br /&gt;
STEAMSDK=/c/Applications/steamworks_sdk_142&lt;br /&gt;
export STEAMSDK&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
For Android:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
# on Windows, also add this to PATH&lt;br /&gt;
NDK_HOME=/c/android/android-ndk-r17b&lt;br /&gt;
NDKBUILD=cmd //c /c/android/android-ndk-r17b/ndk-build.cmd&lt;br /&gt;
#We use windows syntax for this one, as it will be used by gradle.bat script&lt;br /&gt;
JAVA_HOME=C:\Program Files\Java\jdk1.8.0_144&lt;br /&gt;
#Windows syntax with quadruple backslashs!&lt;br /&gt;
ANDROID_HOME=C:\\\\Users\\\\Gideros\\\\AppData\\\\Local\\\\Android\\\\sdk&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
For WinRT:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
FXC=&amp;quot;/c/Program Files (x86)/Windows Kits/8.1/bin/x86/fxc.exe&amp;quot; &lt;br /&gt;
MSBUILD=&amp;quot;/c/Program Files (x86)/MSBuild/14.0/Bin/MSbuild.exe&amp;quot; &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
For html5:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
EMSDK=/c/emsdkwin&lt;br /&gt;
EMSDKPATH=$(EMSDK):$(EMSDK)/clang/e1.35.0_64bit:$(EMSDK)/node/4.1.1_64bit/bin:$(EMSDK)/python/2.7.5.3_64bit:$(EMSDK)/emscripten/1.35.0&lt;br /&gt;
EMSDK_PREFIX=PATH=$(EMSDKPATH):$$$$PATH cmd //c&lt;br /&gt;
CRUNCHME=crunchme-win32.exe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;On MAC:&#039;&#039;&#039; &lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
QTBASEDIR=~/Qt QT_ARCH=clang_64 &lt;br /&gt;
QT_TOOLSARCH=clang_64 &lt;br /&gt;
QTVER=5.8 &lt;br /&gt;
QT5ICUVER=54 #deprecated stuff &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;On Linux:&#039;&#039;&#039; &lt;br /&gt;
(tested on Debian 11)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
QT=/usr&lt;br /&gt;
QMAKE=qmake6&lt;br /&gt;
QTLIBS=/lib/x86_64-linux-gnu&lt;br /&gt;
QTPLUGINS=$(QTLIBS)/qt6/plugins&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== 1.12.3 Complete working example Makefile.def for Windows ====&lt;br /&gt;
&lt;br /&gt;
Here is a working example, you will have to change the filename details to match your setup:&lt;br /&gt;
&lt;br /&gt;
[[Example Makefile.def file|example Makefile.def file]].&lt;br /&gt;
&lt;br /&gt;
==== 1.12.4 Fetch additional repositories ====&lt;br /&gt;
&lt;br /&gt;
Go into just cloned gideros source folder and run make prep.repo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    cd gideros&lt;br /&gt;
    make -f scripts/Makefile.gid prep.repo &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
If you intend to build the studio, you&#039;ll need scintilla and Lexilla libraries. Compile them now with:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    make -f scripts/Makefile.gid qlexilla&lt;br /&gt;
    make -f scripts/Makefile.gid qscintilla&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
== 2. Building ==&lt;br /&gt;
&lt;br /&gt;
If you have all dependencies in place for all targets, you can build everything at once via MSYS2 or Terminal with:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 2.1 Compilation on PC :===&lt;br /&gt;
&lt;br /&gt;
Open MSYS2 shell (msys2_shell.cmd). Standard compilation is 32 bit so use a 32 bit shell. Make sure you have installed the necessary build tools in MSYS2 using pacman, as detailed in [[#1.2 (PC) Install MSYS2 Console|Install MSYS2 Console]].&lt;br /&gt;
.&lt;br /&gt;
&lt;br /&gt;
Navigate to gideros folder &lt;br /&gt;
 &lt;br /&gt;
==== 2.1.1 Build QT tools : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid qtapp.install&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
-&amp;gt; files GiderosStudio.exe, GiderosPlayer.exe, GiderosTexturePacker.exe (…) in Build.Win folder &lt;br /&gt;
&lt;br /&gt;
==== 2.1.2 Android: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid android.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= file GiderosAndroidPlayer.apk in folder Build.Win/Players &lt;br /&gt;
&lt;br /&gt;
==== 2.1.3 winRT: ====&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;If necessary :&#039;&#039;&lt;br /&gt;
Open the solution, gideros/winRT_example/giderosgame.sln in Visual Studio. Check that the SQLite version for Windows and Windows Phone is up to date. Save and close the solution. &lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid winrt.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= file _bundle.appxupload in folder Build.Win/Players/WinRT&lt;br /&gt;
&lt;br /&gt;
==== 2.1.4 win32: ====&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid win32.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= files in folder Build.Win/Templates/win32 &lt;br /&gt;
 &lt;br /&gt;
==== 2.1.5 Html5: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid html5.install&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
-&amp;gt; files in folders Build.Win//Players/Html5 and Build.Win/Templates/Html5&lt;br /&gt;
&lt;br /&gt;
==== 2.1.6 Plugins: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.win &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= folder bin and file gplugin in folder Build.Win/All Plugins&lt;br /&gt;
&lt;br /&gt;
==== 2.1.7 To build everything that can be built on Windows ====&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid all&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Then you need to copy all the plugins to the &#039;Build.Win&#039; folder with:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.win&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 2.2 Compilation on Mac :===&lt;br /&gt;
Open Terminal.  &lt;br /&gt;
&lt;br /&gt;
cd to the folder « gideros » &lt;br /&gt;
&lt;br /&gt;
==== 2.2.1 QT : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid qtapp.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= GiderosStudio.exe, GiderosPlayer.exe, GiderosTexturePacker.exe (…) in folder Build.Mac &lt;br /&gt;
&lt;br /&gt;
==== 2.2.2 iOS : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid ios.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= GiderosiOSPlayer.zip in folder Buid.Mac/Players &lt;br /&gt;
&lt;br /&gt;
==== 2.2.3 Plugins: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.mac &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= folders bin and files gplugin in folder Buid.Mac/All Plugins&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
== 3. Cleaning ==&lt;br /&gt;
&lt;br /&gt;
If you want to reset the build process and start again then you can issue a &#039;clean&#039; command.  To do this type &#039;make -f scripts/Makefile.gid clean&#039;.&lt;br /&gt;
&lt;br /&gt;
eg:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid clean&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Sometimes you need to make a clean a particular build.  To do this type &#039;make -f scripts/Makefile.gid &#039; followed by something like &#039;html5&#039; then &#039;.clean&#039;.&lt;br /&gt;
&lt;br /&gt;
eg:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid html5.clean&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{GIDEROS IMPORTANT LINKS}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Compiling_Gideros_Source&amp;diff=24487</id>
		<title>Compiling Gideros Source</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Compiling_Gideros_Source&amp;diff=24487"/>
		<updated>2025-07-03T15:05:48Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* 1.3.1 (Linux/Debian) Install Git, build-tools */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;The following instructions are for developers who want to contribute to or otherwise experiment with the Gideros C/C++ engine and are &#039;&#039;not&#039;&#039; necessary for either building or deploying apps made with Gideros.&lt;br /&gt;
&lt;br /&gt;
The Gideros project consists of the Gideros Studio IDE, the Gideros SDK libraries, Gideros Texture Packer, Gideros Font Creator, &amp;quot;players&amp;quot; or export templates for all the platforms Gideros supports, all targets of all plugins, a daemon and a bridge. The build system is flexible, so you only need the tools for the targets you are interested in deploying to with Qt (and MSYS2 on Windows) being a realistic minimum.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div class=&amp;quot;noautonum&amp;quot;&amp;gt;__TOC__&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 1. Requirements ==&lt;br /&gt;
=== 1.1 Install QT ===&lt;br /&gt;
https://www.qt.io/download-open-source/&lt;br /&gt;
&lt;br /&gt;
Recommended version 6.3 with MinGW &amp;lt;br /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Double click on the downloaded file and follow instructions. When installing, expand the tree view and ensure you have ticked the MinGW child option of the Qt version checkbox, as well as the MinGW option in the Tools section.&lt;br /&gt;
Beside main QT package, you&#039;ll need the following additional components:&lt;br /&gt;
* WebSocket additional library&lt;br /&gt;
* Multimedia additional library&lt;br /&gt;
* Qt5 Compatibility addon&lt;br /&gt;
  &lt;br /&gt;
(MAC) Move the created folder into your user account folder &lt;br /&gt;
&lt;br /&gt;
(LINUX) &lt;br /&gt;
On Debian 11:&lt;br /&gt;
echo &amp;quot;deb http://deb.debian.org/debian bullseye-backports main&amp;quot; &amp;gt;&amp;gt;/etc/apt/sources.list&lt;br /&gt;
apt update&lt;br /&gt;
apt install qt6-base-dev qt6-websockets-dev qt6-multimedia-dev qt6-5compat-dev&lt;br /&gt;
&lt;br /&gt;
Depending on your distribution, you may need to install qt5 websocket lib seperately (sudo apt-get install libqt5websockets5-dev)&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
===1.2 (PC) Install MSYS2 Console===&lt;br /&gt;
    https://msys2.github.io/ &lt;br /&gt;
&lt;br /&gt;
Double click on the downloaded file (msys2-i686) and follow instructions. &lt;br /&gt;
&lt;br /&gt;
Open 32 bit MSYS2 shell: msys2_shell.cmd&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
pacman -Sy pacman&lt;br /&gt;
pacman -Syu&lt;br /&gt;
pacman -Su&lt;br /&gt;
pacman -S tar&lt;br /&gt;
pacman -S zip&lt;br /&gt;
pacman -S unzip&lt;br /&gt;
pacman -S git&lt;br /&gt;
pacman -S base-devel&lt;br /&gt;
pacman -S python&lt;br /&gt;
#For compiling win32/32bit under a MinGW64&lt;br /&gt;
pacman -S mingw-w64-i686-toolchain&lt;br /&gt;
pacman -S mingw-w64-i686-glew&lt;br /&gt;
pacman -S mingw-w64-i686-curl&lt;br /&gt;
pacman -S mingw-w64-i686-libpng&lt;br /&gt;
#For compiling win32/64bit under a MinGW64&lt;br /&gt;
pacman -S mingw-w64-x86_64-toolchain&lt;br /&gt;
pacman -S mingw-w64-x86_64-glew&lt;br /&gt;
pacman -S mingw-w64-x86_64-curl&lt;br /&gt;
pacman -S mingw-w64-x86_64-libpng&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.3 (Mac) Install Git &amp;amp; xcpretty ===&lt;br /&gt;
    http://git-scm.com/downloads&lt;br /&gt;
    &lt;br /&gt;
Ctrl + right click, open with « Install program.app » Follow instructions keeping default values as they are. &lt;br /&gt;
&lt;br /&gt;
(MAC) open a terminal window &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
git config -global user.name &amp;quot;your git login&amp;quot; &lt;br /&gt;
git config -global user.email &amp;quot;your git email&amp;quot;&lt;br /&gt;
sudo gem install xcpretty&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
=== 1.3.1 (Linux/Debian) Install Git, build-tools ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
apt install git build-essential libxcb-xinerama0 libgl1-mesa-dev libz-dev libasound2-dev libglew-dev libglfw3-dev libcurl4-openssl-dev patchelf zip libv4l-dev&lt;br /&gt;
git config --global user.email &amp;quot;your git email&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.4 (PC) Android requirements ===&lt;br /&gt;
&lt;br /&gt;
==== 1.4.1 Install Android Studio and NDK ====&lt;br /&gt;
&lt;br /&gt;
    https://developer.android.com/studio/index.html&lt;br /&gt;
    https://developer.android.com/ndk/downloads/older_releases.html&lt;br /&gt;
&lt;br /&gt;
Recommended NDK is 25c (the x86_64 version)&lt;br /&gt;
&lt;br /&gt;
Once downloaded, copy the contents of the NDK to your home or C: folder, rename the folder that you copied to &#039;android-ndk&#039;, for example you will end up with &#039;c:\android-ndk&#039; and below that folders that say build, meta, platforms, etc.&lt;br /&gt;
&lt;br /&gt;
==== 1.4.2 Install Ant (no longer required but kept util someone confirms this)====&lt;br /&gt;
    https://ant.apache.org/&lt;br /&gt;
&lt;br /&gt;
Once downloaded, copy the contents of the install archive/zip file to your home folder or C: drive.&lt;br /&gt;
Eg: so you have a folder called c:\apache-ant-1.10.5 with bin, etc, lib, manual folders within that.&lt;br /&gt;
&lt;br /&gt;
==== 1.4.3 Mix Old and New Tools (no longer required but kept util someone confirms this) ====&lt;br /&gt;
&lt;br /&gt;
Gideros uses Ant to build the player, unfortunately the tools to support Ant are now missing from the latest Android tools.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
There is a fix for this:&lt;br /&gt;
&lt;br /&gt;
# Rename the existing &#039;tools&#039; folder in the Android SDK folder to &#039;tools_new&#039;.&lt;br /&gt;
# Download an older (March 2016) version of the tools and copy that folder to the Android SDK folder.&lt;br /&gt;
# Copy the contents of &#039;tools_new&#039; over the contents of &#039;tools&#039;.&lt;br /&gt;
&lt;br /&gt;
Here is where you can download the compatible set of tools from:&lt;br /&gt;
&lt;br /&gt;
(PC) https://dl.google.com/android/repository/tools_r25.2.5-windows.zip&lt;br /&gt;
&lt;br /&gt;
(MAC) https://dl.google.com/android/repository/tools_r25.2.5-macosx.zip&lt;br /&gt;
&lt;br /&gt;
(LINUX) https://dl.google.com/android/repository/tools_r25.2.5-linux.zip&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.5 Install Java ===&lt;br /&gt;
You need the Java JDK&lt;br /&gt;
https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.6 (PC) Install Visual Studio ===&lt;br /&gt;
    https://www.visualstudio.com/downloads/&lt;br /&gt;
&lt;br /&gt;
Install [https://developer.microsoft.com/en-us/windows/downloads/windows-8-1-sdk Win 8.1 SDK]&lt;br /&gt;
&lt;br /&gt;
Install [https://marketplace.visualstudio.com/items?itemName=AdMediator.MicrosoftAdvertisingSDKforWindowsandWindowsPhone8x Microsoft Advertising SDK for Windows and Windows Phone 8.x]&lt;br /&gt;
&lt;br /&gt;
Ensure that you have MSBuild v12 or v14 installed (building with the makefile will fail with an incorrect version).&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.7 (MAC) Install Xcode ===&lt;br /&gt;
    https://itunes.apple.com/fr/app/xcode/id497799835?mt=12&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.8 (Mac) ensure xcode command line tools are working ===&lt;br /&gt;
(MAC) Open a terminal window &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
sudo xCodebuild -license &lt;br /&gt;
quit&lt;br /&gt;
agree&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br /&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.9 Install Python ===&lt;br /&gt;
https://www.python.org/downloads/release/python-2712/&lt;br /&gt;
&lt;br /&gt;
You need Python 2.7.12 or later to install emscripten properly.&lt;br /&gt;
&lt;br /&gt;
Once installed, add it to your command line path, eg: c:\python27, on windows you can do this by right-clicking on &#039;myComputer&#039; or &#039;This PC&#039;, go to &#039;Properties&#039;, click &#039;Advanced System Settings&#039;, Click &#039;Environmental Variables&#039;, double-click &#039;Path&#039;, add &#039;c:\python27&#039;.&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.10 Install emscripten ===&lt;br /&gt;
    http://kripken.github.io/emscripten-site/&lt;br /&gt;
&lt;br /&gt;
You need this is you want to build for HTML5 + Facebook games.&lt;br /&gt;
&lt;br /&gt;
Using a shell or MSYS2 (previously installed) on windows, go to your home or C: folder and type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://github.com/juj/emsdk.git&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Once that has completed open a command prompt in that folder on Windows, on other system just cd to the folder.&lt;br /&gt;
&lt;br /&gt;
Using emsdk, install and activate all the latest packages:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
#(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install latest&lt;br /&gt;
emsdk activate latest&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(PC) Type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
emsdk_env.bat&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(MAC) Type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
source ./emsdk_env.sh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To use incoming branch of emscripten, use these commands instead:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
#(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install sdk-incoming-64bit&lt;br /&gt;
emsdk activate sdk-incoming-64bit&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To further use Gideros own git fork of emscripten:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
cd emscripten/incoming&lt;br /&gt;
# Add a git remote link to your own repository.&lt;br /&gt;
git remote add gideros https://github.com/gideros/emscripten.git&lt;br /&gt;
# Obtain the changes in your link.&lt;br /&gt;
git fetch gideros&lt;br /&gt;
# Switch the emscripten-incoming tool to use your fork.&lt;br /&gt;
git checkout -b gideros_incoming --track gideros/incoming&lt;br /&gt;
#Get back to emscripten directory and rebuild&lt;br /&gt;
cd ../..&lt;br /&gt;
emsdk install sdk-incoming-64bit&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
These can also be installed within emsdk: git, crunch, and spidermonkey&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install git-1.9.4&lt;br /&gt;
emsdk install crunch-1.03&lt;br /&gt;
emsdk install spidermonkey-37.0.1-64bit&lt;br /&gt;
emsdk activate git-1.9.4&lt;br /&gt;
emsdk activate crunch-1.03&lt;br /&gt;
emsdk activate spidermonkey-37.0.1-64bit&lt;br /&gt;
(PC) emsdk_env.bat&lt;br /&gt;
(MAC) source ./emsdk_env.sh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(PC) Make sure the environment variable EM_CONFIG is set to the location of your emscripten config file.&lt;br /&gt;
&lt;br /&gt;
The emscripten build also needs the CMake command.  You can download it and extract it to your home or C: folder.  Don&#039;t forget to add it&#039;s path to the end of the EMSDKPATH in Makefile.def.&lt;br /&gt;
&lt;br /&gt;
https://cmake.org/download/&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.11 Install Steam SDK ===&lt;br /&gt;
    https://partner.steamgames.com/?goto=%2Fdownloads%2Fsteamworks_sdk.zip&lt;br /&gt;
&lt;br /&gt;
Extract the archive/zip file to your home or C: folder, for example if the file is called &#039;steamworks_sdk_142.zip&#039; then you will have a &#039;c:\steamworks_sdk_142&#039; folder with a solder called &#039;sdk&#039; within it.  The sdk folder contains other folders such as glmgr, public, tools, etc.&lt;br /&gt;
&lt;br /&gt;
This is necessary for the Steam plugin.&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.12 Install Gideros ===&lt;br /&gt;
&lt;br /&gt;
==== 1.12.1 Fetch gideros source code ====&lt;br /&gt;
(PC) Open MSYS2 32 bit shell&lt;br /&gt;
&lt;br /&gt;
(MAC/Linux) Open a terminal&lt;br /&gt;
&lt;br /&gt;
Navigate to the folder where you into to work.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    git clone https://github.com/gideros/gideros &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== 1.12.2 Configure scripts ====&lt;br /&gt;
Make a copy of the file gideros/scripts/Makefile.def.example, rename it to Makefile.def and update the file copy according &lt;br /&gt;
to your installation. Ensure that the QT\_ARCH and QT_TOOLSARCH paths are formatted correctly according to your Qt &lt;br /&gt;
install directory structure (see below that they are named differently by Qt).&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;&#039;&#039;&#039;Example:&#039;&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;On PC:&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
For Qt:&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;gt;QTBASEDIR=/c/Qt&lt;br /&gt;
QT_ARCH=mingw53_32&lt;br /&gt;
QT_TOOLSARCH=mingw530_32&lt;br /&gt;
QTVER=5.9.1&lt;br /&gt;
QT5ICUVER=59&lt;br /&gt;
&lt;br /&gt;
STEAMSDK=/c/Applications/steamworks_sdk_142&lt;br /&gt;
export STEAMSDK&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
For Android:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
# on Windows, also add this to PATH&lt;br /&gt;
NDK_HOME=/c/android/android-ndk-r17b&lt;br /&gt;
NDKBUILD=cmd //c /c/android/android-ndk-r17b/ndk-build.cmd&lt;br /&gt;
#We use windows syntax for this one, as it will be used by gradle.bat script&lt;br /&gt;
JAVA_HOME=C:\Program Files\Java\jdk1.8.0_144&lt;br /&gt;
#Windows syntax with quadruple backslashs!&lt;br /&gt;
ANDROID_HOME=C:\\\\Users\\\\Gideros\\\\AppData\\\\Local\\\\Android\\\\sdk&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
For WinRT:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
FXC=&amp;quot;/c/Program Files (x86)/Windows Kits/8.1/bin/x86/fxc.exe&amp;quot; &lt;br /&gt;
MSBUILD=&amp;quot;/c/Program Files (x86)/MSBuild/14.0/Bin/MSbuild.exe&amp;quot; &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
For html5:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
EMSDK=/c/emsdkwin&lt;br /&gt;
EMSDKPATH=$(EMSDK):$(EMSDK)/clang/e1.35.0_64bit:$(EMSDK)/node/4.1.1_64bit/bin:$(EMSDK)/python/2.7.5.3_64bit:$(EMSDK)/emscripten/1.35.0&lt;br /&gt;
EMSDK_PREFIX=PATH=$(EMSDKPATH):$$$$PATH cmd //c&lt;br /&gt;
CRUNCHME=crunchme-win32.exe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;On MAC:&#039;&#039;&#039; &lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
QTBASEDIR=~/Qt QT_ARCH=clang_64 &lt;br /&gt;
QT_TOOLSARCH=clang_64 &lt;br /&gt;
QTVER=5.8 &lt;br /&gt;
QT5ICUVER=54 #deprecated stuff &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;On Linux:&#039;&#039;&#039; &lt;br /&gt;
(tested on Debian 11)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
QT=/usr&lt;br /&gt;
QMAKE=qmake6&lt;br /&gt;
QTLIBS=/lib/x86_64-linux-gnu&lt;br /&gt;
QTPLUGINS=$(QTLIBS)/qt6/plugins&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== 1.12.3 Complete working example Makefile.def for Windows ====&lt;br /&gt;
&lt;br /&gt;
Here is a working example, you will have to change the filename details to match your setup:&lt;br /&gt;
&lt;br /&gt;
[[Example Makefile.def file|example Makefile.def file]].&lt;br /&gt;
&lt;br /&gt;
==== 1.12.4 Fetch additional repositories ====&lt;br /&gt;
&lt;br /&gt;
Go into just cloned gideros source folder and run make prep.repo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    cd gideros&lt;br /&gt;
    make -f scripts/Makefile.gid prep.repo &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
If you intend to build the studio, you&#039;ll need scintilla and Lexilla libraries. Compile them now with:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    make -f scripts/Makefile.gid qlexilla&lt;br /&gt;
    make -f scripts/Makefile.gid qscintilla&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
== 2. Building ==&lt;br /&gt;
&lt;br /&gt;
If you have all dependencies in place for all targets, you can build everything at once via MSYS2 or Terminal with:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 2.1 Compilation on PC :===&lt;br /&gt;
&lt;br /&gt;
Open MSYS2 shell (msys2_shell.cmd). Standard compilation is 32 bit so use a 32 bit shell. Make sure you have installed the necessary build tools in MSYS2 using pacman, as detailed in [[#1.2 (PC) Install MSYS2 Console|Install MSYS2 Console]].&lt;br /&gt;
.&lt;br /&gt;
&lt;br /&gt;
Navigate to gideros folder &lt;br /&gt;
 &lt;br /&gt;
==== 2.1.1 Build QT tools : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid qtapp.install&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
-&amp;gt; files GiderosStudio.exe, GiderosPlayer.exe, GiderosTexturePacker.exe (…) in Build.Win folder &lt;br /&gt;
&lt;br /&gt;
==== 2.1.2 Android: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid android.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= file GiderosAndroidPlayer.apk in folder Build.Win/Players &lt;br /&gt;
&lt;br /&gt;
==== 2.1.3 winRT: ====&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;If necessary :&#039;&#039;&lt;br /&gt;
Open the solution, gideros/winRT_example/giderosgame.sln in Visual Studio. Check that the SQLite version for Windows and Windows Phone is up to date. Save and close the solution. &lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid winrt.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= file _bundle.appxupload in folder Build.Win/Players/WinRT&lt;br /&gt;
&lt;br /&gt;
==== 2.1.4 win32: ====&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid win32.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= files in folder Build.Win/Templates/win32 &lt;br /&gt;
 &lt;br /&gt;
==== 2.1.5 Html5: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid html5.install&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
-&amp;gt; files in folders Build.Win//Players/Html5 and Build.Win/Templates/Html5&lt;br /&gt;
&lt;br /&gt;
==== 2.1.6 Plugins: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.win &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= folder bin and file gplugin in folder Build.Win/All Plugins&lt;br /&gt;
&lt;br /&gt;
==== 2.1.7 To build everything that can be built on Windows ====&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid all&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Then you need to copy all the plugins to the &#039;Build.Win&#039; folder with:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.win&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 2.2 Compilation on Mac :===&lt;br /&gt;
Open Terminal.  &lt;br /&gt;
&lt;br /&gt;
cd to the folder « gideros » &lt;br /&gt;
&lt;br /&gt;
==== 2.2.1 QT : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid qtapp.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= GiderosStudio.exe, GiderosPlayer.exe, GiderosTexturePacker.exe (…) in folder Build.Mac &lt;br /&gt;
&lt;br /&gt;
==== 2.2.2 iOS : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid ios.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= GiderosiOSPlayer.zip in folder Buid.Mac/Players &lt;br /&gt;
&lt;br /&gt;
==== 2.2.3 Plugins: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.mac &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= folders bin and files gplugin in folder Buid.Mac/All Plugins&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
== 3. Cleaning ==&lt;br /&gt;
&lt;br /&gt;
If you want to reset the build process and start again then you can issue a &#039;clean&#039; command.  To do this type &#039;make -f scripts/Makefile.gid clean&#039;.&lt;br /&gt;
&lt;br /&gt;
eg:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid clean&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Sometimes you need to make a clean a particular build.  To do this type &#039;make -f scripts/Makefile.gid &#039; followed by something like &#039;html5&#039; then &#039;.clean&#039;.&lt;br /&gt;
&lt;br /&gt;
eg:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid html5.clean&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{GIDEROS IMPORTANT LINKS}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Sprite:setLayoutConstraints&amp;diff=24425</id>
		<title>Sprite:setLayoutConstraints</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Sprite:setLayoutConstraints&amp;diff=24425"/>
		<updated>2025-05-05T15:37:29Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2018.9&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[Sprite]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
 Gideros layout system is heavily based on Java GridBagLayout principle. See here for more explanation &#039;&#039;&#039;https://www.math.uni-hamburg.de/doc/java/tutorial/uiswing/layout/gridbag.html&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
This function specifies the child placement rules within the grid defined on its parent by [[Sprite:setLayoutParameters]].&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
Sprite:setLayoutConstraints(constraints)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Specifying a &#039;&#039;&#039;nil&#039;&#039;&#039; table will clear layout constraints.&lt;br /&gt;
&lt;br /&gt;
 &#039;&#039;&#039;When a Sprite is resized by the layout system, an &#039;&#039;Event.LAYOUT_RESIZED&#039;&#039; is triggered&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;TODO&#039;&#039;&#039;: add/reorder/document missing fields from&lt;br /&gt;
*&#039;&#039;&#039;https://github.com/gideros/gideros/blob/e75e76c2857f8d8892c2383cea97fff174ff9a96/2dsg/gridbaglayout.h#L220&#039;&#039;&#039;&lt;br /&gt;
*&#039;&#039;&#039;https://github.com/gideros/gideros/blob/e75e76c2857f8d8892c2383cea97fff174ff9a96/luabinding/spritebinder.cpp#L786&#039;&#039;&#039;&lt;br /&gt;
*&#039;&#039;&#039;...&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
The constraint table can contain the following fields:&lt;br /&gt;
* &#039;&#039;&#039;gridx&#039;&#039;&#039;: the 0-based index of the column the child must be placed into&lt;br /&gt;
* &#039;&#039;&#039;gridy&#039;&#039;&#039;: the 0-based index of the row the child must be placed into&lt;br /&gt;
* &#039;&#039;&#039;gridwidth&#039;&#039;&#039;: the number of column this child will take&lt;br /&gt;
* &#039;&#039;&#039;gridheight&#039;&#039;&#039;: the number of row this child will take&lt;br /&gt;
* &#039;&#039;&#039;gridRelative&#039;&#039;&#039;: if &#039;&#039;&#039;gridx&#039;&#039;&#039; and &#039;&#039;&#039;gridy&#039; are relative to the previous child&lt;br /&gt;
* &#039;&#039;&#039;weightx&#039;&#039;&#039;: the horizontal weight of the child. Used to distribute extra space among children&lt;br /&gt;
* &#039;&#039;&#039;weighty&#039;&#039;&#039;: the vertical weight of the child. Used to distribute extra space among children&lt;br /&gt;
* &#039;&#039;&#039;anchor&#039;&#039;&#039;: defines where the child should be placed inside its grid space. Can be: [[Sprite.LAYOUT_ANCHOR_NORTHWEST]], [[Sprite.LAYOUT_ANCHOR_NORTH]], [[Sprite.LAYOUT_ANCHOR_NORTHEAST]], [[Sprite.LAYOUT_ANCHOR_WEST]], [[Sprite.LAYOUT_ANCHOR_CENTER]], [[Sprite.LAYOUT_ANCHOR_EAST]], [[Sprite.LAYOUT_ANCHOR_SOUTHWEST]], [[Sprite.LAYOUT_ANCHOR_SOUTH]] or [[Sprite.LAYOUT_ANCHOR_SOUTHEAST]]&lt;br /&gt;
* &#039;&#039;&#039;anchorx&#039;&#039;&#039;: specifies relative placement of the child on X axis. anchor mustn&#039;t be set &#039;&#039;&#039;since 2020.7&#039;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&#039;anchory&#039;&#039;&#039;: specifies relative placement of the child on Y axis. anchor mustn&#039;t be set &#039;&#039;&#039;since 2020.7&#039;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&#039;fill&#039;&#039;&#039;: in which directions the child should be expanded to fit the grid space. Can be: [[Sprite.LAYOUT_FILL_NONE]], [[Sprite.LAYOUT_FILL_HORIZONTAL]], [[Sprite.LAYOUT_FILL_VERTICAL]] or [[Sprite.LAYOUT_FILL_BOTH]]&lt;br /&gt;
* &#039;&#039;&#039;fillx&#039;&#039;&#039;: filling amount in X direction (replace &#039;&#039;&#039;fill&#039;&#039;&#039;)  &lt;br /&gt;
* &#039;&#039;&#039;filly&#039;&#039;&#039;: filling amount in Y direction (replace &#039;&#039;&#039;fill&#039;&#039;&#039;)  &lt;br /&gt;
* &#039;&#039;&#039;ipadx&#039;&#039;&#039;: internal horizontal padding&lt;br /&gt;
* &#039;&#039;&#039;ipady&#039;&#039;&#039;: internal vertical padding&lt;br /&gt;
* &#039;&#039;&#039;offsetx&#039;&#039;&#039;: final offset applied to the child on X axis, in logical units &#039;&#039;&#039;since 2020.7&#039;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&#039;offsety&#039;&#039;&#039;: final offset applied to the child on Y axis, in logical units &#039;&#039;&#039;since 2020.7&#039;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&#039;originx&#039;&#039;&#039;: final offset applied to the child on X axis, as a fraction of the child width &#039;&#039;&#039;since 2020.7&#039;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&#039;originy&#039;&#039;&#039;: final offset applied to the child on Y axis, as a fraction of the child height &#039;&#039;&#039;since 2020.7&#039;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&#039;minWidth&#039;&#039;&#039;: minimum width&lt;br /&gt;
* &#039;&#039;&#039;minHeight&#039;&#039;&#039;: minimum height&lt;br /&gt;
* &#039;&#039;&#039;prefWidth&#039;&#039;&#039;: preferred width&lt;br /&gt;
* &#039;&#039;&#039;prefHeight&#039;&#039;&#039;: preferred height&lt;br /&gt;
* &#039;&#039;&#039;width&#039;&#039;&#039;: short hand for setting both minWidth and prefWidth&lt;br /&gt;
* &#039;&#039;&#039;height&#039;&#039;&#039;: short hand for setting both minHeight and prefHeight&lt;br /&gt;
* &#039;&#039;&#039;extraw&#039;&#039;&#039;: extends this sprite&#039;s width by the following amount&lt;br /&gt;
* &#039;&#039;&#039;extrah&#039;&#039;&#039;: extends this sprite&#039;s height by the following amount&lt;br /&gt;
* &#039;&#039;&#039;shrink&#039;&#039;&#039;: allows grid shrinking &#039;&#039;&#039;since 2021.2&#039;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&#039;insetTop&#039;&#039;&#039;: the top margin&lt;br /&gt;
* &#039;&#039;&#039;insetLeft&#039;&#039;&#039;: the left margin&lt;br /&gt;
* &#039;&#039;&#039;insetBottom&#039;&#039;&#039;: the bottom margin&lt;br /&gt;
* &#039;&#039;&#039;insetRight&#039;&#039;&#039;: the right margin&lt;br /&gt;
* &#039;&#039;&#039;insets&#039;&#039;&#039;: sets the above four margins to the same value at once &#039;&#039;&#039;since 2020.7&#039;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&#039;overflowMode&#039;&#039;&#039;: enable overflow mode&lt;br /&gt;
* &#039;&#039;&#039;hidePriority&#039;&#039;&#039;: hide this child by priority over others&lt;br /&gt;
* &#039;&#039;&#039;aspectRatio&#039;&#039;&#039;: when filling, restricts the computed size to fit the given aspect ratio&lt;br /&gt;
* &#039;&#039;&#039;optimizeSize&#039;&#039;&#039;: shrink back the child to its really used size&lt;br /&gt;
* &#039;&#039;&#039;group&#039;&#039;&#039;: layout all this sprite&#039;s children as if they were on this grid&lt;br /&gt;
* &#039;&#039;&#039;autoClip&#039;&#039;&#039;: clip this sprite according to computed bounds&lt;br /&gt;
* &#039;&#039;&#039;contentAspectRatio&#039;&#039;&#039;: when filling, restricts the computed size so that inner size fits the given aspect ratio&lt;br /&gt;
&lt;br /&gt;
=== Parameters ===&lt;br /&gt;
&#039;&#039;&#039;constraints&#039;&#039;&#039;: (table) table of layout constraints&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Examples ===&lt;br /&gt;
&#039;&#039;&#039;Example&#039;&#039;&#039;: pixels&lt;br /&gt;
&lt;br /&gt;
&amp;lt;gallery widths=136px heights=240px&amp;gt;Layout parameters example.png&amp;lt;/gallery&amp;gt;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
-- LAYOUT CONSTRAINTS @Nanocore&lt;br /&gt;
-- BUTTONS HOLDER&lt;br /&gt;
local myholder = Pixel.new(0x0, 0.5, 256, 256)&lt;br /&gt;
myholder:setPosition(8, 8)&lt;br /&gt;
myholder:setLayoutParameters({&lt;br /&gt;
	columnWeights = {1, 1, 1}, -- 3 columns&lt;br /&gt;
	rowWeights = {1, 1, 1, 1}, -- 4 rows&lt;br /&gt;
	columnWidths = {32, 32, 32}, -- min columns width&lt;br /&gt;
	rowHeights = {32, 32, 32, 32}, -- min rows height&lt;br /&gt;
})&lt;br /&gt;
&lt;br /&gt;
-- BUTTONS&lt;br /&gt;
local mybtn1 = Pixel.new(0xff0000, 1, 32, 32)&lt;br /&gt;
mybtn1:setLayoutConstraints({&lt;br /&gt;
	gridx = 0,&lt;br /&gt;
	gridy = 0,&lt;br /&gt;
	gridwidth = 2,&lt;br /&gt;
	gridheight = 2,&lt;br /&gt;
	anchor = Sprite.LAYOUT_ANCHOR_NORTHWEST,&lt;br /&gt;
	fill = Sprite.LAYOUT_FILL_BOTH,&lt;br /&gt;
})&lt;br /&gt;
myholder:addChild(mybtn1)&lt;br /&gt;
&lt;br /&gt;
local mybtn2 = Pixel.new(0x00ff00, 1, 32, 32)&lt;br /&gt;
mybtn2:setLayoutConstraints({&lt;br /&gt;
	gridx = 1,&lt;br /&gt;
	gridy = 2,&lt;br /&gt;
	gridwidth = 1,&lt;br /&gt;
	anchor = Sprite.LAYOUT_ANCHOR_NORTHWEST,&lt;br /&gt;
	fill = Sprite.LAYOUT_FILL_VERTICAL,&lt;br /&gt;
})&lt;br /&gt;
myholder:addChild(mybtn2)&lt;br /&gt;
&lt;br /&gt;
local mybtn3 = Pixel.new(0x0000ff, 1, 32, 32)&lt;br /&gt;
mybtn3:setLayoutConstraints({&lt;br /&gt;
	gridx = 2,&lt;br /&gt;
	gridy = 3,&lt;br /&gt;
	gridwidth = 1,&lt;br /&gt;
	anchor = Sprite.LAYOUT_ANCHOR_NORTHWEST,&lt;br /&gt;
	fill = Sprite.LAYOUT_FILL_BOTH,&lt;br /&gt;
})&lt;br /&gt;
myholder:addChild(mybtn3)&lt;br /&gt;
&lt;br /&gt;
-- ADD TO STAGE&lt;br /&gt;
stage:addChild(myholder)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== See also ===&lt;br /&gt;
&#039;&#039;&#039;[[Sprite:setLayoutParameters]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{{Sprite}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Mesh:setPrimitiveType&amp;diff=24108</id>
		<title>Mesh:setPrimitiveType</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Mesh:setPrimitiveType&amp;diff=24108"/>
		<updated>2024-11-27T13:01:06Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2019.12&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[Mesh]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Sets the type of primitive to render.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
Mesh:setPrimitiveType(primitiveType)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The primitive type can be any of these:&lt;br /&gt;
*&#039;&#039;&#039;Mesh.PRIMITIVE_POINT&#039;&#039;&#039;&lt;br /&gt;
*&#039;&#039;&#039;Mesh.PRIMITIVE_LINES&#039;&#039;&#039;&lt;br /&gt;
*&#039;&#039;&#039;Mesh.PRIMITIVE_LINELOOP&#039;&#039;&#039;&lt;br /&gt;
*&#039;&#039;&#039;Mesh.PRIMITIVE_TRIANGLES&#039;&#039;&#039;&lt;br /&gt;
*&#039;&#039;&#039;Mesh.PRIMITIVE_TRIANGLESTRIP&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
=== Parameters ===&lt;br /&gt;
&#039;&#039;&#039;primitiveType&#039;&#039;&#039;: (string) any of above the primitive type&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Mesh}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Writing_Lua_Shaders&amp;diff=24036</id>
		<title>Writing Lua Shaders</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Writing_Lua_Shaders&amp;diff=24036"/>
		<updated>2024-11-15T08:39:31Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Parent:&#039;&#039;&#039; [[Shaders]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Lua Shaders ==&lt;br /&gt;
 &#039;&#039;&#039;Requirements&#039;&#039;&#039;:&lt;br /&gt;
 &#039;&#039;&#039;In order to use Lua Shaders you need to include &#039;&#039;luashader&#039;&#039; standard library in your projects&#039;&#039;&#039;&lt;br /&gt;
 &#039;&#039;&#039;&#039;&#039;luashader&#039;&#039; standard library is available in your Gideros installation folder under &#039;&#039;Library&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
When you write your shaders in &#039;&#039;&#039;Lua&#039;&#039;&#039;, they will be automatically translated to the relevant shader Language for the platform you are using (eg GLSL, HLSL or MSL). This is the &#039;&#039;&#039;recommended&#039;&#039;&#039; way to write your shaders in Gideros.&lt;br /&gt;
&lt;br /&gt;
The [[Shader|Shader API]] allows the creation of Shader objects from within Lua. The &#039;&#039;&#039;&#039;&#039;Shader.lua()&#039;&#039;&#039;&#039;&#039; constructor takes five arguments:&lt;br /&gt;
* the &#039;&#039;&#039;Vertex&#039;&#039;&#039; shader code (a lua function)&lt;br /&gt;
* the &#039;&#039;&#039;Fragment&#039;&#039;&#039; shader code (a lua function)&lt;br /&gt;
* a set of [[Shader Flags|numerical flags]] or 0 if none&lt;br /&gt;
* an array of [[Shader Uniform Descriptors|uniforms/constants descriptors]]&lt;br /&gt;
* an array of [[Shader Attribute Descriptors|attributes descriptors]]&lt;br /&gt;
* an array of [[Shader Varying Descriptors|varying descriptors]]&lt;br /&gt;
&lt;br /&gt;
With Lua Shaders, it is assumed that the code is within the &#039;&#039;&#039;Vertex&#039;&#039;&#039; and &#039;&#039;&#039;Fragment&#039;&#039;&#039; parameter functions.&lt;br /&gt;
&lt;br /&gt;
A typical Lua &#039;&#039;&#039;Vertex&#039;&#039;&#039; and &#039;&#039;&#039;Fragment&#039;&#039;&#039; shader code looks like:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
function vssaturate(vVertex, vColor, vTexCoord) : Shader -- Vertex Shader&lt;br /&gt;
	local vertex = hF4(vVertex, 0.0, 1.0)&lt;br /&gt;
	fTexCoord = vTexCoord&lt;br /&gt;
	return vMatrix * vertex&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
function fssaturate() : Shader -- Fragment Shader&lt;br /&gt;
	local frad = (1 + sin(fTime)) * 0.5&lt;br /&gt;
	local frag = lF4(fColor) * texture2D(fTexture, fTexCoord)&lt;br /&gt;
	local coef = lF3(0.2125, 0.7154, 0.0721)&lt;br /&gt;
	local dp = dot(frag.rgb, coef)&lt;br /&gt;
	frag.rgb = mix(frag.rgb, frag.rgb / dp, frad)&lt;br /&gt;
	if (frag.a == 0.0) then discard() end&lt;br /&gt;
	return frag&lt;br /&gt;
end&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Once both functions are created, you pass them in &#039;&#039;&#039;Shader.lua&#039;&#039;&#039;:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
local saturate = Shader.lua(vssaturate, fssaturate, 0,&lt;br /&gt;
	{&lt;br /&gt;
	{name = &amp;quot;vMatrix&amp;quot;, type = Shader.CMATRIX, sys = Shader.SYS_WVP, vertex = true},&lt;br /&gt;
	{name = &amp;quot;fColor&amp;quot;, type = Shader.CFLOAT4, sys = Shader.SYS_COLOR, vertex = false},&lt;br /&gt;
	{name = &amp;quot;fTexture&amp;quot;, type = Shader.CTEXTURE, vertex = false},&lt;br /&gt;
	{name = &amp;quot;fTextureInfo&amp;quot;, type = Shader.CFLOAT4, sys = Shader.SYS_TEXTUREINFO, vertex = false},&lt;br /&gt;
	{name = &amp;quot;fTime&amp;quot;, type = Shader.CFLOAT, sys = Shader.SYS_TIMER, vertex = false},&lt;br /&gt;
	},&lt;br /&gt;
	{&lt;br /&gt;
	{name = &amp;quot;vVertex&amp;quot;, type = Shader.DFLOAT, mult = 2, slot = 0, offset = 0},&lt;br /&gt;
	{name = &amp;quot;vColor&amp;quot;, type = Shader.DUBYTE, mult = 4, slot = 1, offset = 0},&lt;br /&gt;
	{name = &amp;quot;vTexCoord&amp;quot;, type = Shader.DFLOAT, mult = 2, slot = 2, offset = 0},&lt;br /&gt;
	},&lt;br /&gt;
	{&lt;br /&gt;
	{name = &amp;quot;fTexCoord&amp;quot;, type = Shader.CFLOAT2},&lt;br /&gt;
	}&lt;br /&gt;
)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Working from a standard shader ===&lt;br /&gt;
Gideros standard Sprites always use shaders internally, even if you don&#039;t supply your own. Rather than redefining everything, you can ask for a shader template, prefilled with definitions for default behavior, and override what you want.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
-- Custom shader for a plain colored pixel (BASIC PROGRAM)&lt;br /&gt;
local shader=StandardShaders:getShaderSpecification(Shader.SHADER_PROGRAM_BASIC)&lt;br /&gt;
-- Customized fragment shader&lt;br /&gt;
function shader:fragmentShader() : Shader&lt;br /&gt;
	return lF4(1,0,0,1) -- Pure red for every pixel&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
local p=Pixel.new(0x00FF00,1,30,30) -- Green pixel&lt;br /&gt;
p:setPosition(20,20)&lt;br /&gt;
p:setShader(shader:build()) -- Apply our customized shader&lt;br /&gt;
stage:addChild(p)&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Changing Uniforms/Constants ===&lt;br /&gt;
In order to change the value of a uniform from Lua, you use the &#039;&#039;setConstant&#039;&#039; function on the Shader, it takes four arguments:&lt;br /&gt;
*the uniform name&lt;br /&gt;
*the type of data to set: [[Shader Constants|one of the Shader.Cxxx constants]]&lt;br /&gt;
*the number of elements of the given type to set (number)&lt;br /&gt;
*the actual data to set, either as a table or as multiple arguments&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
saturate:setConstant(&amp;quot;fSwitch&amp;quot;, Shader.CINT, 1, 0) -- set fSwitch value to be 0 (off)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
This will change the value of a Uniform for the whole Shader.&lt;br /&gt;
&lt;br /&gt;
You can also change the value of a Uniform on a sprite to sprite basis using [[Sprite:setShaderConstant]]:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
bmp:setShaderConstant(&amp;quot;fSwitch&amp;quot;, Shader.CINT, 1, 22) -- set fSwitch value to be 0 (on)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Associating a Shader to a Sprite ===&lt;br /&gt;
The Sprite API has a new call to deal with that: &#039;&#039;&#039;&#039;&#039;Sprite:setShader(shader)&#039;&#039;&#039;&#039;&#039; tells Gideros to use the specified shader for rendering the sprite. Setting back the shader to &#039;&#039;&#039;&#039;&#039;nil&#039;&#039;&#039;&#039;&#039; actually revert to the default shader.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
bmp:setShader(saturate)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Lua Shader Functions ===&lt;br /&gt;
&#039;&#039;&#039;(Please note that these functions may or may not be available, the Lua shader is still under development)&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;column-count:3;-moz-column-count:3;-webkit-column-count:3&amp;quot;&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Language Helper Functions|Language Helpers]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Conversion and Constructor Functions|Conversion and Constructors]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Angle and Trigonometry Functions|Angle and Trigonometry]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Exponential Functions|Exponential]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Common Functions|Common]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Geometric Functions|Geometric]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Matrix Functions|Matrix]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Vector Relational Functions|Vector Relational]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Texture Lookup Functions|Texture Lookup]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Fragment Processing Functions|Fragment Processing]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Noise Functions|Noise]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Geometry Functions|Geometric]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Restrictions ===&lt;br /&gt;
Don&#039;t rely on anything external, basically no globals except for attributes, uniforms and varying.&lt;br /&gt;
* No Do..While&lt;br /&gt;
* No Repeat..Until&lt;br /&gt;
* No tables. The only allowed form of table lookup is for vector component swizzling and access to uniform arrays&lt;br /&gt;
* No strings, userdata, etc. Basically only numbers are supported&lt;br /&gt;
* Mind your types! Although lua is not a typed language, shaders need types&lt;br /&gt;
* Always check on all platforms: Gideros will translate your lua code to GLSL,HLSL or MSL code, but some platforms are more strict than others about what you can write, or how many arguments a common function is supposed to take&lt;br /&gt;
&lt;br /&gt;
=== Lua Shader Examples ===&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Examples]]&#039;&#039;&#039;&amp;lt;/br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Further Reading ===&lt;br /&gt;
OpenGL Shading Language: &#039;&#039;&#039;https://www.khronos.org/opengl/wiki/OpenGL_Shading_Language&#039;&#039;&#039;&amp;lt;/br&amp;gt;&lt;br /&gt;
Common compatibility pitfalls: &#039;&#039;&#039;https://www.opengl.org/wiki/GLSL_:_common_mistakes&#039;&#039;&#039;&amp;lt;/br&amp;gt;&lt;br /&gt;
The Book of Shaders: &#039;&#039;&#039;https://thebookofshaders.com/&#039;&#039;&#039;&amp;lt;/br&amp;gt;&lt;br /&gt;
ShaderToy: &#039;&#039;&#039;https://www.shadertoy.com/&#039;&#039;&#039;&amp;lt;/br&amp;gt;&lt;br /&gt;
GH: &#039;&#039;&#039;https://github.com/mattdesl/lwjgl-basics/wiki/Shaders&#039;&#039;&#039;&amp;lt;/br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{SHADERS}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Shader_Varying_Descriptors&amp;diff=24035</id>
		<title>Shader Varying Descriptors</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Shader_Varying_Descriptors&amp;diff=24035"/>
		<updated>2024-11-15T08:20:29Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: Created page with &amp;quot;__NOTOC__ &amp;#039;&amp;#039;&amp;#039;Available since:&amp;#039;&amp;#039;&amp;#039; Gideros 2015.06.30&amp;lt;br/&amp;gt; &amp;#039;&amp;#039;&amp;#039;Class:&amp;#039;&amp;#039;&amp;#039; Shader&amp;lt;br/&amp;gt;  === Description === Each varying entry is a lua table with the following fields:  * &amp;#039;&amp;#039;&amp;#039;n...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2015.06.30&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[Shader]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Each varying entry is a lua table with the following fields:&lt;br /&gt;
&lt;br /&gt;
* &#039;&#039;&#039;name&#039;&#039;&#039;: name of the varying . Must match the name used in GLSL program&lt;br /&gt;
* &#039;&#039;&#039;type&#039;&#039;&#039;: type of data this varying holds. Must be one of Shader.CFLOAT,Shader.CFLOAT2, Shader.CFLOAT3,Shader.CFLOAT4, Shader.CINT&lt;br /&gt;
&lt;br /&gt;
A varying is a variable passed between a vertex shader and a fragment shader.&lt;br /&gt;
&lt;br /&gt;
=== Examples ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
local shadergrey=Shader.new(&amp;quot;openglshader/vShaderGrey&amp;quot;,&amp;quot;openglshader/fShaderGrey&amp;quot;, 0,&lt;br /&gt;
	{&lt;br /&gt;
	{name=&amp;quot;vMatrix&amp;quot;, type=Shader.CMATRIX, sys=Shader.SYS_WVP, vertex=true},&lt;br /&gt;
	{name=&amp;quot;fColor&amp;quot;, type=Shader.CFLOAT4, sys=Shader.SYS_COLOR, vertex=false},&lt;br /&gt;
	{name=&amp;quot;fTexture&amp;quot;, type=Shader.CTEXTURE, vertex=false},&lt;br /&gt;
	},&lt;br /&gt;
	{&lt;br /&gt;
	{name=&amp;quot;vVertex&amp;quot;, type=Shader.DFLOAT, mult=3, slot=0, offset=0},&lt;br /&gt;
	{name=&amp;quot;vColor&amp;quot;, type=Shader.DUBYTE, mult=4, slot=1, offset=0},&lt;br /&gt;
	{name=&amp;quot;vTexCoord&amp;quot;, type=Shader.DFLOAT, mult=2, slot=2, offset=0},&lt;br /&gt;
	},&lt;br /&gt;
	{&lt;br /&gt;
	{name=&amp;quot;fTexCoord&amp;quot;, type=Shader.CFLOAT2},&lt;br /&gt;
	}&lt;br /&gt;
)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
local shaderwave=Shader.new(&amp;quot;openglshader/vShaderWave&amp;quot;,&amp;quot;openglshader/fShaderWave&amp;quot;, 0,&lt;br /&gt;
{&lt;br /&gt;
	{name=&amp;quot;g_MVPMatrix&amp;quot;, type=Shader.CMATRIX, sys=Shader.SYS_WVP, vertex=true},&lt;br /&gt;
	{name=&amp;quot;g_Color&amp;quot;, type=Shader.CFLOAT4, mult=1, sys=Shader.SYS_COLOR},&lt;br /&gt;
	{name=&amp;quot;g_Texture&amp;quot;, type=Shader.CTEXTURE, mult=1, vertex=false},&lt;br /&gt;
	{name=&amp;quot;time&amp;quot;, type=Shader.CFLOAT, mult=1, vertex=false}&lt;br /&gt;
	},&lt;br /&gt;
	{&lt;br /&gt;
	{name=&amp;quot;POSITION0&amp;quot;, type=Shader.DFLOAT, mult=3, slot=0, offset=0},&lt;br /&gt;
	{name=&amp;quot;vColor&amp;quot;, type=Shader.DUBYTE, mult=0, slot=1, offset=0},&lt;br /&gt;
	{name=&amp;quot;TEXCOORD0&amp;quot;, type=Shader.DFLOAT, mult=2, slot=2, offset=0}&lt;br /&gt;
	},&lt;br /&gt;
	{&lt;br /&gt;
	{name=&amp;quot;fTexCoord&amp;quot;, type=Shader.CFLOAT2},&lt;br /&gt;
	}&lt;br /&gt;
)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Shader}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Shader_Uniform_Descriptors&amp;diff=24034</id>
		<title>Shader Uniform Descriptors</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Shader_Uniform_Descriptors&amp;diff=24034"/>
		<updated>2024-11-15T08:16:41Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* Examples */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2015.06.30&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[Shader]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Each uniform descriptor entry is a lua table with the following fields:&lt;br /&gt;
&lt;br /&gt;
* &#039;&#039;&#039;name&#039;&#039;&#039;: name of the uniform. Must match the name used in GLSL program&lt;br /&gt;
* &#039;&#039;&#039;type&#039;&#039;&#039;: type of data this uniform holds. Must be one of Shader.CFLOAT, Shader.CFLOAT4, Shader.CINT, Shader.CMATRIX or Shader.CTEXTURE&lt;br /&gt;
* &#039;&#039;&#039;mult&#039;&#039;&#039;: the number of elements if this uniform is an array&lt;br /&gt;
* &#039;&#039;&#039;vertex&#039;&#039;&#039;: boolean which must be set to true if the uniform is defined in the vertex shader, and false if it is defined in the fragment shader&lt;br /&gt;
* &#039;&#039;&#039;sys&#039;&#039;&#039;: indicates that this uniform has a special meaning and should be set by Gideros when appropriate. Current possible values are:&lt;br /&gt;
** &#039;&#039;&#039;Shader.SYS_WVP&#039;&#039;&#039;: this uniform of type CMATRIX will hold the World/View/Projection matrix&lt;br /&gt;
** &#039;&#039;&#039;Shader.SYS_COLOR&#039;&#039;&#039;: this uniform of type CFLOAT4 will hold the constant color to be used to draw the shape&lt;br /&gt;
** &#039;&#039;&#039;Shader.SYS_WORLD&#039;&#039;&#039;: this uniform of type CMATRIX will hold the World transform matrix&lt;br /&gt;
** &#039;&#039;&#039;Shader.SYS_WIT&#039;&#039;&#039;: this uniform of type CMATRIX will hold the World Inverse Transpose matrix&lt;br /&gt;
** &#039;&#039;&#039;Shader.SYS_TEXTUREINFO&#039;&#039;&#039;: this uniform of type CFLOAT4 will hold information about the texture used in a particle shader&lt;br /&gt;
** &#039;&#039;&#039;Shader.SYS_PARTICLESIZE&#039;&#039;&#039;: the uniform of type CFLOAT will hold the particle size to use in a particle shader&lt;br /&gt;
&lt;br /&gt;
The uniforms must be declared in the order they appear in the constant block of the HLSL version of the shader. If shaders are only GLSL, then the order is not relevant.&lt;br /&gt;
&lt;br /&gt;
=== Examples ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
local shadergrey=Shader.new(&amp;quot;openglshader/vShaderGrey&amp;quot;,&amp;quot;openglshader/fShaderGrey&amp;quot;, 0,&lt;br /&gt;
	{&lt;br /&gt;
	{name=&amp;quot;vMatrix&amp;quot;, type=Shader.CMATRIX, sys=Shader.SYS_WVP, vertex=true},&lt;br /&gt;
	{name=&amp;quot;fColor&amp;quot;, type=Shader.CFLOAT4, sys=Shader.SYS_COLOR, vertex=false},&lt;br /&gt;
	{name=&amp;quot;fTexture&amp;quot;, type=Shader.CTEXTURE, vertex=false},&lt;br /&gt;
	},&lt;br /&gt;
	{&lt;br /&gt;
	{name=&amp;quot;vVertex&amp;quot;, type=Shader.DFLOAT, mult=3, slot=0, offset=0},&lt;br /&gt;
	{name=&amp;quot;vColor&amp;quot;, type=Shader.DUBYTE, mult=4, slot=1, offset=0},&lt;br /&gt;
	{name=&amp;quot;vTexCoord&amp;quot;, type=Shader.DFLOAT, mult=2, slot=2, offset=0},&lt;br /&gt;
	},&lt;br /&gt;
	{&lt;br /&gt;
	{name=&amp;quot;fTexCoord&amp;quot;, type=Shader.CFLOAT2},&lt;br /&gt;
	}&lt;br /&gt;
)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
local shaderwave=Shader.new(&amp;quot;openglshader/vShaderWave&amp;quot;,&amp;quot;openglshader/fShaderWave&amp;quot;, 0,&lt;br /&gt;
{&lt;br /&gt;
	{name=&amp;quot;g_MVPMatrix&amp;quot;, type=Shader.CMATRIX, sys=Shader.SYS_WVP, vertex=true},&lt;br /&gt;
	{name=&amp;quot;g_Color&amp;quot;, type=Shader.CFLOAT4, mult=1, sys=Shader.SYS_COLOR},&lt;br /&gt;
	{name=&amp;quot;g_Texture&amp;quot;, type=Shader.CTEXTURE, mult=1, vertex=false},&lt;br /&gt;
	{name=&amp;quot;time&amp;quot;, type=Shader.CFLOAT, mult=1, vertex=false}&lt;br /&gt;
	},&lt;br /&gt;
	{&lt;br /&gt;
	{name=&amp;quot;POSITION0&amp;quot;, type=Shader.DFLOAT, mult=3, slot=0, offset=0},&lt;br /&gt;
	{name=&amp;quot;vColor&amp;quot;, type=Shader.DUBYTE, mult=0, slot=1, offset=0},&lt;br /&gt;
	{name=&amp;quot;TEXCOORD0&amp;quot;, type=Shader.DFLOAT, mult=2, slot=2, offset=0}&lt;br /&gt;
	},&lt;br /&gt;
	{&lt;br /&gt;
	{name=&amp;quot;fTexCoord&amp;quot;, type=Shader.CFLOAT2},&lt;br /&gt;
	}&lt;br /&gt;
)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Shader}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Shader_Attribute_Descriptors&amp;diff=24033</id>
		<title>Shader Attribute Descriptors</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Shader_Attribute_Descriptors&amp;diff=24033"/>
		<updated>2024-11-15T08:16:16Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* Examples */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2015.06.30&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[Shader]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Each attribute descriptor entry is a Lua table with the following fields: &lt;br /&gt;
* &#039;&#039;&#039;name&#039;&#039;&#039;: the name of the attribute/vertex data stream. Must match the name used in &#039;&#039;&#039;GLSL&#039;&#039;&#039; and &#039;&#039;&#039;HLSL&#039;&#039;&#039; code&lt;br /&gt;
* &#039;&#039;&#039;type&#039;&#039;&#039;: data type used from the host point of view. One of &#039;&#039;&#039;Shader.DFLOAT&#039;&#039;&#039;, &#039;&#039;&#039;Shader.DBYTE&#039;&#039;&#039;, &#039;&#039;&#039;Shader.DUBYTE&#039;&#039;&#039;, &#039;&#039;&#039;Shader.DSHORT&#039;&#039;&#039;, &#039;&#039;&#039;Shader.DUSHORT&#039;&#039;&#039; or &#039;&#039;&#039;Shader.DINT&#039;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&#039;mult&#039;&#039;&#039;: number of components of the input vector&lt;br /&gt;
* &#039;&#039;&#039;slot&#039;&#039;&#039;: index of the input slot (HLSL only)&lt;br /&gt;
* &#039;&#039;&#039;offset&#039;&#039;&#039;: offset within the input slot (HLSL only, should be 0)&lt;br /&gt;
&lt;br /&gt;
The first three attributes have fixed meaning. Those are, in order:&lt;br /&gt;
* &#039;&#039;&#039;the vertex coordinate stream&#039;&#039;&#039;. Type must be Shader.DFLOAT and mult should be 3&lt;br /&gt;
* &#039;&#039;&#039;the per-vertex color&#039;&#039;&#039;. Type must be Shader.DUBYTE and mult should be 4&lt;br /&gt;
* &#039;&#039;&#039;the texture coordinates&#039;&#039;&#039;. Type must be Shader.DFLOAT and mult should be 2&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;If one of these fixed attributes is not used by the custom shader program, it should still be defined with a &#039;&#039;mult&#039;&#039; value of 0 to serve as a placeholder.&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
=== Examples ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
local shadergrey=Shader.new(&amp;quot;openglshader/vShaderGrey&amp;quot;,&amp;quot;openglshader/fShaderGrey&amp;quot;, 0,&lt;br /&gt;
	{&lt;br /&gt;
	{name=&amp;quot;vMatrix&amp;quot;, type=Shader.CMATRIX, sys=Shader.SYS_WVP, vertex=true},&lt;br /&gt;
	{name=&amp;quot;fColor&amp;quot;, type=Shader.CFLOAT4, sys=Shader.SYS_COLOR, vertex=false},&lt;br /&gt;
	{name=&amp;quot;fTexture&amp;quot;, type=Shader.CTEXTURE, vertex=false},&lt;br /&gt;
	},&lt;br /&gt;
	{&lt;br /&gt;
	{name=&amp;quot;vVertex&amp;quot;, type=Shader.DFLOAT, mult=3, slot=0, offset=0},&lt;br /&gt;
	{name=&amp;quot;vColor&amp;quot;, type=Shader.DUBYTE, mult=4, slot=1, offset=0},&lt;br /&gt;
	{name=&amp;quot;vTexCoord&amp;quot;, type=Shader.DFLOAT, mult=2, slot=2, offset=0},&lt;br /&gt;
	},&lt;br /&gt;
	{&lt;br /&gt;
	{name=&amp;quot;fTexCoord&amp;quot;, type=Shader.CFLOAT2},&lt;br /&gt;
	}&lt;br /&gt;
)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
local shaderwave=Shader.new(&amp;quot;openglshader/vShaderWave&amp;quot;,&amp;quot;openglshader/fShaderWave&amp;quot;, 0,&lt;br /&gt;
{&lt;br /&gt;
	{name=&amp;quot;g_MVPMatrix&amp;quot;, type=Shader.CMATRIX, sys=Shader.SYS_WVP, vertex=true},&lt;br /&gt;
	{name=&amp;quot;g_Color&amp;quot;, type=Shader.CFLOAT4, mult=1, sys=Shader.SYS_COLOR},&lt;br /&gt;
	{name=&amp;quot;g_Texture&amp;quot;, type=Shader.CTEXTURE, mult=1, vertex=false},&lt;br /&gt;
	{name=&amp;quot;time&amp;quot;, type=Shader.CFLOAT, mult=1, vertex=false}&lt;br /&gt;
	},&lt;br /&gt;
	{&lt;br /&gt;
	{name=&amp;quot;POSITION0&amp;quot;, type=Shader.DFLOAT, mult=3, slot=0, offset=0},&lt;br /&gt;
	{name=&amp;quot;vColor&amp;quot;, type=Shader.DUBYTE, mult=0, slot=1, offset=0},&lt;br /&gt;
	{name=&amp;quot;TEXCOORD0&amp;quot;, type=Shader.DFLOAT, mult=2, slot=2, offset=0}&lt;br /&gt;
	},&lt;br /&gt;
	{&lt;br /&gt;
	{name=&amp;quot;fTexCoord&amp;quot;, type=Shader.CFLOAT2},&lt;br /&gt;
	}&lt;br /&gt;
)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Shader}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Writing_Lua_Shaders&amp;diff=24032</id>
		<title>Writing Lua Shaders</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Writing_Lua_Shaders&amp;diff=24032"/>
		<updated>2024-11-15T08:15:42Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Parent:&#039;&#039;&#039; [[Shaders]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Lua Shaders ==&lt;br /&gt;
 &#039;&#039;&#039;Requirements&#039;&#039;&#039;:&lt;br /&gt;
 &#039;&#039;&#039;In order to use Lua Shaders you need to include &#039;&#039;luashader&#039;&#039; standard library in your projects&#039;&#039;&#039;&lt;br /&gt;
 &#039;&#039;&#039;&#039;&#039;luashader&#039;&#039; standard library is available in your Gideros installation folder under &#039;&#039;Library&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
When you write your shaders in &#039;&#039;&#039;Lua&#039;&#039;&#039;, they will be automatically translated to the relevant shader Language for the platform you are using (eg GLSL, HLSL or MSL). This is the &#039;&#039;&#039;recommended&#039;&#039;&#039; way to write your shaders in Gideros.&lt;br /&gt;
&lt;br /&gt;
The [[Shader|Shader API]] allows the creation of Shader objects from within Lua. The &#039;&#039;&#039;&#039;&#039;Shader.lua()&#039;&#039;&#039;&#039;&#039; constructor takes five arguments:&lt;br /&gt;
* the &#039;&#039;&#039;Vertex&#039;&#039;&#039; shader code (a lua function)&lt;br /&gt;
* the &#039;&#039;&#039;Fragment&#039;&#039;&#039; shader code (a lua function)&lt;br /&gt;
* a set of [[Shader Flags|numerical flags]] or 0 if none&lt;br /&gt;
* an array of [[Shader Uniform Descriptors|uniforms/constants descriptors]]&lt;br /&gt;
* an array of [[Shader Attribute Descriptors|attributes descriptors]]&lt;br /&gt;
* an array of [[Shader Varying Descriptors|varying descriptors]]&lt;br /&gt;
&lt;br /&gt;
With Lua Shaders, it is assumed that the code is within the &#039;&#039;&#039;Vertex&#039;&#039;&#039; and &#039;&#039;&#039;Fragment&#039;&#039;&#039; parameter functions.&lt;br /&gt;
&lt;br /&gt;
A typical Lua &#039;&#039;&#039;Vertex&#039;&#039;&#039; and &#039;&#039;&#039;Fragment&#039;&#039;&#039; shader code looks like:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
function vssaturate(vVertex, vColor, vTexCoord) : Shader -- Vertex Shader&lt;br /&gt;
	local vertex = hF4(vVertex, 0.0, 1.0)&lt;br /&gt;
	fTexCoord = vTexCoord&lt;br /&gt;
	return vMatrix * vertex&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
function fssaturate() : Shader -- Fragment Shader&lt;br /&gt;
	local frad = (1 + sin(fTime)) * 0.5&lt;br /&gt;
	local frag = lF4(fColor) * texture2D(fTexture, fTexCoord)&lt;br /&gt;
	local coef = lF3(0.2125, 0.7154, 0.0721)&lt;br /&gt;
	local dp = dot(frag.rgb, coef)&lt;br /&gt;
	frag.rgb = mix(frag.rgb, frag.rgb / dp, frad)&lt;br /&gt;
	if (frag.a == 0.0) then discard() end&lt;br /&gt;
	return frag&lt;br /&gt;
end&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Once both functions are created, you pass them in &#039;&#039;&#039;Shader.lua&#039;&#039;&#039;:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
local saturate = Shader.lua(vssaturate, fssaturate, 0,&lt;br /&gt;
	{&lt;br /&gt;
	{name = &amp;quot;vMatrix&amp;quot;, type = Shader.CMATRIX, sys = Shader.SYS_WVP, vertex = true},&lt;br /&gt;
	{name = &amp;quot;fColor&amp;quot;, type = Shader.CFLOAT4, sys = Shader.SYS_COLOR, vertex = false},&lt;br /&gt;
	{name = &amp;quot;fTexture&amp;quot;, type = Shader.CTEXTURE, vertex = false},&lt;br /&gt;
	{name = &amp;quot;fTextureInfo&amp;quot;, type = Shader.CFLOAT4, sys = Shader.SYS_TEXTUREINFO, vertex = false},&lt;br /&gt;
	{name = &amp;quot;fTime&amp;quot;, type = Shader.CFLOAT, sys = Shader.SYS_TIMER, vertex = false},&lt;br /&gt;
	},&lt;br /&gt;
	{&lt;br /&gt;
	{name = &amp;quot;vVertex&amp;quot;, type = Shader.DFLOAT, mult = 2, slot = 0, offset = 0},&lt;br /&gt;
	{name = &amp;quot;vColor&amp;quot;, type = Shader.DUBYTE, mult = 4, slot = 1, offset = 0},&lt;br /&gt;
	{name = &amp;quot;vTexCoord&amp;quot;, type = Shader.DFLOAT, mult = 2, slot = 2, offset = 0},&lt;br /&gt;
	},&lt;br /&gt;
	{&lt;br /&gt;
	{name = &amp;quot;fTexCoord&amp;quot;, type = Shader.CFLOAT2},&lt;br /&gt;
	}&lt;br /&gt;
)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Changing Uniforms/Constants ===&lt;br /&gt;
In order to change the value of a uniform from Lua, you use the &#039;&#039;setConstant&#039;&#039; function on the Shader, it takes four arguments:&lt;br /&gt;
*the uniform name&lt;br /&gt;
*the type of data to set: [[Shader Constants|one of the Shader.Cxxx constants]]&lt;br /&gt;
*the number of elements of the given type to set (number)&lt;br /&gt;
*the actual data to set, either as a table or as multiple arguments&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
saturate:setConstant(&amp;quot;fSwitch&amp;quot;, Shader.CINT, 1, 0) -- set fSwitch value to be 0 (off)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
This will change the value of a Uniform for the whole Shader.&lt;br /&gt;
&lt;br /&gt;
You can also change the value of a Uniform on a sprite to sprite basis using [[Sprite:setShaderConstant]]:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
bmp:setShaderConstant(&amp;quot;fSwitch&amp;quot;, Shader.CINT, 1, 22) -- set fSwitch value to be 0 (on)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Associating a Shader to a Sprite ===&lt;br /&gt;
The Sprite API has a new call to deal with that: &#039;&#039;&#039;&#039;&#039;Sprite:setShader(shader)&#039;&#039;&#039;&#039;&#039; tells Gideros to use the specified shader for rendering the sprite. Setting back the shader to &#039;&#039;&#039;&#039;&#039;nil&#039;&#039;&#039;&#039;&#039; actually revert to the default shader.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
bmp:setShader(saturate)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Lua Shader Functions ===&lt;br /&gt;
&#039;&#039;&#039;(Please note that these functions may or may not be available, the Lua shader is still under development)&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;column-count:3;-moz-column-count:3;-webkit-column-count:3&amp;quot;&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Language Helper Functions|Language Helpers]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Conversion and Constructor Functions|Conversion and Constructors]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Angle and Trigonometry Functions|Angle and Trigonometry]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Exponential Functions|Exponential]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Common Functions|Common]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Geometric Functions|Geometric]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Matrix Functions|Matrix]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Vector Relational Functions|Vector Relational]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Texture Lookup Functions|Texture Lookup]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Fragment Processing Functions|Fragment Processing]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Noise Functions|Noise]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Geometry Functions|Geometric]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Restrictions ===&lt;br /&gt;
Don&#039;t rely on anything external, basically no globals except for attributes, uniforms and varying.&lt;br /&gt;
* No Do..While&lt;br /&gt;
* No Repeat..Until&lt;br /&gt;
* No tables. The only allowed form of table lookup is for vector component swizzling and access to uniform arrays&lt;br /&gt;
* No strings, userdata, etc. Basically only numbers are supported&lt;br /&gt;
* Mind your types! Although lua is not a typed language, shaders need types&lt;br /&gt;
* Always check on all platforms: Gideros will translate your lua code to GLSL,HLSL or MSL code, but some platforms are more strict than others about what you can write, or how many arguments a common function is supposed to take&lt;br /&gt;
&lt;br /&gt;
=== Lua Shader Examples ===&lt;br /&gt;
&#039;&#039;&#039;[[Lua Shader Examples]]&#039;&#039;&#039;&amp;lt;/br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Further Reading ===&lt;br /&gt;
OpenGL Shading Language: &#039;&#039;&#039;https://www.khronos.org/opengl/wiki/OpenGL_Shading_Language&#039;&#039;&#039;&amp;lt;/br&amp;gt;&lt;br /&gt;
Common compatibility pitfalls: &#039;&#039;&#039;https://www.opengl.org/wiki/GLSL_:_common_mistakes&#039;&#039;&#039;&amp;lt;/br&amp;gt;&lt;br /&gt;
The Book of Shaders: &#039;&#039;&#039;https://thebookofshaders.com/&#039;&#039;&#039;&amp;lt;/br&amp;gt;&lt;br /&gt;
ShaderToy: &#039;&#039;&#039;https://www.shadertoy.com/&#039;&#039;&#039;&amp;lt;/br&amp;gt;&lt;br /&gt;
GH: &#039;&#039;&#039;https://github.com/mattdesl/lwjgl-basics/wiki/Shaders&#039;&#039;&#039;&amp;lt;/br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{SHADERS}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Sprite:setLayoutConstraints&amp;diff=23898</id>
		<title>Sprite:setLayoutConstraints</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Sprite:setLayoutConstraints&amp;diff=23898"/>
		<updated>2024-11-06T11:10:41Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* Description */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2018.9&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[Sprite]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
 Gideros layout system is heavily based on Java GridBagLayout principle. See here for more explanation &#039;&#039;&#039;https://www.math.uni-hamburg.de/doc/java/tutorial/uiswing/layout/gridbag.html&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
This function specifies the child placement rules within the grid defined on its parent by [[Sprite:setLayoutParameters]].&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
Sprite:setLayoutConstraints(constraints)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Specifying a &#039;&#039;&#039;nil&#039;&#039;&#039; table will clear layout constraints.&lt;br /&gt;
&lt;br /&gt;
 &#039;&#039;&#039;When a Sprite is resized by the layout system, an &#039;&#039;Event.LAYOUT_RESIZED&#039;&#039; is triggered&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;TODO&#039;&#039;&#039;: add/reorder/document missing fields from&lt;br /&gt;
*&#039;&#039;&#039;https://github.com/gideros/gideros/blob/e75e76c2857f8d8892c2383cea97fff174ff9a96/2dsg/gridbaglayout.h#L220&#039;&#039;&#039;&lt;br /&gt;
*&#039;&#039;&#039;https://github.com/gideros/gideros/blob/e75e76c2857f8d8892c2383cea97fff174ff9a96/luabinding/spritebinder.cpp#L786&#039;&#039;&#039;&lt;br /&gt;
*&#039;&#039;&#039;...&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
The constraint table can contain the following fields:&lt;br /&gt;
* &#039;&#039;&#039;gridx&#039;&#039;&#039;: the 0-based index of the column the child must be placed into&lt;br /&gt;
* &#039;&#039;&#039;gridy&#039;&#039;&#039;: the 0-based index of the row the child must be placed into&lt;br /&gt;
* &#039;&#039;&#039;gridwidth&#039;&#039;&#039;: the number of column this child will take&lt;br /&gt;
* &#039;&#039;&#039;gridheight&#039;&#039;&#039;: the number of row this child will take&lt;br /&gt;
* &#039;&#039;&#039;gridRelative&#039;&#039;&#039;: if &#039;&#039;&#039;gridx&#039;&#039;&#039; and &#039;&#039;&#039;gridy&#039; are relative to the previous child&lt;br /&gt;
* &#039;&#039;&#039;weightx&#039;&#039;&#039;: the horizontal weight of the child. Used to distribute extra space among children&lt;br /&gt;
* &#039;&#039;&#039;weighty&#039;&#039;&#039;: the vertical weight of the child. Used to distribute extra space among children&lt;br /&gt;
* &#039;&#039;&#039;anchor&#039;&#039;&#039;: defines where the child should be placed inside its grid space. Can be: [[Sprite.LAYOUT_ANCHOR_NORTHWEST]], [[Sprite.LAYOUT_ANCHOR_NORTH]], [[Sprite.LAYOUT_ANCHOR_NORTHEAST]], [[Sprite.LAYOUT_ANCHOR_WEST]], [[Sprite.LAYOUT_ANCHOR_CENTER]], [[Sprite.LAYOUT_ANCHOR_EAST]], [[Sprite.LAYOUT_ANCHOR_SOUTHWEST]], [[Sprite.LAYOUT_ANCHOR_SOUTH]] or [[Sprite.LAYOUT_ANCHOR_SOUTHEAST]]&lt;br /&gt;
* &#039;&#039;&#039;anchorx&#039;&#039;&#039;: specifies relative placement of the child on X axis. anchor mustn&#039;t be set &#039;&#039;&#039;since 2020.7&#039;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&#039;anchory&#039;&#039;&#039;: specifies relative placement of the child on Y axis. anchor mustn&#039;t be set &#039;&#039;&#039;since 2020.7&#039;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&#039;fill&#039;&#039;&#039;: in which directions the child should be expanded to fit the grid space. Can be: [[Sprite.LAYOUT_FILL_NONE]], [[Sprite.LAYOUT_FILL_HORIZONTAL]], [[Sprite.LAYOUT_FILL_VERTICAL]] or [[Sprite.LAYOUT_FILL_BOTH]]&lt;br /&gt;
* &#039;&#039;&#039;fillX&#039;&#039;&#039;: filling amount in X direction (replace &#039;&#039;&#039;fill&#039;&#039;&#039;)  &lt;br /&gt;
* &#039;&#039;&#039;fillY&#039;&#039;&#039;: filling amount in Y direction (replace &#039;&#039;&#039;fill&#039;&#039;&#039;)  &lt;br /&gt;
* &#039;&#039;&#039;ipadx&#039;&#039;&#039;: internal horizontal padding&lt;br /&gt;
* &#039;&#039;&#039;ipady&#039;&#039;&#039;: internal vertical padding&lt;br /&gt;
* &#039;&#039;&#039;offsetx&#039;&#039;&#039;: final offset applied to the child on X axis, in logical units &#039;&#039;&#039;since 2020.7&#039;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&#039;offsety&#039;&#039;&#039;: final offset applied to the child on Y axis, in logical units &#039;&#039;&#039;since 2020.7&#039;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&#039;originx&#039;&#039;&#039;: final offset applied to the child on X axis, as a fraction of the child width &#039;&#039;&#039;since 2020.7&#039;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&#039;originy&#039;&#039;&#039;: final offset applied to the child on Y axis, as a fraction of the child height &#039;&#039;&#039;since 2020.7&#039;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&#039;minWidth&#039;&#039;&#039;: minimum width&lt;br /&gt;
* &#039;&#039;&#039;minHeight&#039;&#039;&#039;: minimum height&lt;br /&gt;
* &#039;&#039;&#039;prefWidth&#039;&#039;&#039;: preferred width&lt;br /&gt;
* &#039;&#039;&#039;prefHeight&#039;&#039;&#039;: preferred height&lt;br /&gt;
* &#039;&#039;&#039;width&#039;&#039;&#039;: short hand for setting both minWidth and prefWidth&lt;br /&gt;
* &#039;&#039;&#039;height&#039;&#039;&#039;: short hand for setting both minHeight and prefHeight&lt;br /&gt;
* &#039;&#039;&#039;extraw&#039;&#039;&#039;: extends this sprite&#039;s width by the following amount&lt;br /&gt;
* &#039;&#039;&#039;extrah&#039;&#039;&#039;: extends this sprite&#039;s height by the following amount&lt;br /&gt;
* &#039;&#039;&#039;shrink&#039;&#039;&#039;: allows grid shrinking &#039;&#039;&#039;since 2021.2&#039;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&#039;insetTop&#039;&#039;&#039;: the top margin&lt;br /&gt;
* &#039;&#039;&#039;insetLeft&#039;&#039;&#039;: the left margin&lt;br /&gt;
* &#039;&#039;&#039;insetBottom&#039;&#039;&#039;: the bottom margin&lt;br /&gt;
* &#039;&#039;&#039;insetRight&#039;&#039;&#039;: the right margin&lt;br /&gt;
* &#039;&#039;&#039;insets&#039;&#039;&#039;: sets the above four margins to the same value at once &#039;&#039;&#039;since 2020.7&#039;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&#039;overflowMode&#039;&#039;&#039;: enable overflow mode&lt;br /&gt;
* &#039;&#039;&#039;hidePriority&#039;&#039;&#039;: hide this child by priority over others&lt;br /&gt;
* &#039;&#039;&#039;aspectRatio&#039;&#039;&#039;: when filling, restricts the computed size to fit the given aspect ratio&lt;br /&gt;
* &#039;&#039;&#039;optimizeSize&#039;&#039;&#039;: shrink back the child to its really used size&lt;br /&gt;
* &#039;&#039;&#039;group&#039;&#039;&#039;: layout all this sprite&#039;s children as if they were on this grid&lt;br /&gt;
* &#039;&#039;&#039;autoClip&#039;&#039;&#039;: clip this sprite according to computed bounds&lt;br /&gt;
* &#039;&#039;&#039;contentAspectRatio&#039;&#039;&#039;: when filling, restricts the computed size so that inner size fits the given aspect ratio&lt;br /&gt;
&lt;br /&gt;
=== Parameters ===&lt;br /&gt;
&#039;&#039;&#039;constraints&#039;&#039;&#039;: (table) table of layout constraints&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Examples ===&lt;br /&gt;
&#039;&#039;&#039;Example&#039;&#039;&#039;: pixels&lt;br /&gt;
&lt;br /&gt;
&amp;lt;gallery widths=136px heights=240px&amp;gt;Layout parameters example.png&amp;lt;/gallery&amp;gt;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
-- LAYOUT CONSTRAINTS @Nanocore&lt;br /&gt;
-- BUTTONS HOLDER&lt;br /&gt;
local myholder = Pixel.new(0x0, 0.5, 256, 256)&lt;br /&gt;
myholder:setPosition(8, 8)&lt;br /&gt;
myholder:setLayoutParameters({&lt;br /&gt;
	columnWeights = {1, 1, 1}, -- 3 columns&lt;br /&gt;
	rowWeights = {1, 1, 1, 1}, -- 4 rows&lt;br /&gt;
	columnWidths = {32, 32, 32}, -- min columns width&lt;br /&gt;
	rowHeights = {32, 32, 32, 32}, -- min rows height&lt;br /&gt;
})&lt;br /&gt;
&lt;br /&gt;
-- BUTTONS&lt;br /&gt;
local mybtn1 = Pixel.new(0xff0000, 1, 32, 32)&lt;br /&gt;
mybtn1:setLayoutConstraints({&lt;br /&gt;
	gridx = 0,&lt;br /&gt;
	gridy = 0,&lt;br /&gt;
	gridwidth = 2,&lt;br /&gt;
	gridheight = 2,&lt;br /&gt;
	anchor = Sprite.LAYOUT_ANCHOR_NORTHWEST,&lt;br /&gt;
	fill = Sprite.LAYOUT_FILL_BOTH,&lt;br /&gt;
})&lt;br /&gt;
myholder:addChild(mybtn1)&lt;br /&gt;
&lt;br /&gt;
local mybtn2 = Pixel.new(0x00ff00, 1, 32, 32)&lt;br /&gt;
mybtn2:setLayoutConstraints({&lt;br /&gt;
	gridx = 1,&lt;br /&gt;
	gridy = 2,&lt;br /&gt;
	gridwidth = 1,&lt;br /&gt;
	anchor = Sprite.LAYOUT_ANCHOR_NORTHWEST,&lt;br /&gt;
	fill = Sprite.LAYOUT_FILL_VERTICAL,&lt;br /&gt;
})&lt;br /&gt;
myholder:addChild(mybtn2)&lt;br /&gt;
&lt;br /&gt;
local mybtn3 = Pixel.new(0x0000ff, 1, 32, 32)&lt;br /&gt;
mybtn3:setLayoutConstraints({&lt;br /&gt;
	gridx = 2,&lt;br /&gt;
	gridy = 3,&lt;br /&gt;
	gridwidth = 1,&lt;br /&gt;
	anchor = Sprite.LAYOUT_ANCHOR_NORTHWEST,&lt;br /&gt;
	fill = Sprite.LAYOUT_FILL_BOTH,&lt;br /&gt;
})&lt;br /&gt;
myholder:addChild(mybtn3)&lt;br /&gt;
&lt;br /&gt;
-- ADD TO STAGE&lt;br /&gt;
stage:addChild(myholder)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== See also ===&lt;br /&gt;
&#039;&#039;&#039;[[Sprite:setLayoutParameters]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{{Sprite}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Application:get&amp;diff=23888</id>
		<title>Application:get</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Application:get&amp;diff=23888"/>
		<updated>2024-11-04T16:37:51Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* Compatibility table */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2015.7&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[Application]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Returns the state of the desktop setting provided as string parameter.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
varies = application:get(setting)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Parameters ===&lt;br /&gt;
&#039;&#039;&#039;setting&#039;&#039;&#039; (string) the name of the desktop setting&lt;br /&gt;
&lt;br /&gt;
=== Return values ===&lt;br /&gt;
&#039;&#039;&#039;Returns&#039;&#039;&#039; (varies) the value(s) of the setting&lt;br /&gt;
&lt;br /&gt;
=== &#039;&#039;&#039;Compatibility table&#039;&#039;&#039; ===&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot; style=&amp;quot;text-align: center;&amp;quot;&lt;br /&gt;
!!!QT!!Win32!!UWP!!Android!!Apple MacOS!!Apple iOS!!Apple tvOS!!Linux!!HTML&lt;br /&gt;
|-&lt;br /&gt;
|batteryLevel||||||||X||||X||||||&lt;br /&gt;
|-&lt;br /&gt;
|clipboard||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|commandLine||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|currentUrl||||||||||||||||||X&lt;br /&gt;
|-&lt;br /&gt;
|cursorPosition||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|directory||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|documentDirectory||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|openDirectoryDialog||X||X||X||||X||||||||&lt;br /&gt;
|-&lt;br /&gt;
|openFileDialog||X||X||X||||X||||||||&lt;br /&gt;
|-&lt;br /&gt;
|pathfileexists||?||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|saveFileDialog||X||X||X||||X||||||||&lt;br /&gt;
|-&lt;br /&gt;
|screenSize||X||X||X||||||||||X||X&lt;br /&gt;
|-&lt;br /&gt;
|temporaryDirectory||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|windowPosition||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|windowSize||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|windowTitle||X||X||||||||||||||X&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== Examples ===&lt;br /&gt;
&#039;&#039;&#039;Prints a list of all available settings&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:get(&amp;quot;help&amp;quot;))&lt;br /&gt;
--[[&lt;br /&gt;
	Accepted value for Desktop&#039;s application:get()&lt;br /&gt;
	- [x,y] windowPosition&lt;br /&gt;
	- [w,h] windowSize&lt;br /&gt;
	- [w,h] screenSize&lt;br /&gt;
	- [x,y] cursorPosition&lt;br /&gt;
	- [text] clipboard&lt;br /&gt;
	- [text] windowTitle&lt;br /&gt;
	- [path] directory(where//help)&lt;br /&gt;
	- [path] openDirectoryDialog(title|path//help)&lt;br /&gt;
	- [path] openFileDialog(title|path|extensions//help)&lt;br /&gt;
	- [path] saveFileDialog(title|path|extensions//help)&lt;br /&gt;
	- [path] documentDirectory&lt;br /&gt;
	- [path] temporaryDirectory&lt;br /&gt;
	0&lt;br /&gt;
]]&lt;br /&gt;
print(&amp;quot;\n&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
print(application:get(&amp;quot;directory&amp;quot;, &amp;quot;help&amp;quot;))&lt;br /&gt;
--[[&lt;br /&gt;
	Accepted value for directory :&lt;br /&gt;
	- executable&lt;br /&gt;
	- document&lt;br /&gt;
	- desktop&lt;br /&gt;
	- temporary&lt;br /&gt;
	- data&lt;br /&gt;
	- music&lt;br /&gt;
	- movies&lt;br /&gt;
	- pictures&lt;br /&gt;
	- cache&lt;br /&gt;
	- download&lt;br /&gt;
	- home&lt;br /&gt;
	0&lt;br /&gt;
]]&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Various examples&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:get(&amp;quot;windowTitle&amp;quot;))&lt;br /&gt;
print(application:get(&amp;quot;documentDirectory&amp;quot;))&lt;br /&gt;
print(application:get(&amp;quot;temporaryDirectory&amp;quot;))&lt;br /&gt;
&lt;br /&gt;
-- get screen size&lt;br /&gt;
screenwidth, screenheight = application:get(&amp;quot;screenSize&amp;quot;) -- the actual user screen size!&lt;br /&gt;
myappleft, myapptop, myappright, myappbot = application:getLogicalBounds()&lt;br /&gt;
myappwidth, myappheight = myappright - myappleft, myappbot - myapptop&lt;br /&gt;
application:set(&amp;quot;windowPosition&amp;quot;, (screenwidth - myappwidth)/2, (screenheight - myappheight)/2) -- center the app&lt;br /&gt;
application:set(&amp;quot;windowTitle&amp;quot;, &amp;quot;MY TITLE&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
-- get the user download folder path&lt;br /&gt;
print(application:get(&amp;quot;directory&amp;quot;, &amp;quot;download&amp;quot;)) -- prints c:/Users/xxx/Downloads&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;File dialog open directory&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
local path = application:get(&amp;quot;openDirectoryDialog&amp;quot;, &amp;quot;Title&amp;quot;, &amp;quot;c:/tmp/&amp;quot;) -- &amp;quot;title&amp;quot;, &amp;quot;path&amp;quot;&lt;br /&gt;
local path = application:get(&amp;quot;openDirectoryDialog&amp;quot;, &amp;quot;Title&amp;quot;, &amp;quot;c:\\tmp\\&amp;quot;) -- &amp;quot;title&amp;quot;, &amp;quot;path&amp;quot; win32&lt;br /&gt;
print(path) -- on cancel, returns nil for win32 and &amp;quot;&amp;quot; for other systems&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;File dialog open file&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
local path = application:get(&amp;quot;openFileDialog&amp;quot;, &amp;quot;My Title&amp;quot;, &amp;quot;c:\\&amp;quot;, &amp;quot;Images (*.png *.jp*g);; 3D (*.obj *.fbx)&amp;quot;)&lt;br /&gt;
print(path) -- on cancel, returns nil for win32 and &amp;quot;&amp;quot; for other systems&lt;br /&gt;
&lt;br /&gt;
-- file dialogs on win32 should use a delay Timer.delayedCall or Core.asyncCall&lt;br /&gt;
self.tiled_ui.btnBrowse:addEventListener(&amp;quot;clicked&amp;quot;, function()&lt;br /&gt;
	Core.asyncCall(self.browse, self)&lt;br /&gt;
end)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;File dialog save file&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
-- first we choose the destination&lt;br /&gt;
local path = application:get(&amp;quot;saveFileDialog&amp;quot;, &amp;quot;Title&amp;quot;, &amp;quot;c:/tmp/&amp;quot;, &amp;quot;Text (*.txt);; Image (*.jpg)&amp;quot;) -- &amp;quot;title&amp;quot;, &amp;quot;path&amp;quot;, &amp;quot;extensions&amp;quot;&lt;br /&gt;
-- and we save some data to it&lt;br /&gt;
if path ~= &amp;quot;&amp;quot; then -- on cancel, returns nil for win32 and &amp;quot;&amp;quot; for other systems&lt;br /&gt;
	local srcf = io.open(&amp;quot;mytext.txt&amp;quot;, &amp;quot;rb&amp;quot;)&lt;br /&gt;
	local dstf = io.open(path, &amp;quot;wb&amp;quot;)&lt;br /&gt;
	local size = 2^13 -- good buffer size (8K)&lt;br /&gt;
	while true do&lt;br /&gt;
		local block = srcf:read(size)&lt;br /&gt;
		if not block then break end&lt;br /&gt;
		dstf:write(block)&lt;br /&gt;
	end&lt;br /&gt;
	srcf:close()&lt;br /&gt;
	dstf:close()&lt;br /&gt;
end&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Path File Exists&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
-- Path File Exists for Windows 64&lt;br /&gt;
-- tests folder path (nil=doesn&#039;t exist, 1=exists)&lt;br /&gt;
if application:get(&amp;quot;pathfileexists&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;/Folder01&amp;quot;) == nil then&lt;br /&gt;
	application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;), &amp;quot;Folder01&amp;quot;)&lt;br /&gt;
	application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;/Folder01&amp;quot;, &amp;quot;subfolder01&amp;quot;)&lt;br /&gt;
	application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;/Folder01&amp;quot;, &amp;quot;subfolder02&amp;quot;)&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
-- Path File Exists for win32&lt;br /&gt;
-- tests folder path (nil=doesn&#039;t exist, 1=exists)&lt;br /&gt;
if application:get(&amp;quot;pathfileexists&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;\\Folder01&amp;quot;) == nil then&lt;br /&gt;
	-- create it&lt;br /&gt;
	application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;\\Folder01&amp;quot;)&lt;br /&gt;
end&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Application}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Hgy29_SandBox&amp;diff=23476</id>
		<title>Hgy29 SandBox</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Hgy29_SandBox&amp;diff=23476"/>
		<updated>2024-05-13T13:56:58Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Gideros SDK]]&lt;br /&gt;
&lt;br /&gt;
[[Tutorial - Making a 2D space shooter game]]&lt;br /&gt;
&lt;br /&gt;
[[Hgy29 WidgetKit WIP]]&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;3D Collision&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{{#widget:GApp|app=3DCollisions.gapp|plugins=json,reactphysics3d|width=480|height=320|auto=1}}&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;3D Animation&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{{#widget:GApp|app=3D-Anim.GApp|plugins=json|width=480|height=320}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Hgy29_SandBox&amp;diff=23475</id>
		<title>Hgy29 SandBox</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Hgy29_SandBox&amp;diff=23475"/>
		<updated>2024-05-13T13:56:49Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Gideros SDK]]&lt;br /&gt;
[[Tutorial - Making a 2D space shooter game]]&lt;br /&gt;
&lt;br /&gt;
[[Hgy29 WidgetKit WIP]]&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;3D Collision&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{{#widget:GApp|app=3DCollisions.gapp|plugins=json,reactphysics3d|width=480|height=320|auto=1}}&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;3D Animation&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{{#widget:GApp|app=3D-Anim.GApp|plugins=json|width=480|height=320}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Sprite:setStencilOperation&amp;diff=22774</id>
		<title>Sprite:setStencilOperation</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Sprite:setStencilOperation&amp;diff=22774"/>
		<updated>2023-10-27T07:04:58Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2017.6&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[Sprite]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Allows to set a stencil operation to be used when drawing this sprite.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
Sprite:setStencilOperation(op)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
The &#039;&#039;&#039;op&#039;&#039;&#039; table can contain the following fields:&lt;br /&gt;
*&#039;&#039;&#039;stencilClear&#039;&#039;&#039;: (boolean) whether the stencil should be cleared beforehand&lt;br /&gt;
*&#039;&#039;&#039;stencilMask&#039;&#039;&#039;: (integer) the mask value used in stencil operations&lt;br /&gt;
*&#039;&#039;&#039;stencilWriteMask&#039;&#039;&#039;: (integer) the mask value used when writing to stencil&lt;br /&gt;
*&#039;&#039;&#039;stencilClearValue&#039;&#039;&#039;: (integer) the value used to fill then stencil when clearing&lt;br /&gt;
*&#039;&#039;&#039;stencilRef&#039;&#039;&#039;: (integer) the reference value used in stencil operations&lt;br /&gt;
*&#039;&#039;&#039;stencilFunc&#039;&#039;&#039;: (integer) the stencil function to use&lt;br /&gt;
*&#039;&#039;&#039;stencilFail&#039;&#039;&#039;: (integer) the stencil operation when stencil test failed&lt;br /&gt;
*&#039;&#039;&#039;depthFail&#039;&#039;&#039;: (integer) the stencil operation when depth test failed&lt;br /&gt;
*&#039;&#039;&#039;depthPass&#039;&#039;&#039;: (integer) the stencil operation when depth test has passed&lt;br /&gt;
*&#039;&#039;&#039;depthMask&#039;&#039;&#039;: (boolean) whether depth buffer should be written or not (true by default)&lt;br /&gt;
&lt;br /&gt;
Stencil function and operations code are defined in Sprite.STENCIL_xxx fields and correspond to the GL_xxx relevant values in OpenGL stencil documentation https://www.khronos.org/registry/OpenGL-Refpages/gl4/html/glStencilFunc.xhtml.&lt;br /&gt;
&lt;br /&gt;
=== Parameters ===&lt;br /&gt;
&#039;&#039;&#039;op&#039;&#039;&#039;: (table) a table containing the stencil operation settings, or nil to disable stencil&lt;br /&gt;
&lt;br /&gt;
=== Example ===&lt;br /&gt;
&#039;&#039;&#039;A glowing ticket effect&#039;&#039;&#039;:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
-- STENCILOPERATION @hgy29&lt;br /&gt;
local bg = Bitmap.new(Texture.new(&amp;quot;gfx/vip/background.png&amp;quot;))&lt;br /&gt;
local ticket = Bitmap.new(Texture.new(&amp;quot;gfx/vip/ticket.png&amp;quot;))&lt;br /&gt;
local text = Bitmap.new(Texture.new(&amp;quot;gfx/vip/text.png&amp;quot;))&lt;br /&gt;
local fx1 = Bitmap.new(Texture.new(&amp;quot;gfx/vip/fx1.png&amp;quot;))&lt;br /&gt;
local fx2 = Bitmap.new(Texture.new(&amp;quot;gfx/vip/fx2.png&amp;quot;))&lt;br /&gt;
 &lt;br /&gt;
stage:addChild(bg) bg:setScale(0.5)&lt;br /&gt;
stage:addChild(ticket) ticket:setPosition(80,20) ticket:setScale(0.5)&lt;br /&gt;
ticket:addChild(fx1) fx1:setX(-100)&lt;br /&gt;
fx1:addChild(fx2) fx2:setX(-100)&lt;br /&gt;
ticket:addChild(text)&lt;br /&gt;
 &lt;br /&gt;
-- Use auto layout on ticket to center text automatically&lt;br /&gt;
ticket:setLayoutParameters{ rowWeights = {1}, columnWeights = {1} }&lt;br /&gt;
text:setLayoutConstraints{}&lt;br /&gt;
&lt;br /&gt;
-- Use stencil for masking glow:&lt;br /&gt;
-- 1) Clear stencil and set it to &#039;1&#039; for every pixel drawn on &#039;ticket&#039;&lt;br /&gt;
ticket:setStencilOperation{&lt;br /&gt;
	stencilClear = true, stenciMask = 1, stencilWriteMask = 1, stencilRef = 1,&lt;br /&gt;
	stencilFunc = Sprite.STENCIL_ALWAYS, depthPass = Sprite.STENCIL_REPLACE&lt;br /&gt;
}&lt;br /&gt;
--2) Only draw fx1/fx2 if stencil isn&#039;t 0&lt;br /&gt;
fx1:setStencilOperation{&lt;br /&gt;
	stencilClear = false, stencilMask = 1, stencilRef = 0,&lt;br /&gt;
	stencilFunc = Sprite.STENCIL_NOTEQUAL&lt;br /&gt;
}&lt;br /&gt;
 &lt;br /&gt;
local dir = 1&lt;br /&gt;
stage:addEventListener(Event.ENTER_FRAME, function()&lt;br /&gt;
	if fx1:getX() &amp;gt; 450 then dir = -1&lt;br /&gt;
	elseif fx1:getX() &amp;lt; -100 then dir = 1&lt;br /&gt;
	end&lt;br /&gt;
	fx1:setX(fx1:getX() + dir*5)&lt;br /&gt;
end)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Sprite}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Application:set&amp;diff=22773</id>
		<title>Application:set</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Application:set&amp;diff=22773"/>
		<updated>2023-10-27T07:00:27Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* Compatibility table */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2015.7&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[Application]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Sets the state of the desktop setting provided as string parameter.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
application:set(setting, value)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;new&#039;&#039;&#039; Gideros 2022.1: implement &#039;&#039;&#039;application:set(&amp;quot;wintabMode&amp;quot;)&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
=== Parameters ===&lt;br /&gt;
&#039;&#039;&#039;setting&#039;&#039;&#039;: (string) the desktop setting&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;value&#039;&#039;&#039;: (varies) the new setting value(s)&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== &#039;&#039;&#039;Compatibility table&#039;&#039;&#039; ===&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot; style=&amp;quot;text-align: center;&amp;quot;&lt;br /&gt;
!!!QT!!Win32!!UWP!!Android!!Apple MacOS!!Apple iOS!!Apple tvOS!!Linux!!HTML&lt;br /&gt;
|-&lt;br /&gt;
|clipboard||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|cursor||X||X||X||||X||||||X||X&lt;br /&gt;
|-&lt;br /&gt;
|cursorPosition||X||X||||||||||||||&lt;br /&gt;
|-&lt;br /&gt;
|documentDirectory||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|maximumSize||X||||||||||||||||&lt;br /&gt;
|-&lt;br /&gt;
|minimumSize||X||||||||||||||||&lt;br /&gt;
|-&lt;br /&gt;
|mkDir||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|statusBar||||||||X||||X||||||&lt;br /&gt;
|-&lt;br /&gt;
|temporaryDirectory||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|windowColor||X||||||||||||||||&lt;br /&gt;
|-&lt;br /&gt;
|windowModel||X||||||||||||||||&lt;br /&gt;
|-&lt;br /&gt;
|windowPosition||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|windowSize||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|windowTitle||X||X||||||||||||X||X&lt;br /&gt;
|-&lt;br /&gt;
|wintabMode||X||||||||||||||||&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== List of available parameters and settings ===&lt;br /&gt;
To get a list of parameters that can be set use:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:set(&amp;quot;help&amp;quot;))&lt;br /&gt;
--[[&lt;br /&gt;
- windowPosition(x,y)&lt;br /&gt;
- windowSize(w,h)&lt;br /&gt;
- minimumSize(w,h)&lt;br /&gt;
- maximumSize(w,h)&lt;br /&gt;
- windowColor(r,g,b)&lt;br /&gt;
- windowTitle(text)&lt;br /&gt;
- windowModel(type//help)&lt;br /&gt;
- cursor(type//help)&lt;br /&gt;
- cursorPosition(x,y)&lt;br /&gt;
- clipboard(text)&lt;br /&gt;
- mkdir(path|dirName//help)&lt;br /&gt;
- documentDirectory(path)&lt;br /&gt;
- temporaryDirectory(path)&lt;br /&gt;
]]&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To get help for individual settings use:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:set(&amp;quot;cursor&amp;quot;,&amp;quot;help&amp;quot;)) -- eg: cursor&lt;br /&gt;
--[[&lt;br /&gt;
Accepted value for cursor :&lt;br /&gt;
- arrow&lt;br /&gt;
- upArrow&lt;br /&gt;
- cross&lt;br /&gt;
- wait&lt;br /&gt;
- IBeam&lt;br /&gt;
- sizeVer&lt;br /&gt;
- sizeHor&lt;br /&gt;
- sizeBDiag&lt;br /&gt;
- sizeFDiag&lt;br /&gt;
- sizeAll&lt;br /&gt;
- blank -- not available on win32&lt;br /&gt;
- splitV&lt;br /&gt;
- splitH&lt;br /&gt;
- pointingHand&lt;br /&gt;
- forbidden&lt;br /&gt;
- whatsThis&lt;br /&gt;
- busy&lt;br /&gt;
- openHand -- not available on win32&lt;br /&gt;
- closedHand -- not available on win32&lt;br /&gt;
- dragCopy -- not available on win32&lt;br /&gt;
- dragMove -- not available on win32&lt;br /&gt;
- dragLink -- not available on win32&lt;br /&gt;
]]&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:set(&amp;quot;windowModel&amp;quot;,&amp;quot;help&amp;quot;)) -- eg: window mode&lt;br /&gt;
--[[&lt;br /&gt;
Accepted value for windowModel :&lt;br /&gt;
- reset&lt;br /&gt;
- stayOnTop&lt;br /&gt;
- stayOnBottom&lt;br /&gt;
- frameless&lt;br /&gt;
- noTitleBar&lt;br /&gt;
- noButton&lt;br /&gt;
- onlyMinimize&lt;br /&gt;
- onlyMaximize&lt;br /&gt;
- onlyClose&lt;br /&gt;
- noMinimize&lt;br /&gt;
- noMaximize&lt;br /&gt;
- noClose&lt;br /&gt;
- helpButton&lt;br /&gt;
]]&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Examples ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
application:set(&amp;quot;windowPosition&amp;quot;, 64, 64)&lt;br /&gt;
application:set(&amp;quot;windowColor&amp;quot;, 0, 0, 0)&lt;br /&gt;
application:set(&amp;quot;windowTitle&amp;quot;, &amp;quot;My lovely window title&amp;quot;)&lt;br /&gt;
application:set(&amp;quot;cursor&amp;quot;, &amp;quot;openHand&amp;quot;)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
-- global app size&lt;br /&gt;
myappleft, myapptop, myappright, myappbot = application:getLogicalBounds()&lt;br /&gt;
myappwidth, myappheight = myappright - myappleft, myappbot - myapptop&lt;br /&gt;
&lt;br /&gt;
if application:getDeviceInfo() == &amp;quot;Windows&amp;quot; and not application:isPlayerMode() then&lt;br /&gt;
	application:set(&amp;quot;windowPosition&amp;quot;, myappwidth * 1.2, 16)&lt;br /&gt;
	application:set(&amp;quot;windowModel&amp;quot;, &amp;quot;onlyClose&amp;quot;)&lt;br /&gt;
--	application:set(&amp;quot;windowModel&amp;quot;, &amp;quot;noMaximize&amp;quot;) -- doesn&#039;t work for me!&lt;br /&gt;
	application:set(&amp;quot;windowTitle&amp;quot;, &amp;quot;App Title&amp;quot;)&lt;br /&gt;
	application:set(&amp;quot;minimumSize&amp;quot;, myappwidth, myappheight)&lt;br /&gt;
	application:set(&amp;quot;maximumSize&amp;quot;, myappwidth, myappheight)&lt;br /&gt;
	application:set(&amp;quot;windowColor&amp;quot;, 0, 0, 0)&lt;br /&gt;
end&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;,&amp;quot;executable&amp;quot;)..&amp;quot;|dirName&amp;quot;)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Application}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=MediaWiki:Sidebar&amp;diff=22569</id>
		<title>MediaWiki:Sidebar</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=MediaWiki:Sidebar&amp;diff=22569"/>
		<updated>2023-09-22T06:08:46Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;br /&gt;
** Special:MyLanguage/Welcome!|mainpage-description&lt;br /&gt;
** Special:RecentChanges|recentchanges&lt;br /&gt;
** Special:Random|randompage&lt;br /&gt;
** https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents|help&lt;br /&gt;
&lt;br /&gt;
* SEARCH&lt;br /&gt;
* TOOLBOX&lt;br /&gt;
* LANGUAGES&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=MediaWiki:Sidebar&amp;diff=22568</id>
		<title>MediaWiki:Sidebar</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=MediaWiki:Sidebar&amp;diff=22568"/>
		<updated>2023-09-22T06:08:10Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* navigation&lt;br /&gt;
** Welcome|Welcome&lt;br /&gt;
** Downloads|Downloads&lt;br /&gt;
** Help|Contact and Help&lt;br /&gt;
&lt;br /&gt;
** Special:MyLanguage/Welcome!|mainpage-description&lt;br /&gt;
** Special:RecentChanges|recentchanges&lt;br /&gt;
** Special:Random|randompage&lt;br /&gt;
** https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents|help&lt;br /&gt;
&lt;br /&gt;
* SEARCH&lt;br /&gt;
* TOOLBOX&lt;br /&gt;
* LANGUAGES&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=File:3D-Maze-Pebble.GApp&amp;diff=22524</id>
		<title>File:3D-Maze-Pebble.GApp</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=File:3D-Maze-Pebble.GApp&amp;diff=22524"/>
		<updated>2023-09-15T09:40:09Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Welcome!&amp;diff=22522</id>
		<title>Welcome!</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Welcome!&amp;diff=22522"/>
		<updated>2023-09-15T09:34:16Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* GIDEROS PEBBLES */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS API REFERENCES&#039;&#039;&#039; ==&lt;br /&gt;
{|-&lt;br /&gt;
|style=&amp;quot;width: 33%;&amp;quot;|&lt;br /&gt;
::::::::::::&lt;br /&gt;
===&#039;&#039;&#039;[[Lua API]]&#039;&#039;&#039;===&lt;br /&gt;
=== &#039;&#039;&#039; &amp;amp;nbsp; &#039;&#039;&#039; ===&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 33%;&amp;quot;|&lt;br /&gt;
::::::::::::&lt;br /&gt;
===&#039;&#039;&#039;[[Main API]]&#039;&#039;&#039;===&lt;br /&gt;
=== &#039;&#039;&#039; &amp;amp;nbsp; &#039;&#039;&#039; ===&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 33%;&amp;quot;|&lt;br /&gt;
::::::::::::&lt;br /&gt;
===&#039;&#039;&#039;[[Plugins]]&#039;&#039;&#039;===&lt;br /&gt;
=== &#039;&#039;&#039; &amp;amp;nbsp; &#039;&#039;&#039; ===&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS GUIDES AND TUTORIALS&#039;&#039;&#039; ==&lt;br /&gt;
{|-&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Tutorials ===&lt;br /&gt;
[[Lua to Luau conversion guide]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Start Here|You can start here]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Article Tutorials]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Video Tutorials]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== From the Forum ===&lt;br /&gt;
[[Examples|Forum Snippets and more...]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[ImGui Examples|ImGui Snippets]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Links ===&lt;br /&gt;
[[Made With Gideros]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Developer YouTube Channels|Developers YouTube Channels]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Ultimate Guide ===&lt;br /&gt;
[[Introduction]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Gideros Studio]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Getting Started]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Gideros Player]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Your first code]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Introduction to Lua]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Classes in Gideros]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Scene Management]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Introduction to Graphics]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Introduction to Graphics Shapes]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Introduction to Fonts]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Playing Sound and Music]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Event system]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[File system]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Profiling]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Hardware and OS]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Exporting to a Player|Exporting your project (&#039;&#039;&#039;Xbox, ...&#039;&#039;&#039;)]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Making a Plugin]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Latest ===&lt;br /&gt;
[[Latest Release|Latest Gideros]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Latest Luau]]&amp;lt;br/&amp;gt;&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS SHORTS&#039;&#039;&#039; ==&lt;br /&gt;
[[Short-Issue-1|#1 - June 2023 - Overheat]]&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS PEBBLES&#039;&#039;&#039; ==&lt;br /&gt;
[[Lua Shaders Pebbles|Lua Shaders]]&amp;lt;/br&amp;gt;&lt;br /&gt;
[[3D Pebbles|3D]]&amp;lt;/br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS 2D HELPERS&#039;&#039;&#039; ==&lt;br /&gt;
{|-&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== UI Classes ===&lt;br /&gt;
[[UI Buttons|UI Buttons]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[UI Color Picker|UI Color Picker]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[UI Scrollable List|UI Scrollable List]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[UI Slider|UI Sliders]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[UI Text|UI Text]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Game Helpers ===&lt;br /&gt;
[[Scene Manager|Scene Manager/Easing]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Game Camera]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Animated Sprite Factory|Animations (Sprite Sheets)]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Mobile Controls]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Tiled Map Editor|Tiled]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[CBump Template|CBump Template]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Plugins Helpers ===&lt;br /&gt;
[[Media Plugin]]&amp;lt;br/&amp;gt;&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS 3D HELPERS&#039;&#039;&#039; ==&lt;br /&gt;
{|-&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== ReactPhysics3D ===&lt;br /&gt;
[[3D Plane]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS ADVANCED&#039;&#039;&#039; ==&lt;br /&gt;
{|-&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Advanced ===&lt;br /&gt;
[[Writing Shaders]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;[[Lua Shaders]]&#039;&#039;&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Compiling Gideros Source]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Compiling Gideros Luau Source|Compiling Gideros Luau &#039;&#039;&#039;WIP&#039;&#039;&#039;]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[What Does What]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Helping With Documentation]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[CPlusPlus for Gideros Studio Help]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Wiki Special Links ===&lt;br /&gt;
[[Special:AllPages]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[All Classes and more]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Wiki Sandbox]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Welcome!&amp;diff=22519</id>
		<title>Welcome!</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Welcome!&amp;diff=22519"/>
		<updated>2023-09-15T09:31:44Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* GIDEROS PEBBLES */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS API REFERENCES&#039;&#039;&#039; ==&lt;br /&gt;
{|-&lt;br /&gt;
|style=&amp;quot;width: 33%;&amp;quot;|&lt;br /&gt;
::::::::::::&lt;br /&gt;
===&#039;&#039;&#039;[[Lua API]]&#039;&#039;&#039;===&lt;br /&gt;
=== &#039;&#039;&#039; &amp;amp;nbsp; &#039;&#039;&#039; ===&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 33%;&amp;quot;|&lt;br /&gt;
::::::::::::&lt;br /&gt;
===&#039;&#039;&#039;[[Main API]]&#039;&#039;&#039;===&lt;br /&gt;
=== &#039;&#039;&#039; &amp;amp;nbsp; &#039;&#039;&#039; ===&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 33%;&amp;quot;|&lt;br /&gt;
::::::::::::&lt;br /&gt;
===&#039;&#039;&#039;[[Plugins]]&#039;&#039;&#039;===&lt;br /&gt;
=== &#039;&#039;&#039; &amp;amp;nbsp; &#039;&#039;&#039; ===&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS GUIDES AND TUTORIALS&#039;&#039;&#039; ==&lt;br /&gt;
{|-&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Tutorials ===&lt;br /&gt;
[[Lua to Luau conversion guide]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Start Here|You can start here]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Article Tutorials]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Video Tutorials]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== From the Forum ===&lt;br /&gt;
[[Examples|Forum Snippets and more...]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[ImGui Examples|ImGui Snippets]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Links ===&lt;br /&gt;
[[Made With Gideros]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Developer YouTube Channels|Developers YouTube Channels]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Ultimate Guide ===&lt;br /&gt;
[[Introduction]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Gideros Studio]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Getting Started]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Gideros Player]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Your first code]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Introduction to Lua]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Classes in Gideros]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Scene Management]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Introduction to Graphics]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Introduction to Graphics Shapes]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Introduction to Fonts]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Playing Sound and Music]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Event system]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[File system]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Profiling]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Hardware and OS]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Exporting to a Player|Exporting your project (&#039;&#039;&#039;Xbox, ...&#039;&#039;&#039;)]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Making a Plugin]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Latest ===&lt;br /&gt;
[[Latest Release|Latest Gideros]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Latest Luau]]&amp;lt;br/&amp;gt;&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS SHORTS&#039;&#039;&#039; ==&lt;br /&gt;
[[Short-Issue-1|#1 - June 2023 - Overheat]]&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS PEBBLES&#039;&#039;&#039; ==&lt;br /&gt;
[[Lua Shaders Pebbles|Lua Shaders]]&amp;lt;/br&amp;gt;&lt;br /&gt;
[[3D Demos|3D Demos]]&amp;lt;/br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS 2D HELPERS&#039;&#039;&#039; ==&lt;br /&gt;
{|-&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== UI Classes ===&lt;br /&gt;
[[UI Buttons|UI Buttons]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[UI Color Picker|UI Color Picker]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[UI Scrollable List|UI Scrollable List]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[UI Slider|UI Sliders]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[UI Text|UI Text]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Game Helpers ===&lt;br /&gt;
[[Scene Manager|Scene Manager/Easing]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Game Camera]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Animated Sprite Factory|Animations (Sprite Sheets)]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Mobile Controls]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Tiled Map Editor|Tiled]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[CBump Template|CBump Template]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Plugins Helpers ===&lt;br /&gt;
[[Media Plugin]]&amp;lt;br/&amp;gt;&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS 3D HELPERS&#039;&#039;&#039; ==&lt;br /&gt;
{|-&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== ReactPhysics3D ===&lt;br /&gt;
[[3D Plane]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS ADVANCED&#039;&#039;&#039; ==&lt;br /&gt;
{|-&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Advanced ===&lt;br /&gt;
[[Writing Shaders]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;[[Lua Shaders]]&#039;&#039;&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Compiling Gideros Source]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Compiling Gideros Luau Source|Compiling Gideros Luau &#039;&#039;&#039;WIP&#039;&#039;&#039;]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[What Does What]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Helping With Documentation]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[CPlusPlus for Gideros Studio Help]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Wiki Special Links ===&lt;br /&gt;
[[Special:AllPages]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[All Classes and more]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Wiki Sandbox]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Welcome!&amp;diff=22518</id>
		<title>Welcome!</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Welcome!&amp;diff=22518"/>
		<updated>2023-09-15T09:31:25Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* GIDEROS PEBBLES */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS API REFERENCES&#039;&#039;&#039; ==&lt;br /&gt;
{|-&lt;br /&gt;
|style=&amp;quot;width: 33%;&amp;quot;|&lt;br /&gt;
::::::::::::&lt;br /&gt;
===&#039;&#039;&#039;[[Lua API]]&#039;&#039;&#039;===&lt;br /&gt;
=== &#039;&#039;&#039; &amp;amp;nbsp; &#039;&#039;&#039; ===&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 33%;&amp;quot;|&lt;br /&gt;
::::::::::::&lt;br /&gt;
===&#039;&#039;&#039;[[Main API]]&#039;&#039;&#039;===&lt;br /&gt;
=== &#039;&#039;&#039; &amp;amp;nbsp; &#039;&#039;&#039; ===&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 33%;&amp;quot;|&lt;br /&gt;
::::::::::::&lt;br /&gt;
===&#039;&#039;&#039;[[Plugins]]&#039;&#039;&#039;===&lt;br /&gt;
=== &#039;&#039;&#039; &amp;amp;nbsp; &#039;&#039;&#039; ===&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS GUIDES AND TUTORIALS&#039;&#039;&#039; ==&lt;br /&gt;
{|-&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Tutorials ===&lt;br /&gt;
[[Lua to Luau conversion guide]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Start Here|You can start here]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Article Tutorials]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Video Tutorials]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== From the Forum ===&lt;br /&gt;
[[Examples|Forum Snippets and more...]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[ImGui Examples|ImGui Snippets]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Links ===&lt;br /&gt;
[[Made With Gideros]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Developer YouTube Channels|Developers YouTube Channels]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Ultimate Guide ===&lt;br /&gt;
[[Introduction]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Gideros Studio]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Getting Started]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Gideros Player]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Your first code]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Introduction to Lua]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Classes in Gideros]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Scene Management]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Introduction to Graphics]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Introduction to Graphics Shapes]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Introduction to Fonts]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Playing Sound and Music]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Event system]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[File system]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Profiling]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Hardware and OS]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Exporting to a Player|Exporting your project (&#039;&#039;&#039;Xbox, ...&#039;&#039;&#039;)]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Making a Plugin]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Latest ===&lt;br /&gt;
[[Latest Release|Latest Gideros]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Latest Luau]]&amp;lt;br/&amp;gt;&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS SHORTS&#039;&#039;&#039; ==&lt;br /&gt;
[[Short-Issue-1|#1 - June 2023 - Overheat]]&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS PEBBLES&#039;&#039;&#039; ==&lt;br /&gt;
[[Lua Shaders Pebbles|Lua Shaders]]&lt;br /&gt;
[[3D Demos|3D Demos]]&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS 2D HELPERS&#039;&#039;&#039; ==&lt;br /&gt;
{|-&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== UI Classes ===&lt;br /&gt;
[[UI Buttons|UI Buttons]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[UI Color Picker|UI Color Picker]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[UI Scrollable List|UI Scrollable List]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[UI Slider|UI Sliders]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[UI Text|UI Text]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Game Helpers ===&lt;br /&gt;
[[Scene Manager|Scene Manager/Easing]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Game Camera]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Animated Sprite Factory|Animations (Sprite Sheets)]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Mobile Controls]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Tiled Map Editor|Tiled]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[CBump Template|CBump Template]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Plugins Helpers ===&lt;br /&gt;
[[Media Plugin]]&amp;lt;br/&amp;gt;&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS 3D HELPERS&#039;&#039;&#039; ==&lt;br /&gt;
{|-&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== ReactPhysics3D ===&lt;br /&gt;
[[3D Plane]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS ADVANCED&#039;&#039;&#039; ==&lt;br /&gt;
{|-&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Advanced ===&lt;br /&gt;
[[Writing Shaders]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;[[Lua Shaders]]&#039;&#039;&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Compiling Gideros Source]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Compiling Gideros Luau Source|Compiling Gideros Luau &#039;&#039;&#039;WIP&#039;&#039;&#039;]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[What Does What]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Helping With Documentation]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[CPlusPlus for Gideros Studio Help]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Wiki Special Links ===&lt;br /&gt;
[[Special:AllPages]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[All Classes and more]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Wiki Sandbox]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=MovieClip.getTweenFunction&amp;diff=22517</id>
		<title>MovieClip.getTweenFunction</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=MovieClip.getTweenFunction&amp;diff=22517"/>
		<updated>2023-08-31T06:59:51Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2023.9&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[MovieClip]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Retrieves a native tween/easing function by its name.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
(function) = MovieClip.getTweenFunction(name)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Parameters ===&lt;br /&gt;
&#039;&#039;&#039;name&#039;&#039;&#039;: (string) The name of the requested tween function&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Return values ===&lt;br /&gt;
&#039;&#039;&#039;Returns&#039;&#039;&#039; (function) the specified tween function, or linear tween function if name wasn&#039;t recognized&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{MovieClip}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=MovieClip.getTweenFunction&amp;diff=22516</id>
		<title>MovieClip.getTweenFunction</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=MovieClip.getTweenFunction&amp;diff=22516"/>
		<updated>2023-08-31T06:58:47Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: Created page with &amp;quot;__NOTOC__ &amp;#039;&amp;#039;&amp;#039;Available since:&amp;#039;&amp;#039;&amp;#039; Gideros 2023.9&amp;lt;br/&amp;gt; &amp;#039;&amp;#039;&amp;#039;Class:&amp;#039;&amp;#039;&amp;#039; MovieClip&amp;lt;br/&amp;gt;  === Description === Retrieves a native tween/easing function by its name. &amp;lt;syntaxhighligh...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2023.9&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[MovieClip]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Retrieves a native tween/easing function by its name.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
(function) = MovieClip.getTweenFunction(name)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Parameters ===&lt;br /&gt;
&#039;&#039;&#039;name&#039;&#039;&#039;: (string) The name of the requested tween function&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{MovieClip}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=MovieClip&amp;diff=22515</id>
		<title>MovieClip</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=MovieClip&amp;diff=22515"/>
		<updated>2023-08-31T06:55:46Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* Methods */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&amp;lt;!-- GIDEROSOBJ:MovieClip --&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Supported platforms:&#039;&#039;&#039; [[File:Platform android.png]][[File:Platform ios.png]][[File:Platform mac.png]][[File:Platform pc.png]][[File:Platform html5.png]][[File:Platform winrt.png]][[File:Platform win32.png]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2011.6&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Inherits from:&#039;&#039;&#039; [[Sprite]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
The MovieClip class inherits from the following classes: [[Sprite]] &amp;gt; [[EventDispatcher]].&lt;br /&gt;
&lt;br /&gt;
The MovieClip class is used to create static timedlined animations. The timeline parameters are given as an array.&lt;br /&gt;
&lt;br /&gt;
Each array element specifies one timeline element and consists of: &#039;&#039;&#039;the starting frame&#039;&#039;&#039; (frame numbers start from 1)&#039;&#039;&#039;, the ending frame, a sprite and an optional tweening parameters&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
When a MovieClip object finishes playing (by reaching its final frame or a frame with stop action), it dispatches an [[Event.COMPLETE]] event.&lt;br /&gt;
&lt;br /&gt;
The following properties can be tweened:&lt;br /&gt;
*&#039;&#039;x&#039;&#039;&lt;br /&gt;
*&#039;&#039;y&#039;&#039;&lt;br /&gt;
*&#039;&#039;rotation&#039;&#039;&lt;br /&gt;
*&#039;&#039;scale&#039;&#039;&lt;br /&gt;
*&#039;&#039;scaleX&#039;&#039;&lt;br /&gt;
*&#039;&#039;scaleY&#039;&#039;&lt;br /&gt;
*&#039;&#039;alpha&#039;&#039;&lt;br /&gt;
*&#039;&#039;anchorX&#039;&#039;&lt;br /&gt;
*&#039;&#039;anchorY&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Additionally MovieClip uses a function to tween properties. If you override the default tween function then you can tween this parameter too. The following easing functions can be used:&lt;br /&gt;
* &#039;&#039;&amp;quot;inBack&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;outBack&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;inOutBack&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;inBounce&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;outBounce&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;inOutBounce&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;inCircular&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;outCircular&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;inOutCircular&amp;quot;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;inCubic&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;outCubic&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;inOutCubic&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;inElastic&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;outElastic&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;inOutElastic&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;inExponential&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;outExponential&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;inOutExponential&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;linear&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;inQuadratic&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;outQuadratic&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;inOutQuadratic&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;inQuartic&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;outQuartic&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;inOutQuartic&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;inQuintic&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;outQuintic&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;inOutQuintic&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;inSine&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;outSine&amp;quot;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&amp;quot;inOutSine&amp;quot;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
=== Examples ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
-- construct a 100 frame animation where x coordinate of sprite tweens from 0 to 200 linearly&lt;br /&gt;
local mc = MovieClip.new{&lt;br /&gt;
	{1, 100, sprite, {x = {0, 200, &amp;quot;linear&amp;quot;}}}&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
-- construct a 100 frame animation where x coordinate of sprite is 50 (constant) and &lt;br /&gt;
-- y coordinate of sprite tweens from 50 to 150 by using inBounce function&lt;br /&gt;
local mc = MovieClip.new{&lt;br /&gt;
	{1, 100, sprite, {x = 50, y = {50, 150, &amp;quot;inBounce&amp;quot;}}}&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
-- construct a 200 frame animation where sprite1 and sprite2 tweens differently&lt;br /&gt;
-- here sprite1 is visible between frames [1, 150]&lt;br /&gt;
-- and sprite2 is visible between frames [100, 200]&lt;br /&gt;
local mc = MovieClip.new{&lt;br /&gt;
	{1, 100, sprite1, {x = {0, 200, &amp;quot;linear&amp;quot;}}},&lt;br /&gt;
	{50, 150, sprite1, {y = {0, 100, &amp;quot;linear&amp;quot;}, alpha = {0, 1, &amp;quot;easeOut&amp;quot;}}},&lt;br /&gt;
	{100, 200, sprite2, {x = {0, 200, &amp;quot;linear&amp;quot;}}},&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
-- construct a looping 6 frame animation where each frame is a different sprite&lt;br /&gt;
local mc = MovieClip.new{&lt;br /&gt;
	{1, 1, frame1},	&lt;br /&gt;
	{2, 2, frame2},	&lt;br /&gt;
	{3, 3, frame3},	&lt;br /&gt;
	{4, 4, frame4},	&lt;br /&gt;
	{5, 5, frame5},	&lt;br /&gt;
	{6, 6, frame6},&lt;br /&gt;
}&lt;br /&gt;
mc:setGotoAction(6, 1)	-- if the animation reaches frame 6 then go to frame 1&lt;br /&gt;
						&lt;br /&gt;
-- construct a looping 6 frame animation playing 5 times slower than the previous example&lt;br /&gt;
local mc = MovieClip.new{&lt;br /&gt;
	{1, 5, frame1},	&lt;br /&gt;
	{5, 10, frame2},	&lt;br /&gt;
	{11, 15, frame3},	&lt;br /&gt;
	{16, 20, frame4},	&lt;br /&gt;
	{21, 25, frame5},	&lt;br /&gt;
	{26, 30, frame6},&lt;br /&gt;
}&lt;br /&gt;
mc:setGotoAction(30, 1)	-- if the animation reaches frame 30 then go to frame 1&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{|-&lt;br /&gt;
| style=&amp;quot;width: 50%; vertical-align:top;&amp;quot;|&lt;br /&gt;
=== Methods ===&lt;br /&gt;
[[MovieClip.new]] &#039;&#039;creates a new MovieClip object&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:MovieClip.new(timeline) creates a new MovieClip object--&amp;gt;&lt;br /&gt;
[[MovieClip:clearAction]] &#039;&#039;clears the action at the specified frame&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:MovieClip:clearAction(frame) clears the action at the specified frame--&amp;gt;&lt;br /&gt;
[[MovieClip:getFrame]] &#039;&#039;gets the current frame&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:MovieClip:getFrame() gets the current frame--&amp;gt;&lt;br /&gt;
[[MovieClip.getTweenFunction]] &#039;&#039;retrieves the specified tween/easing function&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:MovieClip.getTweenFunction(name) retrieves the specified tween/easing function--&amp;gt;&lt;br /&gt;
[[MovieClip:gotoAndPlay]] &#039;&#039;goes to the specified frame and starts playing&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:MovieClip:gotoAndPlay(frame,reverse) goes to the specified frame and starts playing--&amp;gt;&lt;br /&gt;
[[MovieClip:gotoAndStop]] &#039;&#039;goes to the specified frame and stops&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:MovieClip:gotoAndStop(frame) goes to the specified frame and stops--&amp;gt;&lt;br /&gt;
[[MovieClip:play]] &#039;&#039;starts playing the movie clip&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:MovieClip:play(reverse) starts playing the movie clip--&amp;gt;&lt;br /&gt;
[[MovieClip:isPlaying]] &#039;&#039;returns whether or not current clip is playing&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:MovieClip:isPlaying() eturns whether or not current clip is playing--&amp;gt;&lt;br /&gt;
[[MovieClip:setGotoAction]] &#039;&#039;sets a &amp;quot;go to&amp;quot; action to the specified frame&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:MovieClip:setGotoAction(frame,destframe) sets a &amp;quot;go to&amp;quot; action to the specified frame--&amp;gt;&lt;br /&gt;
[[MovieClip:setReverseAction]] &#039;&#039;sets a &amp;quot;reverse&amp;quot; action to the specified frame&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:MovieClip:setReverseAction(frame) sets a &amp;quot;reverse&amp;quot; action to the specified frame--&amp;gt;&lt;br /&gt;
[[MovieClip:setStopAction]] &#039;&#039;sets a &amp;quot;stop&amp;quot; action to the specified frame&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:MovieClip:setStopAction(frame) sets a &amp;quot;stop&amp;quot; action to the specified frame--&amp;gt;&lt;br /&gt;
[[MovieClip:stop]] &#039;&#039;stops playing the movie clip&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:MovieClip:stop() stops playing the movie clip--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
| style=&amp;quot;width: 50%; vertical-align:top;&amp;quot;|&lt;br /&gt;
&lt;br /&gt;
=== Events ===&lt;br /&gt;
&amp;lt;!--[[Event.COMPLETE]]&amp;lt;br/&amp;gt;--&amp;gt;&lt;br /&gt;
[[MovieClip_Event.COMPLETE]]&amp;lt;br/&amp;gt;&amp;lt;!-- GIDEROSEVT:Event.COMPLETE movie clip complete event--&amp;gt;&lt;br /&gt;
=== Constants ===&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
{{GIDEROS IMPORTANT LINKS}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Sound.new&amp;diff=22514</id>
		<title>Sound.new</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Sound.new&amp;diff=22514"/>
		<updated>2023-08-31T05:44:14Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* Parameters */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2011.6&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[Sound]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Creates a new &#039;&#039;&#039;Sound&#039;&#039;&#039; object.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
Sound.new(filename)&lt;br /&gt;
Sound.new(data,rate,stereo)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Parameters ===&lt;br /&gt;
&#039;&#039;&#039;filename&#039;&#039;&#039;: (string) the path of the sound file to be loaded&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;data&#039;&#039;&#039;: (table) an array of values between -1 and 1 describing the waveform of the sound&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;rate&#039;&#039;&#039;: (number) the sampling rate of the waveform&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;stereo&#039;&#039;&#039;: (boolean) set to true if the array contains two channels&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Sound}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Sound.new&amp;diff=22513</id>
		<title>Sound.new</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Sound.new&amp;diff=22513"/>
		<updated>2023-08-31T05:41:50Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* Description */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2011.6&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[Sound]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Creates a new &#039;&#039;&#039;Sound&#039;&#039;&#039; object.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
Sound.new(filename)&lt;br /&gt;
Sound.new(data,rate,stereo)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Parameters ===&lt;br /&gt;
&#039;&#039;&#039;filename&#039;&#039;&#039;: (string) the path of the sound file to be loaded&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Sound}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Sound&amp;diff=22512</id>
		<title>Sound</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Sound&amp;diff=22512"/>
		<updated>2023-08-31T05:41:10Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* Methods */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&amp;lt;!-- GIDEROSOBJ:Sound --&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Supported platforms:&#039;&#039;&#039; [[File:Platform android.png]][[File:Platform ios.png]][[File:Platform mac.png]][[File:Platform pc.png]][[File:Platform html5.png]][[File:Platform winrt.png]][[File:Platform win32.png]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2011.6&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Inherits from:&#039;&#039;&#039; [[Object]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
The &#039;&#039;&#039;Sound&#039;&#039;&#039; class lets you load and play WAV, MP3, MOD, XM, S3M and IT sound files.&lt;br /&gt;
&lt;br /&gt;
Control of the playing sound is performed through the [[SoundChannel]] object.&lt;br /&gt;
&lt;br /&gt;
=== Example ===&lt;br /&gt;
&#039;&#039;&#039;Play a background music in loop&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
--local sound = Sound.new(&amp;quot;bgmusicloop.wav&amp;quot;)&lt;br /&gt;
local sound = Sound.new(&amp;quot;bgmusicloop.mp3&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
print(sound:getLength())&lt;br /&gt;
&lt;br /&gt;
local channel = sound:play(26000, true, false)&lt;br /&gt;
&lt;br /&gt;
print(channel:getPosition())&lt;br /&gt;
channel:setPosition(20000)&lt;br /&gt;
print(channel:getPosition())&lt;br /&gt;
channel:setPaused(false)&lt;br /&gt;
&lt;br /&gt;
channel:addEventListener(Event.COMPLETE, function() print(&amp;quot;complete&amp;quot;) end)&lt;br /&gt;
&lt;br /&gt;
local function onTimer()&lt;br /&gt;
--	print(channel:getPosition(), sound:getLength())&lt;br /&gt;
	collectgarbage()&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
local t = Timer.new(100)&lt;br /&gt;
t:addEventListener(Event.TIMER, onTimer)&lt;br /&gt;
t:start()&lt;br /&gt;
&lt;br /&gt;
stage:addEventListener(Event.MOUSE_DOWN, function()&lt;br /&gt;
	channel:setPaused(not channel:isPaused())&lt;br /&gt;
	channel:setPosition(10000)&lt;br /&gt;
--	channel:setPitch(1.5)&lt;br /&gt;
end)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== See also ===&lt;br /&gt;
&#039;&#039;&#039;[[SoundChannel]]&#039;&#039;&#039;&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;[[Playing_Sound_and_Music]]&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
{|-&lt;br /&gt;
| style=&amp;quot;width: 50%; vertical-align:top;&amp;quot;|&lt;br /&gt;
=== Methods ===&lt;br /&gt;
[[Sound.new]] &#039;&#039;creates a new Sound object from a file&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Sound.new(filename) creates a new Sound object from a file--&amp;gt;&lt;br /&gt;
[[Sound.new]] &#039;&#039;creates a new Sound object from a table&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Sound.new(data,rate,stereo) creates a new Sound object from a table--&amp;gt;&lt;br /&gt;
[[Sound.setListenerPosition]] &#039;&#039;sets the position, velocity and orientation of the listener&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Sound.setListenerPosition(x,y,z,vx,vy,vz,dx,dy,dz,ux,uy,uz) sets the position, velocity and orientation of the listener--&amp;gt;&lt;br /&gt;
[[Sound:getLength]] &#039;&#039;gets the sound duration&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Sound:getLength() gets the sound duration--&amp;gt;&lt;br /&gt;
[[Sound:play]] &#039;&#039;creates a new SoundChannel object to play the sound&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Sound:play(startTime,looping,paused) creates a new SoundChannel object to play the sound--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
| style=&amp;quot;width: 50%; vertical-align:top;&amp;quot;|&lt;br /&gt;
&lt;br /&gt;
=== Events ===&lt;br /&gt;
=== Constants ===&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
{{GIDEROS IMPORTANT LINKS}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Application:set&amp;diff=22511</id>
		<title>Application:set</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Application:set&amp;diff=22511"/>
		<updated>2023-08-30T08:49:13Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* Compatibility table */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2015.7&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[Application]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Sets the state of the desktop setting provided as string parameter.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
application:set(setting, value)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;new&#039;&#039;&#039; Gideros 2022.1: implement &#039;&#039;&#039;application:set(&amp;quot;wintabMode&amp;quot;)&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
=== Parameters ===&lt;br /&gt;
&#039;&#039;&#039;setting&#039;&#039;&#039;: (string) the desktop setting&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;value&#039;&#039;&#039;: (varies) the new setting value(s)&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== &#039;&#039;&#039;Compatibility table&#039;&#039;&#039; ===&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot; style=&amp;quot;text-align: center;&amp;quot;&lt;br /&gt;
!!!QT!!Win32!!UWP!!Android!!Apple MacOS!!Apple iOS!!Apple tvOS!!Linux!!HTML&lt;br /&gt;
|-&lt;br /&gt;
|clipboard||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|cursor||X||X||X||||X||||||X||X&lt;br /&gt;
|-&lt;br /&gt;
|cursorPosition||X||X||||||||||||||&lt;br /&gt;
|-&lt;br /&gt;
|documentDirectory||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|maximumSize||X||||||||||||||||&lt;br /&gt;
|-&lt;br /&gt;
|minimumSize||X||||||||||||||||&lt;br /&gt;
|-&lt;br /&gt;
|mkDir||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|temporaryDirectory||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|windowColor||X||||||||||||||||&lt;br /&gt;
|-&lt;br /&gt;
|windowModel||X||||||||||||||||&lt;br /&gt;
|-&lt;br /&gt;
|windowPosition||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|windowSize||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|windowTitle||X||X||||||||||||X||X&lt;br /&gt;
|-&lt;br /&gt;
|wintabMode||X||||||||||||||||&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== List of available parameters and settings ===&lt;br /&gt;
To get a list of parameters that can be set use:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:set(&amp;quot;help&amp;quot;))&lt;br /&gt;
--[[&lt;br /&gt;
- windowPosition(x,y)&lt;br /&gt;
- windowSize(w,h)&lt;br /&gt;
- minimumSize(w,h)&lt;br /&gt;
- maximumSize(w,h)&lt;br /&gt;
- windowColor(r,g,b)&lt;br /&gt;
- windowTitle(text)&lt;br /&gt;
- windowModel(type//help)&lt;br /&gt;
- cursor(type//help)&lt;br /&gt;
- cursorPosition(x,y)&lt;br /&gt;
- clipboard(text)&lt;br /&gt;
- mkdir(path|dirName//help)&lt;br /&gt;
- documentDirectory(path)&lt;br /&gt;
- temporaryDirectory(path)&lt;br /&gt;
]]&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To get help for individual settings use:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:set(&amp;quot;cursor&amp;quot;,&amp;quot;help&amp;quot;)) -- eg: cursor&lt;br /&gt;
--[[&lt;br /&gt;
Accepted value for cursor :&lt;br /&gt;
- arrow&lt;br /&gt;
- upArrow&lt;br /&gt;
- cross&lt;br /&gt;
- wait&lt;br /&gt;
- IBeam&lt;br /&gt;
- sizeVer&lt;br /&gt;
- sizeHor&lt;br /&gt;
- sizeBDiag&lt;br /&gt;
- sizeFDiag&lt;br /&gt;
- sizeAll&lt;br /&gt;
- blank -- not available on win32&lt;br /&gt;
- splitV&lt;br /&gt;
- splitH&lt;br /&gt;
- pointingHand&lt;br /&gt;
- forbidden&lt;br /&gt;
- whatsThis&lt;br /&gt;
- busy&lt;br /&gt;
- openHand -- not available on win32&lt;br /&gt;
- closedHand -- not available on win32&lt;br /&gt;
- dragCopy -- not available on win32&lt;br /&gt;
- dragMove -- not available on win32&lt;br /&gt;
- dragLink -- not available on win32&lt;br /&gt;
]]&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:set(&amp;quot;windowModel&amp;quot;,&amp;quot;help&amp;quot;)) -- eg: window mode&lt;br /&gt;
--[[&lt;br /&gt;
Accepted value for windowModel :&lt;br /&gt;
- reset&lt;br /&gt;
- stayOnTop&lt;br /&gt;
- stayOnBottom&lt;br /&gt;
- frameless&lt;br /&gt;
- noTitleBar&lt;br /&gt;
- noButton&lt;br /&gt;
- onlyMinimize&lt;br /&gt;
- onlyMaximize&lt;br /&gt;
- onlyClose&lt;br /&gt;
- noMinimize&lt;br /&gt;
- noMaximize&lt;br /&gt;
- noClose&lt;br /&gt;
- helpButton&lt;br /&gt;
]]&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Examples ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
application:set(&amp;quot;windowPosition&amp;quot;, 64, 64)&lt;br /&gt;
application:set(&amp;quot;windowColor&amp;quot;, 0, 0, 0)&lt;br /&gt;
application:set(&amp;quot;windowTitle&amp;quot;, &amp;quot;My lovely window title&amp;quot;)&lt;br /&gt;
application:set(&amp;quot;cursor&amp;quot;, &amp;quot;openHand&amp;quot;)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
-- global app size&lt;br /&gt;
myappleft, myapptop, myappright, myappbot = application:getLogicalBounds()&lt;br /&gt;
myappwidth, myappheight = myappright - myappleft, myappbot - myapptop&lt;br /&gt;
&lt;br /&gt;
if application:getDeviceInfo() == &amp;quot;Windows&amp;quot; and not application:isPlayerMode() then&lt;br /&gt;
	application:set(&amp;quot;windowPosition&amp;quot;, myappwidth * 1.2, 16)&lt;br /&gt;
	application:set(&amp;quot;windowModel&amp;quot;, &amp;quot;onlyClose&amp;quot;)&lt;br /&gt;
--	application:set(&amp;quot;windowModel&amp;quot;, &amp;quot;noMaximize&amp;quot;) -- doesn&#039;t work for me!&lt;br /&gt;
	application:set(&amp;quot;windowTitle&amp;quot;, &amp;quot;App Title&amp;quot;)&lt;br /&gt;
	application:set(&amp;quot;minimumSize&amp;quot;, myappwidth, myappheight)&lt;br /&gt;
	application:set(&amp;quot;maximumSize&amp;quot;, myappwidth, myappheight)&lt;br /&gt;
	application:set(&amp;quot;windowColor&amp;quot;, 0, 0, 0)&lt;br /&gt;
end&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;,&amp;quot;executable&amp;quot;)..&amp;quot;|dirName&amp;quot;)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Application}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Application:set&amp;diff=22510</id>
		<title>Application:set</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Application:set&amp;diff=22510"/>
		<updated>2023-08-30T08:47:25Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2015.7&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[Application]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Sets the state of the desktop setting provided as string parameter.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
application:set(setting, value)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;new&#039;&#039;&#039; Gideros 2022.1: implement &#039;&#039;&#039;application:set(&amp;quot;wintabMode&amp;quot;)&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
=== Parameters ===&lt;br /&gt;
&#039;&#039;&#039;setting&#039;&#039;&#039;: (string) the desktop setting&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;value&#039;&#039;&#039;: (varies) the new setting value(s)&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== &#039;&#039;&#039;Compatibility table&#039;&#039;&#039; ===&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot; style=&amp;quot;text-align: center;&amp;quot;&lt;br /&gt;
!!!QT!!Win32!!UWP!!Android!!Apple MacOS!!Apple iOS!!Apple tvOS!!Linux!!HTML&lt;br /&gt;
|-&lt;br /&gt;
|clipboard||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|cursor||X||X||||||||||||X||X&lt;br /&gt;
|-&lt;br /&gt;
|cursorPosition||X||X||||||||||||||&lt;br /&gt;
|-&lt;br /&gt;
|documentDirectory||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|maximumSize||X||||||||||||||||&lt;br /&gt;
|-&lt;br /&gt;
|minimumSize||X||||||||||||||||&lt;br /&gt;
|-&lt;br /&gt;
|mkDir||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|temporaryDirectory||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|windowColor||X||||||||||||||||&lt;br /&gt;
|-&lt;br /&gt;
|windowModel||X||||||||||||||||&lt;br /&gt;
|-&lt;br /&gt;
|windowPosition||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|windowSize||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|windowTitle||X||X||||||||||||X||X&lt;br /&gt;
|-&lt;br /&gt;
|wintabMode||X||||||||||||||||&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== List of available parameters and settings ===&lt;br /&gt;
To get a list of parameters that can be set use:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:set(&amp;quot;help&amp;quot;))&lt;br /&gt;
--[[&lt;br /&gt;
- windowPosition(x,y)&lt;br /&gt;
- windowSize(w,h)&lt;br /&gt;
- minimumSize(w,h)&lt;br /&gt;
- maximumSize(w,h)&lt;br /&gt;
- windowColor(r,g,b)&lt;br /&gt;
- windowTitle(text)&lt;br /&gt;
- windowModel(type//help)&lt;br /&gt;
- cursor(type//help)&lt;br /&gt;
- cursorPosition(x,y)&lt;br /&gt;
- clipboard(text)&lt;br /&gt;
- mkdir(path|dirName//help)&lt;br /&gt;
- documentDirectory(path)&lt;br /&gt;
- temporaryDirectory(path)&lt;br /&gt;
]]&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To get help for individual settings use:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:set(&amp;quot;cursor&amp;quot;,&amp;quot;help&amp;quot;)) -- eg: cursor&lt;br /&gt;
--[[&lt;br /&gt;
Accepted value for cursor :&lt;br /&gt;
- arrow&lt;br /&gt;
- upArrow&lt;br /&gt;
- cross&lt;br /&gt;
- wait&lt;br /&gt;
- IBeam&lt;br /&gt;
- sizeVer&lt;br /&gt;
- sizeHor&lt;br /&gt;
- sizeBDiag&lt;br /&gt;
- sizeFDiag&lt;br /&gt;
- sizeAll&lt;br /&gt;
- blank -- not available on win32&lt;br /&gt;
- splitV&lt;br /&gt;
- splitH&lt;br /&gt;
- pointingHand&lt;br /&gt;
- forbidden&lt;br /&gt;
- whatsThis&lt;br /&gt;
- busy&lt;br /&gt;
- openHand -- not available on win32&lt;br /&gt;
- closedHand -- not available on win32&lt;br /&gt;
- dragCopy -- not available on win32&lt;br /&gt;
- dragMove -- not available on win32&lt;br /&gt;
- dragLink -- not available on win32&lt;br /&gt;
]]&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:set(&amp;quot;windowModel&amp;quot;,&amp;quot;help&amp;quot;)) -- eg: window mode&lt;br /&gt;
--[[&lt;br /&gt;
Accepted value for windowModel :&lt;br /&gt;
- reset&lt;br /&gt;
- stayOnTop&lt;br /&gt;
- stayOnBottom&lt;br /&gt;
- frameless&lt;br /&gt;
- noTitleBar&lt;br /&gt;
- noButton&lt;br /&gt;
- onlyMinimize&lt;br /&gt;
- onlyMaximize&lt;br /&gt;
- onlyClose&lt;br /&gt;
- noMinimize&lt;br /&gt;
- noMaximize&lt;br /&gt;
- noClose&lt;br /&gt;
- helpButton&lt;br /&gt;
]]&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Examples ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
application:set(&amp;quot;windowPosition&amp;quot;, 64, 64)&lt;br /&gt;
application:set(&amp;quot;windowColor&amp;quot;, 0, 0, 0)&lt;br /&gt;
application:set(&amp;quot;windowTitle&amp;quot;, &amp;quot;My lovely window title&amp;quot;)&lt;br /&gt;
application:set(&amp;quot;cursor&amp;quot;, &amp;quot;openHand&amp;quot;)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
-- global app size&lt;br /&gt;
myappleft, myapptop, myappright, myappbot = application:getLogicalBounds()&lt;br /&gt;
myappwidth, myappheight = myappright - myappleft, myappbot - myapptop&lt;br /&gt;
&lt;br /&gt;
if application:getDeviceInfo() == &amp;quot;Windows&amp;quot; and not application:isPlayerMode() then&lt;br /&gt;
	application:set(&amp;quot;windowPosition&amp;quot;, myappwidth * 1.2, 16)&lt;br /&gt;
	application:set(&amp;quot;windowModel&amp;quot;, &amp;quot;onlyClose&amp;quot;)&lt;br /&gt;
--	application:set(&amp;quot;windowModel&amp;quot;, &amp;quot;noMaximize&amp;quot;) -- doesn&#039;t work for me!&lt;br /&gt;
	application:set(&amp;quot;windowTitle&amp;quot;, &amp;quot;App Title&amp;quot;)&lt;br /&gt;
	application:set(&amp;quot;minimumSize&amp;quot;, myappwidth, myappheight)&lt;br /&gt;
	application:set(&amp;quot;maximumSize&amp;quot;, myappwidth, myappheight)&lt;br /&gt;
	application:set(&amp;quot;windowColor&amp;quot;, 0, 0, 0)&lt;br /&gt;
end&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;,&amp;quot;executable&amp;quot;)..&amp;quot;|dirName&amp;quot;)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Application}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Application:get&amp;diff=22509</id>
		<title>Application:get</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Application:get&amp;diff=22509"/>
		<updated>2023-08-30T08:38:47Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* Compatibility table */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2015.7&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[Application]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Returns the state of the desktop setting provided as string parameter.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
varies = application:get(setting)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Parameters ===&lt;br /&gt;
&#039;&#039;&#039;setting&#039;&#039;&#039; (string) the name of the desktop setting&lt;br /&gt;
&lt;br /&gt;
=== Return values ===&lt;br /&gt;
&#039;&#039;&#039;Returns&#039;&#039;&#039; (varies) the value(s) of the setting&lt;br /&gt;
&lt;br /&gt;
=== &#039;&#039;&#039;Compatibility table&#039;&#039;&#039; ===&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot; style=&amp;quot;text-align: center;&amp;quot;&lt;br /&gt;
!!!QT!!Win32!!UWP!!Android!!Apple MacOS!!Apple iOS!!Apple tvOS!!Linux!!HTML&lt;br /&gt;
|-&lt;br /&gt;
|batteryLevel||||||||X||||X||||||&lt;br /&gt;
|-&lt;br /&gt;
|clipboard||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|commandLine||||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|currentUrl||||||||||||||||||X&lt;br /&gt;
|-&lt;br /&gt;
|cursorPosition||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|directory||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|documentDirectory||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|openDirectoryDialog||X||X||X||||X||||||||&lt;br /&gt;
|-&lt;br /&gt;
|openFileDialog||X||X||X||||X||||||||&lt;br /&gt;
|-&lt;br /&gt;
|pathfileexists||?||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|saveFileDialog||X||X||X||||X||||||||&lt;br /&gt;
|-&lt;br /&gt;
|screenSize||X||X||X||||||||||X||X&lt;br /&gt;
|-&lt;br /&gt;
|temporaryDirectory||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|windowPosition||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|windowSize||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|windowTitle||X||X||||||||||||||X&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== Examples ===&lt;br /&gt;
&#039;&#039;&#039;Prints a list of all available settings&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:get(&amp;quot;help&amp;quot;))&lt;br /&gt;
--[[&lt;br /&gt;
	Accepted value for Desktop&#039;s application:get()&lt;br /&gt;
	- [x,y] windowPosition&lt;br /&gt;
	- [w,h] windowSize&lt;br /&gt;
	- [w,h] screenSize&lt;br /&gt;
	- [x,y] cursorPosition&lt;br /&gt;
	- [text] clipboard&lt;br /&gt;
	- [text] windowTitle&lt;br /&gt;
	- [path] directory(where//help)&lt;br /&gt;
	- [path] openDirectoryDialog(title|path//help)&lt;br /&gt;
	- [path] openFileDialog(title|path|extensions//help)&lt;br /&gt;
	- [path] saveFileDialog(title|path|extensions//help)&lt;br /&gt;
	- [path] documentDirectory&lt;br /&gt;
	- [path] temporaryDirectory&lt;br /&gt;
	0&lt;br /&gt;
]]&lt;br /&gt;
print(&amp;quot;\n&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
print(application:get(&amp;quot;directory&amp;quot;, &amp;quot;help&amp;quot;))&lt;br /&gt;
--[[&lt;br /&gt;
	Accepted value for directory :&lt;br /&gt;
	- executable&lt;br /&gt;
	- document&lt;br /&gt;
	- desktop&lt;br /&gt;
	- temporary&lt;br /&gt;
	- data&lt;br /&gt;
	- music&lt;br /&gt;
	- movies&lt;br /&gt;
	- pictures&lt;br /&gt;
	- cache&lt;br /&gt;
	- download&lt;br /&gt;
	- home&lt;br /&gt;
	0&lt;br /&gt;
]]&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Various examples&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:get(&amp;quot;windowTitle&amp;quot;))&lt;br /&gt;
print(application:get(&amp;quot;documentDirectory&amp;quot;))&lt;br /&gt;
print(application:get(&amp;quot;temporaryDirectory&amp;quot;))&lt;br /&gt;
&lt;br /&gt;
-- get screen size&lt;br /&gt;
screenwidth, screenheight = application:get(&amp;quot;screenSize&amp;quot;) -- the actual user screen size!&lt;br /&gt;
application:set(&amp;quot;windowPosition&amp;quot;, (screenwidth - myappwidth)/2, (screenheight - myappheight)/2) -- center the app&lt;br /&gt;
application:set(&amp;quot;windowTitle&amp;quot;, &amp;quot;MY TITLE&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
-- get the user download folder path&lt;br /&gt;
print(application:get(&amp;quot;directory&amp;quot;, &amp;quot;download&amp;quot;)) -- prints C:/Users/xxx/Downloads&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;File dialog open directory&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
--local path = application:get(&amp;quot;openDirectoryDialog&amp;quot;, &amp;quot;Title|C:/tmp/&amp;quot;) -- &amp;quot;title|path&amp;quot; DEPRECATED IN 2022.10&lt;br /&gt;
local path = application:get(&amp;quot;openDirectoryDialog&amp;quot;, &amp;quot;Title&amp;quot;, &amp;quot;C:/tmp/&amp;quot;) -- &amp;quot;title&amp;quot;, &amp;quot;path&amp;quot; NEW WAY&lt;br /&gt;
-- win32&lt;br /&gt;
local path = application:get(&amp;quot;openDirectoryDialog&amp;quot;, &amp;quot;Title&amp;quot;, &amp;quot;C:\\tmp\\&amp;quot;) -- &amp;quot;title&amp;quot;, &amp;quot;path&amp;quot; win32 NEW WAY&lt;br /&gt;
print(path)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;File dialog open file&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:get(&amp;quot;openFileDialog&amp;quot;,&amp;quot;Choisissez un liquide&amp;quot;,&amp;quot;I:\\&amp;quot;,&amp;quot;Bidon (*.bdn *.bid);;Fût et Tonneau (*.fut)&amp;quot;))&lt;br /&gt;
path = application:get(&amp;quot;openFileDialog&amp;quot;, &amp;quot;My Title&amp;quot;, &amp;quot;c:\\&amp;quot;, &amp;quot;Images (*.png *.jpg *.jpeg);;3D (*.obj *.glb *.fbx)&amp;quot;))&lt;br /&gt;
print(path) -- on cancel, returns nil for win32 and &amp;quot;&amp;quot; for other systems&lt;br /&gt;
&lt;br /&gt;
-- file dialog to open a file of type .txt or .png&lt;br /&gt;
local path = application:get(&lt;br /&gt;
--	&amp;quot;openFileDialog&amp;quot;, &amp;quot;Title|C:/tmp/|Text (*.txt);; Image (*.png)&amp;quot;) -- &amp;quot;title|path|extensions&amp;quot; DEPRECATED IN 2022.10&lt;br /&gt;
	&amp;quot;openFileDialog&amp;quot;, &amp;quot;Title&amp;quot;, &amp;quot;C:/tmp/&amp;quot;, &amp;quot;Text (*.txt);; Image (*.png)&amp;quot;) -- &amp;quot;title&amp;quot;, &amp;quot;path&amp;quot;, &amp;quot;extensions&amp;quot; NEW WAY&lt;br /&gt;
print(path)&lt;br /&gt;
&lt;br /&gt;
-- file dialogs on win32 should use a delay Timer.delayedCall or Core.asyncCall&lt;br /&gt;
--self.tiled_ui.btnBrowse:addEventListener(&amp;quot;clicked&amp;quot;, self.browse, self) -- instead of this&lt;br /&gt;
self.tiled_ui.btnBrowse:addEventListener(&amp;quot;clicked&amp;quot;, function()&lt;br /&gt;
	Core.asyncCall(TheStage.browse, self) -- this&lt;br /&gt;
end)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;File dialog save file&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
-- first we choose the destination&lt;br /&gt;
local path = application:get(&lt;br /&gt;
--	&amp;quot;saveFileDialog&amp;quot;, &amp;quot;Title|C:/tmp/|Text (*.txt);; Image (*.jpg)&amp;quot;) -- &amp;quot;title|path|extensions&amp;quot; DEPRECATED IN 2022.10&lt;br /&gt;
	&amp;quot;saveFileDialog&amp;quot;, &amp;quot;Title&amp;quot;, &amp;quot;C:/tmp/&amp;quot;, &amp;quot;Text (*.txt);; Image (*.jpg)&amp;quot;) -- &amp;quot;title&amp;quot;, &amp;quot;path&amp;quot;, &amp;quot;extensions&amp;quot; NEW WAY&lt;br /&gt;
-- and we save some data to it&lt;br /&gt;
if path ~= 0 then&lt;br /&gt;
--if path ~= nil then -- for win32&lt;br /&gt;
	local srcf = io.open(&amp;quot;mytext.txt&amp;quot;, &amp;quot;rb&amp;quot;)&lt;br /&gt;
	local dstf = io.open(path, &amp;quot;wb&amp;quot;)&lt;br /&gt;
	local size = 2^13 -- good buffer size (8K)&lt;br /&gt;
	while true do local block = srcf:read(size) if not block then break end dstf:write(block) end&lt;br /&gt;
	srcf:close()&lt;br /&gt;
	dstf:close()&lt;br /&gt;
end&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Path File Exists&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
-- Path File Exists for Windows 64&lt;br /&gt;
-- tests folder path (nil=doesn&#039;t exist, 1=exists)&lt;br /&gt;
if application:get(&amp;quot;pathfileexists&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;/Folder01&amp;quot;) == nil then&lt;br /&gt;
	application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;), &amp;quot;Folder01&amp;quot;)&lt;br /&gt;
	application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;/Folder01&amp;quot;, &amp;quot;subfolder01&amp;quot;)&lt;br /&gt;
	application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;/Folder01&amp;quot;, &amp;quot;subfolder02&amp;quot;)&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
-- Path File Exists for win32&lt;br /&gt;
-- tests folder path (nil=doesn&#039;t exist, 1=exists)&lt;br /&gt;
if application:get(&amp;quot;pathfileexists&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;\\Folder01&amp;quot;) == nil then&lt;br /&gt;
	-- creates it&lt;br /&gt;
	application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;\\Folder01&amp;quot;)&lt;br /&gt;
end&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Application}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Application:get&amp;diff=22508</id>
		<title>Application:get</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Application:get&amp;diff=22508"/>
		<updated>2023-08-30T08:32:31Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* Compatibility table */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2015.7&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[Application]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Returns the state of the desktop setting provided as string parameter.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
varies = application:get(setting)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Parameters ===&lt;br /&gt;
&#039;&#039;&#039;setting&#039;&#039;&#039; (string) the name of the desktop setting&lt;br /&gt;
&lt;br /&gt;
=== Return values ===&lt;br /&gt;
&#039;&#039;&#039;Returns&#039;&#039;&#039; (varies) the value(s) of the setting&lt;br /&gt;
&lt;br /&gt;
=== &#039;&#039;&#039;Compatibility table&#039;&#039;&#039; ===&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot; style=&amp;quot;text-align: center;&amp;quot;&lt;br /&gt;
!!!QT!!Win32!!UWP!!Android!!Apple MacOS!!Apple iOS!!Apple tvOS!!Linux!!HTML&lt;br /&gt;
|-&lt;br /&gt;
|batteryLevel||||||||X||||X||||||&lt;br /&gt;
|-&lt;br /&gt;
|cursorPosition||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|clipboard||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|currentUrl||||||||||||||||||X&lt;br /&gt;
|-&lt;br /&gt;
|directory||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|documentDirectory||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|mkDir||||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|openDirectoryDialog||X||X||X||||X||||||||&lt;br /&gt;
|-&lt;br /&gt;
|openFileDialog||X||X||X||||X||||||||&lt;br /&gt;
|-&lt;br /&gt;
|pathfileexists||?||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|saveFileDialog||X||X||X||||X||||||||&lt;br /&gt;
|-&lt;br /&gt;
|screenSize||X||X||X||||||||||X||X&lt;br /&gt;
|-&lt;br /&gt;
|temporaryDirectory||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|windowPosition||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|windowSize||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|windowTitle||X||X||||||||||||||X&lt;br /&gt;
|-&lt;br /&gt;
|||||||||||||||||||&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== Examples ===&lt;br /&gt;
&#039;&#039;&#039;Prints a list of all available settings&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:get(&amp;quot;help&amp;quot;))&lt;br /&gt;
--[[&lt;br /&gt;
	Accepted value for Desktop&#039;s application:get()&lt;br /&gt;
	- [x,y] windowPosition&lt;br /&gt;
	- [w,h] windowSize&lt;br /&gt;
	- [w,h] screenSize&lt;br /&gt;
	- [x,y] cursorPosition&lt;br /&gt;
	- [text] clipboard&lt;br /&gt;
	- [text] windowTitle&lt;br /&gt;
	- [path] directory(where//help)&lt;br /&gt;
	- [path] openDirectoryDialog(title|path//help)&lt;br /&gt;
	- [path] openFileDialog(title|path|extensions//help)&lt;br /&gt;
	- [path] saveFileDialog(title|path|extensions//help)&lt;br /&gt;
	- [path] documentDirectory&lt;br /&gt;
	- [path] temporaryDirectory&lt;br /&gt;
	0&lt;br /&gt;
]]&lt;br /&gt;
print(&amp;quot;\n&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
print(application:get(&amp;quot;directory&amp;quot;, &amp;quot;help&amp;quot;))&lt;br /&gt;
--[[&lt;br /&gt;
	Accepted value for directory :&lt;br /&gt;
	- executable&lt;br /&gt;
	- document&lt;br /&gt;
	- desktop&lt;br /&gt;
	- temporary&lt;br /&gt;
	- data&lt;br /&gt;
	- music&lt;br /&gt;
	- movies&lt;br /&gt;
	- pictures&lt;br /&gt;
	- cache&lt;br /&gt;
	- download&lt;br /&gt;
	- home&lt;br /&gt;
	0&lt;br /&gt;
]]&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Various examples&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:get(&amp;quot;windowTitle&amp;quot;))&lt;br /&gt;
print(application:get(&amp;quot;documentDirectory&amp;quot;))&lt;br /&gt;
print(application:get(&amp;quot;temporaryDirectory&amp;quot;))&lt;br /&gt;
&lt;br /&gt;
-- get screen size&lt;br /&gt;
screenwidth, screenheight = application:get(&amp;quot;screenSize&amp;quot;) -- the actual user screen size!&lt;br /&gt;
application:set(&amp;quot;windowPosition&amp;quot;, (screenwidth - myappwidth)/2, (screenheight - myappheight)/2) -- center the app&lt;br /&gt;
application:set(&amp;quot;windowTitle&amp;quot;, &amp;quot;MY TITLE&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
-- get the user download folder path&lt;br /&gt;
print(application:get(&amp;quot;directory&amp;quot;, &amp;quot;download&amp;quot;)) -- prints C:/Users/xxx/Downloads&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;File dialog open directory&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
--local path = application:get(&amp;quot;openDirectoryDialog&amp;quot;, &amp;quot;Title|C:/tmp/&amp;quot;) -- &amp;quot;title|path&amp;quot; DEPRECATED IN 2022.10&lt;br /&gt;
local path = application:get(&amp;quot;openDirectoryDialog&amp;quot;, &amp;quot;Title&amp;quot;, &amp;quot;C:/tmp/&amp;quot;) -- &amp;quot;title&amp;quot;, &amp;quot;path&amp;quot; NEW WAY&lt;br /&gt;
-- win32&lt;br /&gt;
local path = application:get(&amp;quot;openDirectoryDialog&amp;quot;, &amp;quot;Title&amp;quot;, &amp;quot;C:\\tmp\\&amp;quot;) -- &amp;quot;title&amp;quot;, &amp;quot;path&amp;quot; win32 NEW WAY&lt;br /&gt;
print(path)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;File dialog open file&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:get(&amp;quot;openFileDialog&amp;quot;,&amp;quot;Choisissez un liquide&amp;quot;,&amp;quot;I:\\&amp;quot;,&amp;quot;Bidon (*.bdn *.bid);;Fût et Tonneau (*.fut)&amp;quot;))&lt;br /&gt;
path = application:get(&amp;quot;openFileDialog&amp;quot;, &amp;quot;My Title&amp;quot;, &amp;quot;c:\\&amp;quot;, &amp;quot;Images (*.png *.jpg *.jpeg);;3D (*.obj *.glb *.fbx)&amp;quot;))&lt;br /&gt;
print(path) -- on cancel, returns nil for win32 and &amp;quot;&amp;quot; for other systems&lt;br /&gt;
&lt;br /&gt;
-- file dialog to open a file of type .txt or .png&lt;br /&gt;
local path = application:get(&lt;br /&gt;
--	&amp;quot;openFileDialog&amp;quot;, &amp;quot;Title|C:/tmp/|Text (*.txt);; Image (*.png)&amp;quot;) -- &amp;quot;title|path|extensions&amp;quot; DEPRECATED IN 2022.10&lt;br /&gt;
	&amp;quot;openFileDialog&amp;quot;, &amp;quot;Title&amp;quot;, &amp;quot;C:/tmp/&amp;quot;, &amp;quot;Text (*.txt);; Image (*.png)&amp;quot;) -- &amp;quot;title&amp;quot;, &amp;quot;path&amp;quot;, &amp;quot;extensions&amp;quot; NEW WAY&lt;br /&gt;
print(path)&lt;br /&gt;
&lt;br /&gt;
-- file dialogs on win32 should use a delay Timer.delayedCall or Core.asyncCall&lt;br /&gt;
--self.tiled_ui.btnBrowse:addEventListener(&amp;quot;clicked&amp;quot;, self.browse, self) -- instead of this&lt;br /&gt;
self.tiled_ui.btnBrowse:addEventListener(&amp;quot;clicked&amp;quot;, function()&lt;br /&gt;
	Core.asyncCall(TheStage.browse, self) -- this&lt;br /&gt;
end)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;File dialog save file&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
-- first we choose the destination&lt;br /&gt;
local path = application:get(&lt;br /&gt;
--	&amp;quot;saveFileDialog&amp;quot;, &amp;quot;Title|C:/tmp/|Text (*.txt);; Image (*.jpg)&amp;quot;) -- &amp;quot;title|path|extensions&amp;quot; DEPRECATED IN 2022.10&lt;br /&gt;
	&amp;quot;saveFileDialog&amp;quot;, &amp;quot;Title&amp;quot;, &amp;quot;C:/tmp/&amp;quot;, &amp;quot;Text (*.txt);; Image (*.jpg)&amp;quot;) -- &amp;quot;title&amp;quot;, &amp;quot;path&amp;quot;, &amp;quot;extensions&amp;quot; NEW WAY&lt;br /&gt;
-- and we save some data to it&lt;br /&gt;
if path ~= 0 then&lt;br /&gt;
--if path ~= nil then -- for win32&lt;br /&gt;
	local srcf = io.open(&amp;quot;mytext.txt&amp;quot;, &amp;quot;rb&amp;quot;)&lt;br /&gt;
	local dstf = io.open(path, &amp;quot;wb&amp;quot;)&lt;br /&gt;
	local size = 2^13 -- good buffer size (8K)&lt;br /&gt;
	while true do local block = srcf:read(size) if not block then break end dstf:write(block) end&lt;br /&gt;
	srcf:close()&lt;br /&gt;
	dstf:close()&lt;br /&gt;
end&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Path File Exists&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
-- Path File Exists for Windows 64&lt;br /&gt;
-- tests folder path (nil=doesn&#039;t exist, 1=exists)&lt;br /&gt;
if application:get(&amp;quot;pathfileexists&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;/Folder01&amp;quot;) == nil then&lt;br /&gt;
	application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;), &amp;quot;Folder01&amp;quot;)&lt;br /&gt;
	application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;/Folder01&amp;quot;, &amp;quot;subfolder01&amp;quot;)&lt;br /&gt;
	application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;/Folder01&amp;quot;, &amp;quot;subfolder02&amp;quot;)&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
-- Path File Exists for win32&lt;br /&gt;
-- tests folder path (nil=doesn&#039;t exist, 1=exists)&lt;br /&gt;
if application:get(&amp;quot;pathfileexists&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;\\Folder01&amp;quot;) == nil then&lt;br /&gt;
	-- creates it&lt;br /&gt;
	application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;\\Folder01&amp;quot;)&lt;br /&gt;
end&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Application}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Application:get&amp;diff=22507</id>
		<title>Application:get</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Application:get&amp;diff=22507"/>
		<updated>2023-08-30T08:29:15Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2015.7&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[Application]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Returns the state of the desktop setting provided as string parameter.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
varies = application:get(setting)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Parameters ===&lt;br /&gt;
&#039;&#039;&#039;setting&#039;&#039;&#039; (string) the name of the desktop setting&lt;br /&gt;
&lt;br /&gt;
=== Return values ===&lt;br /&gt;
&#039;&#039;&#039;Returns&#039;&#039;&#039; (varies) the value(s) of the setting&lt;br /&gt;
&lt;br /&gt;
=== &#039;&#039;&#039;Compatibility table&#039;&#039;&#039; ===&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot; style=&amp;quot;text-align: center;&amp;quot;&lt;br /&gt;
!!!QT!!Win32!!UWP!!Android!!Apple MacOS!!Apple iOS!!Apple tvOS!!Linux!!HTML&lt;br /&gt;
|-&lt;br /&gt;
|batteryLevel||||||||X||||X||||||&lt;br /&gt;
|-&lt;br /&gt;
|cursorPosition||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|clipboard||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|currentUrl||||||||||||||||||X&lt;br /&gt;
|-&lt;br /&gt;
|directory||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|documentDirectory||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|mkDir||||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|openDirectoryDialog||X||X||X||||X||||||||&lt;br /&gt;
|-&lt;br /&gt;
|openFileDialog||X||X||X||||X||||||||&lt;br /&gt;
|-&lt;br /&gt;
|pathfileexists||||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|saveFileDialog||X||X||X||||X||||||||&lt;br /&gt;
|-&lt;br /&gt;
|screenSize||X||X||X||||||||||X||X&lt;br /&gt;
|-&lt;br /&gt;
|temporaryDirectory||X||X||||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|windowPosition||X||X||X||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|windowSize||X||X||X||||||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|windowTitle||X||X||||||||||||||X&lt;br /&gt;
|-&lt;br /&gt;
|||||||||||||||||||&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== Examples ===&lt;br /&gt;
&#039;&#039;&#039;Prints a list of all available settings&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:get(&amp;quot;help&amp;quot;))&lt;br /&gt;
--[[&lt;br /&gt;
	Accepted value for Desktop&#039;s application:get()&lt;br /&gt;
	- [x,y] windowPosition&lt;br /&gt;
	- [w,h] windowSize&lt;br /&gt;
	- [w,h] screenSize&lt;br /&gt;
	- [x,y] cursorPosition&lt;br /&gt;
	- [text] clipboard&lt;br /&gt;
	- [text] windowTitle&lt;br /&gt;
	- [path] directory(where//help)&lt;br /&gt;
	- [path] openDirectoryDialog(title|path//help)&lt;br /&gt;
	- [path] openFileDialog(title|path|extensions//help)&lt;br /&gt;
	- [path] saveFileDialog(title|path|extensions//help)&lt;br /&gt;
	- [path] documentDirectory&lt;br /&gt;
	- [path] temporaryDirectory&lt;br /&gt;
	0&lt;br /&gt;
]]&lt;br /&gt;
print(&amp;quot;\n&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
print(application:get(&amp;quot;directory&amp;quot;, &amp;quot;help&amp;quot;))&lt;br /&gt;
--[[&lt;br /&gt;
	Accepted value for directory :&lt;br /&gt;
	- executable&lt;br /&gt;
	- document&lt;br /&gt;
	- desktop&lt;br /&gt;
	- temporary&lt;br /&gt;
	- data&lt;br /&gt;
	- music&lt;br /&gt;
	- movies&lt;br /&gt;
	- pictures&lt;br /&gt;
	- cache&lt;br /&gt;
	- download&lt;br /&gt;
	- home&lt;br /&gt;
	0&lt;br /&gt;
]]&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Various examples&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:get(&amp;quot;windowTitle&amp;quot;))&lt;br /&gt;
print(application:get(&amp;quot;documentDirectory&amp;quot;))&lt;br /&gt;
print(application:get(&amp;quot;temporaryDirectory&amp;quot;))&lt;br /&gt;
&lt;br /&gt;
-- get screen size&lt;br /&gt;
screenwidth, screenheight = application:get(&amp;quot;screenSize&amp;quot;) -- the actual user screen size!&lt;br /&gt;
application:set(&amp;quot;windowPosition&amp;quot;, (screenwidth - myappwidth)/2, (screenheight - myappheight)/2) -- center the app&lt;br /&gt;
application:set(&amp;quot;windowTitle&amp;quot;, &amp;quot;MY TITLE&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
-- get the user download folder path&lt;br /&gt;
print(application:get(&amp;quot;directory&amp;quot;, &amp;quot;download&amp;quot;)) -- prints C:/Users/xxx/Downloads&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;File dialog open directory&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
--local path = application:get(&amp;quot;openDirectoryDialog&amp;quot;, &amp;quot;Title|C:/tmp/&amp;quot;) -- &amp;quot;title|path&amp;quot; DEPRECATED IN 2022.10&lt;br /&gt;
local path = application:get(&amp;quot;openDirectoryDialog&amp;quot;, &amp;quot;Title&amp;quot;, &amp;quot;C:/tmp/&amp;quot;) -- &amp;quot;title&amp;quot;, &amp;quot;path&amp;quot; NEW WAY&lt;br /&gt;
-- win32&lt;br /&gt;
local path = application:get(&amp;quot;openDirectoryDialog&amp;quot;, &amp;quot;Title&amp;quot;, &amp;quot;C:\\tmp\\&amp;quot;) -- &amp;quot;title&amp;quot;, &amp;quot;path&amp;quot; win32 NEW WAY&lt;br /&gt;
print(path)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;File dialog open file&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:get(&amp;quot;openFileDialog&amp;quot;,&amp;quot;Choisissez un liquide&amp;quot;,&amp;quot;I:\\&amp;quot;,&amp;quot;Bidon (*.bdn *.bid);;Fût et Tonneau (*.fut)&amp;quot;))&lt;br /&gt;
path = application:get(&amp;quot;openFileDialog&amp;quot;, &amp;quot;My Title&amp;quot;, &amp;quot;c:\\&amp;quot;, &amp;quot;Images (*.png *.jpg *.jpeg);;3D (*.obj *.glb *.fbx)&amp;quot;))&lt;br /&gt;
print(path) -- on cancel, returns nil for win32 and &amp;quot;&amp;quot; for other systems&lt;br /&gt;
&lt;br /&gt;
-- file dialog to open a file of type .txt or .png&lt;br /&gt;
local path = application:get(&lt;br /&gt;
--	&amp;quot;openFileDialog&amp;quot;, &amp;quot;Title|C:/tmp/|Text (*.txt);; Image (*.png)&amp;quot;) -- &amp;quot;title|path|extensions&amp;quot; DEPRECATED IN 2022.10&lt;br /&gt;
	&amp;quot;openFileDialog&amp;quot;, &amp;quot;Title&amp;quot;, &amp;quot;C:/tmp/&amp;quot;, &amp;quot;Text (*.txt);; Image (*.png)&amp;quot;) -- &amp;quot;title&amp;quot;, &amp;quot;path&amp;quot;, &amp;quot;extensions&amp;quot; NEW WAY&lt;br /&gt;
print(path)&lt;br /&gt;
&lt;br /&gt;
-- file dialogs on win32 should use a delay Timer.delayedCall or Core.asyncCall&lt;br /&gt;
--self.tiled_ui.btnBrowse:addEventListener(&amp;quot;clicked&amp;quot;, self.browse, self) -- instead of this&lt;br /&gt;
self.tiled_ui.btnBrowse:addEventListener(&amp;quot;clicked&amp;quot;, function()&lt;br /&gt;
	Core.asyncCall(TheStage.browse, self) -- this&lt;br /&gt;
end)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;File dialog save file&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
-- first we choose the destination&lt;br /&gt;
local path = application:get(&lt;br /&gt;
--	&amp;quot;saveFileDialog&amp;quot;, &amp;quot;Title|C:/tmp/|Text (*.txt);; Image (*.jpg)&amp;quot;) -- &amp;quot;title|path|extensions&amp;quot; DEPRECATED IN 2022.10&lt;br /&gt;
	&amp;quot;saveFileDialog&amp;quot;, &amp;quot;Title&amp;quot;, &amp;quot;C:/tmp/&amp;quot;, &amp;quot;Text (*.txt);; Image (*.jpg)&amp;quot;) -- &amp;quot;title&amp;quot;, &amp;quot;path&amp;quot;, &amp;quot;extensions&amp;quot; NEW WAY&lt;br /&gt;
-- and we save some data to it&lt;br /&gt;
if path ~= 0 then&lt;br /&gt;
--if path ~= nil then -- for win32&lt;br /&gt;
	local srcf = io.open(&amp;quot;mytext.txt&amp;quot;, &amp;quot;rb&amp;quot;)&lt;br /&gt;
	local dstf = io.open(path, &amp;quot;wb&amp;quot;)&lt;br /&gt;
	local size = 2^13 -- good buffer size (8K)&lt;br /&gt;
	while true do local block = srcf:read(size) if not block then break end dstf:write(block) end&lt;br /&gt;
	srcf:close()&lt;br /&gt;
	dstf:close()&lt;br /&gt;
end&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Path File Exists&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
-- Path File Exists for Windows 64&lt;br /&gt;
-- tests folder path (nil=doesn&#039;t exist, 1=exists)&lt;br /&gt;
if application:get(&amp;quot;pathfileexists&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;/Folder01&amp;quot;) == nil then&lt;br /&gt;
	application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;), &amp;quot;Folder01&amp;quot;)&lt;br /&gt;
	application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;/Folder01&amp;quot;, &amp;quot;subfolder01&amp;quot;)&lt;br /&gt;
	application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;/Folder01&amp;quot;, &amp;quot;subfolder02&amp;quot;)&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
-- Path File Exists for win32&lt;br /&gt;
-- tests folder path (nil=doesn&#039;t exist, 1=exists)&lt;br /&gt;
if application:get(&amp;quot;pathfileexists&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;\\Folder01&amp;quot;) == nil then&lt;br /&gt;
	-- creates it&lt;br /&gt;
	application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;\\Folder01&amp;quot;)&lt;br /&gt;
end&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Application}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Application:get&amp;diff=22506</id>
		<title>Application:get</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Application:get&amp;diff=22506"/>
		<updated>2023-08-30T08:12:28Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2015.7&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[Application]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Returns the state of the desktop setting provided as string parameter.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
varies = application:get(setting)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Parameters ===&lt;br /&gt;
&#039;&#039;&#039;setting&#039;&#039;&#039; (string) the name of the desktop setting&lt;br /&gt;
&lt;br /&gt;
=== Return values ===&lt;br /&gt;
&#039;&#039;&#039;Returns&#039;&#039;&#039; (varies) the value(s) of the setting&lt;br /&gt;
&lt;br /&gt;
=== &#039;&#039;&#039;Compatibility table&#039;&#039;&#039; ===&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot; style=&amp;quot;text-align: center;&amp;quot;&lt;br /&gt;
!!!QT!!Win32!!UWP!!Android!!Apple MacOS!!Apple iOS!!Apple tvOS!!Linux!!HTML&lt;br /&gt;
|-&lt;br /&gt;
|batteryLevel||||||||X||||X||||||&lt;br /&gt;
|-&lt;br /&gt;
|windowPosition||X||X||X||||X||||||X||&lt;br /&gt;
|-&lt;br /&gt;
|||||||||||||||||||&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== Examples ===&lt;br /&gt;
&#039;&#039;&#039;Prints a list of all available settings&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:get(&amp;quot;help&amp;quot;))&lt;br /&gt;
--[[&lt;br /&gt;
	Accepted value for Desktop&#039;s application:get()&lt;br /&gt;
	- [x,y] windowPosition&lt;br /&gt;
	- [w,h] windowSize&lt;br /&gt;
	- [w,h] screenSize&lt;br /&gt;
	- [x,y] cursorPosition&lt;br /&gt;
	- [text] clipboard&lt;br /&gt;
	- [text] windowTitle&lt;br /&gt;
	- [path] directory(where//help)&lt;br /&gt;
	- [path] openDirectoryDialog(title|path//help)&lt;br /&gt;
	- [path] openFileDialog(title|path|extensions//help)&lt;br /&gt;
	- [path] saveFileDialog(title|path|extensions//help)&lt;br /&gt;
	- [path] documentDirectory&lt;br /&gt;
	- [path] temporaryDirectory&lt;br /&gt;
	0&lt;br /&gt;
]]&lt;br /&gt;
print(&amp;quot;\n&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
print(application:get(&amp;quot;directory&amp;quot;, &amp;quot;help&amp;quot;))&lt;br /&gt;
--[[&lt;br /&gt;
	Accepted value for directory :&lt;br /&gt;
	- executable&lt;br /&gt;
	- document&lt;br /&gt;
	- desktop&lt;br /&gt;
	- temporary&lt;br /&gt;
	- data&lt;br /&gt;
	- music&lt;br /&gt;
	- movies&lt;br /&gt;
	- pictures&lt;br /&gt;
	- cache&lt;br /&gt;
	- download&lt;br /&gt;
	- home&lt;br /&gt;
	0&lt;br /&gt;
]]&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Various examples&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:get(&amp;quot;windowTitle&amp;quot;))&lt;br /&gt;
print(application:get(&amp;quot;documentDirectory&amp;quot;))&lt;br /&gt;
print(application:get(&amp;quot;temporaryDirectory&amp;quot;))&lt;br /&gt;
&lt;br /&gt;
-- get screen size&lt;br /&gt;
screenwidth, screenheight = application:get(&amp;quot;screenSize&amp;quot;) -- the actual user screen size!&lt;br /&gt;
application:set(&amp;quot;windowPosition&amp;quot;, (screenwidth - myappwidth)/2, (screenheight - myappheight)/2) -- center the app&lt;br /&gt;
application:set(&amp;quot;windowTitle&amp;quot;, &amp;quot;MY TITLE&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
-- get the user download folder path&lt;br /&gt;
print(application:get(&amp;quot;directory&amp;quot;, &amp;quot;download&amp;quot;)) -- prints C:/Users/xxx/Downloads&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;File dialog open directory&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
--local path = application:get(&amp;quot;openDirectoryDialog&amp;quot;, &amp;quot;Title|C:/tmp/&amp;quot;) -- &amp;quot;title|path&amp;quot; DEPRECATED IN 2022.10&lt;br /&gt;
local path = application:get(&amp;quot;openDirectoryDialog&amp;quot;, &amp;quot;Title&amp;quot;, &amp;quot;C:/tmp/&amp;quot;) -- &amp;quot;title&amp;quot;, &amp;quot;path&amp;quot; NEW WAY&lt;br /&gt;
-- win32&lt;br /&gt;
local path = application:get(&amp;quot;openDirectoryDialog&amp;quot;, &amp;quot;Title&amp;quot;, &amp;quot;C:\\tmp\\&amp;quot;) -- &amp;quot;title&amp;quot;, &amp;quot;path&amp;quot; win32 NEW WAY&lt;br /&gt;
print(path)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;File dialog open file&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
print(application:get(&amp;quot;openFileDialog&amp;quot;,&amp;quot;Choisissez un liquide&amp;quot;,&amp;quot;I:\\&amp;quot;,&amp;quot;Bidon (*.bdn *.bid);;Fût et Tonneau (*.fut)&amp;quot;))&lt;br /&gt;
path = application:get(&amp;quot;openFileDialog&amp;quot;, &amp;quot;My Title&amp;quot;, &amp;quot;c:\\&amp;quot;, &amp;quot;Images (*.png *.jpg *.jpeg);;3D (*.obj *.glb *.fbx)&amp;quot;))&lt;br /&gt;
print(path) -- on cancel, returns nil for win32 and &amp;quot;&amp;quot; for other systems&lt;br /&gt;
&lt;br /&gt;
-- file dialog to open a file of type .txt or .png&lt;br /&gt;
local path = application:get(&lt;br /&gt;
--	&amp;quot;openFileDialog&amp;quot;, &amp;quot;Title|C:/tmp/|Text (*.txt);; Image (*.png)&amp;quot;) -- &amp;quot;title|path|extensions&amp;quot; DEPRECATED IN 2022.10&lt;br /&gt;
	&amp;quot;openFileDialog&amp;quot;, &amp;quot;Title&amp;quot;, &amp;quot;C:/tmp/&amp;quot;, &amp;quot;Text (*.txt);; Image (*.png)&amp;quot;) -- &amp;quot;title&amp;quot;, &amp;quot;path&amp;quot;, &amp;quot;extensions&amp;quot; NEW WAY&lt;br /&gt;
print(path)&lt;br /&gt;
&lt;br /&gt;
-- file dialogs on win32 should use a delay Timer.delayedCall or Core.asyncCall&lt;br /&gt;
--self.tiled_ui.btnBrowse:addEventListener(&amp;quot;clicked&amp;quot;, self.browse, self) -- instead of this&lt;br /&gt;
self.tiled_ui.btnBrowse:addEventListener(&amp;quot;clicked&amp;quot;, function()&lt;br /&gt;
	Core.asyncCall(TheStage.browse, self) -- this&lt;br /&gt;
end)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;File dialog save file&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
-- first we choose the destination&lt;br /&gt;
local path = application:get(&lt;br /&gt;
--	&amp;quot;saveFileDialog&amp;quot;, &amp;quot;Title|C:/tmp/|Text (*.txt);; Image (*.jpg)&amp;quot;) -- &amp;quot;title|path|extensions&amp;quot; DEPRECATED IN 2022.10&lt;br /&gt;
	&amp;quot;saveFileDialog&amp;quot;, &amp;quot;Title&amp;quot;, &amp;quot;C:/tmp/&amp;quot;, &amp;quot;Text (*.txt);; Image (*.jpg)&amp;quot;) -- &amp;quot;title&amp;quot;, &amp;quot;path&amp;quot;, &amp;quot;extensions&amp;quot; NEW WAY&lt;br /&gt;
-- and we save some data to it&lt;br /&gt;
if path ~= 0 then&lt;br /&gt;
--if path ~= nil then -- for win32&lt;br /&gt;
	local srcf = io.open(&amp;quot;mytext.txt&amp;quot;, &amp;quot;rb&amp;quot;)&lt;br /&gt;
	local dstf = io.open(path, &amp;quot;wb&amp;quot;)&lt;br /&gt;
	local size = 2^13 -- good buffer size (8K)&lt;br /&gt;
	while true do local block = srcf:read(size) if not block then break end dstf:write(block) end&lt;br /&gt;
	srcf:close()&lt;br /&gt;
	dstf:close()&lt;br /&gt;
end&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Path File Exists&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
-- Path File Exists for Windows 64&lt;br /&gt;
-- tests folder path (nil=doesn&#039;t exist, 1=exists)&lt;br /&gt;
if application:get(&amp;quot;pathfileexists&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;/Folder01&amp;quot;) == nil then&lt;br /&gt;
	application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;), &amp;quot;Folder01&amp;quot;)&lt;br /&gt;
	application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;/Folder01&amp;quot;, &amp;quot;subfolder01&amp;quot;)&lt;br /&gt;
	application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;/Folder01&amp;quot;, &amp;quot;subfolder02&amp;quot;)&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
-- Path File Exists for win32&lt;br /&gt;
-- tests folder path (nil=doesn&#039;t exist, 1=exists)&lt;br /&gt;
if application:get(&amp;quot;pathfileexists&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;\\Folder01&amp;quot;) == nil then&lt;br /&gt;
	-- creates it&lt;br /&gt;
	application:set(&amp;quot;mkDir&amp;quot;, application:get(&amp;quot;directory&amp;quot;, &amp;quot;pictures&amp;quot;)..&amp;quot;\\Folder01&amp;quot;)&lt;br /&gt;
end&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Application}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=File:RainDrops.GApp&amp;diff=22500</id>
		<title>File:RainDrops.GApp</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=File:RainDrops.GApp&amp;diff=22500"/>
		<updated>2023-08-29T12:09:44Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: RainDrops demo app&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Summary ==&lt;br /&gt;
RainDrops demo app&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Welcome!&amp;diff=22494</id>
		<title>Welcome!</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Welcome!&amp;diff=22494"/>
		<updated>2023-08-29T12:04:45Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS API REFERENCES&#039;&#039;&#039; ==&lt;br /&gt;
{|-&lt;br /&gt;
|style=&amp;quot;width: 33%;&amp;quot;|&lt;br /&gt;
::::::::::::&lt;br /&gt;
===&#039;&#039;&#039;[[Lua API]]&#039;&#039;&#039;===&lt;br /&gt;
=== &#039;&#039;&#039; &amp;amp;nbsp; &#039;&#039;&#039; ===&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 33%;&amp;quot;|&lt;br /&gt;
::::::::::::&lt;br /&gt;
===&#039;&#039;&#039;[[Main API]]&#039;&#039;&#039;===&lt;br /&gt;
=== &#039;&#039;&#039; &amp;amp;nbsp; &#039;&#039;&#039; ===&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 33%;&amp;quot;|&lt;br /&gt;
::::::::::::&lt;br /&gt;
===&#039;&#039;&#039;[[Plugins]]&#039;&#039;&#039;===&lt;br /&gt;
=== &#039;&#039;&#039; &amp;amp;nbsp; &#039;&#039;&#039; ===&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS GUIDES AND TUTORIALS&#039;&#039;&#039; ==&lt;br /&gt;
{|-&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Tutorials ===&lt;br /&gt;
[[Lua to Luau conversion guide]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Start Here|You can start here]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Article Tutorials]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Video Tutorials]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== From the Forum ===&lt;br /&gt;
[[Examples|Forum Snippets and more...]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[ImGui Examples|ImGui Snippets]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Links ===&lt;br /&gt;
[[Made With Gideros]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Developer YouTube Channels|Developers YouTube Channels]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Ultimate Guide ===&lt;br /&gt;
[[Introduction]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Gideros Studio]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Getting Started]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Gideros Player]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Your first code]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Introduction to Lua]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Classes in Gideros]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Scene Management]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Introduction to Graphics]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Introduction to Graphics Shapes]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Introduction to Fonts]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Playing Sound and Music]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Event system]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[File system]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Profiling]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Hardware and OS]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Exporting to a Player|Exporting your project (&#039;&#039;&#039;Xbox, ...&#039;&#039;&#039;)]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Making a Plugin]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Latest ===&lt;br /&gt;
[[Latest Release|Latest Gideros]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Latest Luau]]&amp;lt;br/&amp;gt;&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS SHORTS&#039;&#039;&#039; ==&lt;br /&gt;
[[Short-Issue-1|#1 - June 2023 - Overheat]]&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS PEBBLES&#039;&#039;&#039; ==&lt;br /&gt;
[[Lua Shaders Pebbles|Lua Shaders]]&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS 2D HELPERS&#039;&#039;&#039; ==&lt;br /&gt;
{|-&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== UI Classes ===&lt;br /&gt;
[[UI Buttons|UI Buttons]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[UI Color Picker|UI Color Picker]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[UI Scrollable List|UI Scrollable List]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[UI Slider|UI Sliders]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[UI Text|UI Text]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Game Helpers ===&lt;br /&gt;
[[Scene Manager|Scene Manager/Easing]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Game Camera]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Animated Sprite Factory|Animations (Sprite Sheets)]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Mobile Controls]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Tiled Map Editor|Tiled]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[CBump Template|CBump Template]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Plugins Helpers ===&lt;br /&gt;
[[Media Plugin]]&amp;lt;br/&amp;gt;&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS 3D HELPERS&#039;&#039;&#039; ==&lt;br /&gt;
{|-&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== ReactPhysics3D ===&lt;br /&gt;
[[3D Plane]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== &#039;&#039;&#039;GIDEROS ADVANCED&#039;&#039;&#039; ==&lt;br /&gt;
{|-&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Advanced ===&lt;br /&gt;
[[Writing Shaders]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;[[Lua Shaders]]&#039;&#039;&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Compiling Gideros Source]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Compiling Gideros Luau Source|Compiling Gideros Luau &#039;&#039;&#039;WIP&#039;&#039;&#039;]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[What Does What]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Helping With Documentation]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[CPlusPlus for Gideros Studio Help]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
=== Wiki Special Links ===&lt;br /&gt;
[[Special:AllPages]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[All Classes and more]]&amp;lt;br/&amp;gt;&lt;br /&gt;
[[Wiki Sandbox]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
|style=&amp;quot;width: 30%; vertical-align:top;&amp;quot;|&lt;br /&gt;
:::::::::::&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Compiling_Gideros_Source&amp;diff=22489</id>
		<title>Compiling Gideros Source</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Compiling_Gideros_Source&amp;diff=22489"/>
		<updated>2023-08-23T15:26:45Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* 1.3.1 (Linux/Debian) Install Git, build-tools */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;The following instructions are for developers who want to contribute to or otherwise experiment with the Gideros C/C++ engine and are &#039;&#039;not&#039;&#039; necessary for either building or deploying apps made with Gideros.&lt;br /&gt;
&lt;br /&gt;
The Gideros project consists of the Gideros Studio IDE, the Gideros SDK libraries, Gideros Texture Packer, Gideros Font Creator, &amp;quot;players&amp;quot; or export templates for all the platforms Gideros supports, all targets of all plugins, a daemon and a bridge. The build system is flexible, so you only need the tools for the targets you are interested in deploying to with Qt (and MSYS2 on Windows) being a realistic minimum.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div class=&amp;quot;noautonum&amp;quot;&amp;gt;__TOC__&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 1. Requirements ==&lt;br /&gt;
=== 1.1 Install QT ===&lt;br /&gt;
https://www.qt.io/download-open-source/&lt;br /&gt;
&lt;br /&gt;
Recommended version 6.3 with MinGW &amp;lt;br /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Double click on the downloaded file and follow instructions. When installing, expand the tree view and ensure you have ticked the MinGW child option of the Qt version checkbox, as well as the MinGW option in the Tools section.&lt;br /&gt;
Beside main QT package, you&#039;ll need the following additional components:&lt;br /&gt;
* WebSocket additional library&lt;br /&gt;
* Multimedia additional library&lt;br /&gt;
* Qt5 Compatibility addon&lt;br /&gt;
  &lt;br /&gt;
(MAC) Move the created folder into your user account folder &lt;br /&gt;
&lt;br /&gt;
(LINUX) &lt;br /&gt;
On Debian 11:&lt;br /&gt;
echo &amp;quot;deb http://deb.debian.org/debian bullseye-backports main&amp;quot; &amp;gt;&amp;gt;/etc/apt/sources.list&lt;br /&gt;
apt update&lt;br /&gt;
apt install qt6-base-dev qt6-websockets-dev qt6-multimedia-dev qt6-5compat-dev&lt;br /&gt;
&lt;br /&gt;
Depending on your distribution, you may need to install qt5 websocket lib seperately (sudo apt-get install libqt5websockets5-dev)&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
===1.2 (PC) Install MSYS2 Console===&lt;br /&gt;
    https://msys2.github.io/ &lt;br /&gt;
&lt;br /&gt;
Double click on the downloaded file (msys2-i686) and follow instructions. &lt;br /&gt;
&lt;br /&gt;
Open 32 bit MSYS2 shell: msys2_shell.cmd&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
pacman -Sy pacman&lt;br /&gt;
pacman -Syu&lt;br /&gt;
pacman -Su&lt;br /&gt;
pacman -S tar&lt;br /&gt;
pacman -S zip&lt;br /&gt;
pacman -S unzip&lt;br /&gt;
pacman -S git&lt;br /&gt;
pacman -S base-devel&lt;br /&gt;
pacman -S python&lt;br /&gt;
#For compiling win32/32bit under a MinGW64&lt;br /&gt;
pacman -S mingw-w64-i686-toolchain&lt;br /&gt;
pacman -S mingw-w64-i686-glew&lt;br /&gt;
pacman -S mingw-w64-i686-curl&lt;br /&gt;
pacman -S mingw-w64-i686-libpng&lt;br /&gt;
#For compiling win32/64bit under a MinGW64&lt;br /&gt;
pacman -S mingw-w64-x86_64-toolchain&lt;br /&gt;
pacman -S mingw-w64-x86_64-glew&lt;br /&gt;
pacman -S mingw-w64-x86_64-curl&lt;br /&gt;
pacman -S mingw-w64-x86_64-libpng&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.3 (Mac) Install Git &amp;amp; xcpretty ===&lt;br /&gt;
    http://git-scm.com/downloads&lt;br /&gt;
    &lt;br /&gt;
Ctrl + right click, open with « Install program.app » Follow instructions keeping default values as they are. &lt;br /&gt;
&lt;br /&gt;
(MAC) open a terminal window &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
git config -global user.name &amp;quot;your git login&amp;quot; &lt;br /&gt;
git config -global user.email &amp;quot;your git email&amp;quot;&lt;br /&gt;
sudo gem install xcpretty&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
=== 1.3.1 (Linux/Debian) Install Git, build-tools ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
apt install git build-essential libxcb-xinerama0 libgl1-mesa-dev libz-dev libasound2-dev libglew-dev libglfw3-dev libcurl4-openssl-dev patchelf zip&lt;br /&gt;
git config --global user.email &amp;quot;your git email&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.4 (PC) Android requirements ===&lt;br /&gt;
&lt;br /&gt;
==== 1.4.1 Install Android Studio and NDK ====&lt;br /&gt;
&lt;br /&gt;
    https://developer.android.com/studio/index.html&lt;br /&gt;
    https://developer.android.com/ndk/downloads/older_releases.html&lt;br /&gt;
&lt;br /&gt;
Recommended NDK is 25c (the x86_64 version)&lt;br /&gt;
&lt;br /&gt;
Once downloaded, copy the contents of the NDK to your home or C: folder, rename the folder that you copied to &#039;android-ndk&#039;, for example you will end up with &#039;c:\android-ndk&#039; and below that folders that say build, meta, platforms, etc.&lt;br /&gt;
&lt;br /&gt;
==== 1.4.2 Install Ant (no longer required but kept util someone confirms this)====&lt;br /&gt;
    https://ant.apache.org/&lt;br /&gt;
&lt;br /&gt;
Once downloaded, copy the contents of the install archive/zip file to your home folder or C: drive.&lt;br /&gt;
Eg: so you have a folder called c:\apache-ant-1.10.5 with bin, etc, lib, manual folders within that.&lt;br /&gt;
&lt;br /&gt;
==== 1.4.3 Mix Old and New Tools (no longer required but kept util someone confirms this) ====&lt;br /&gt;
&lt;br /&gt;
Gideros uses Ant to build the player, unfortunately the tools to support Ant are now missing from the latest Android tools.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
There is a fix for this:&lt;br /&gt;
&lt;br /&gt;
# Rename the existing &#039;tools&#039; folder in the Android SDK folder to &#039;tools_new&#039;.&lt;br /&gt;
# Download an older (March 2016) version of the tools and copy that folder to the Android SDK folder.&lt;br /&gt;
# Copy the contents of &#039;tools_new&#039; over the contents of &#039;tools&#039;.&lt;br /&gt;
&lt;br /&gt;
Here is where you can download the compatible set of tools from:&lt;br /&gt;
&lt;br /&gt;
(PC) https://dl.google.com/android/repository/tools_r25.2.5-windows.zip&lt;br /&gt;
&lt;br /&gt;
(MAC) https://dl.google.com/android/repository/tools_r25.2.5-macosx.zip&lt;br /&gt;
&lt;br /&gt;
(LINUX) https://dl.google.com/android/repository/tools_r25.2.5-linux.zip&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.5 Install Java ===&lt;br /&gt;
You need the Java JDK&lt;br /&gt;
https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.6 (PC) Install Visual Studio ===&lt;br /&gt;
    https://www.visualstudio.com/downloads/&lt;br /&gt;
&lt;br /&gt;
Install [https://developer.microsoft.com/en-us/windows/downloads/windows-8-1-sdk Win 8.1 SDK]&lt;br /&gt;
&lt;br /&gt;
Install [https://marketplace.visualstudio.com/items?itemName=AdMediator.MicrosoftAdvertisingSDKforWindowsandWindowsPhone8x Microsoft Advertising SDK for Windows and Windows Phone 8.x]&lt;br /&gt;
&lt;br /&gt;
Ensure that you have MSBuild v12 or v14 installed (building with the makefile will fail with an incorrect version).&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.7 (MAC) Install Xcode ===&lt;br /&gt;
    https://itunes.apple.com/fr/app/xcode/id497799835?mt=12&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.8 (Mac) ensure xcode command line tools are working ===&lt;br /&gt;
(MAC) Open a terminal window &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
sudo xCodebuild -license &lt;br /&gt;
quit&lt;br /&gt;
agree&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br /&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.9 Install Python ===&lt;br /&gt;
https://www.python.org/downloads/release/python-2712/&lt;br /&gt;
&lt;br /&gt;
You need Python 2.7.12 or later to install emscripten properly.&lt;br /&gt;
&lt;br /&gt;
Once installed, add it to your command line path, eg: c:\python27, on windows you can do this by right-clicking on &#039;myComputer&#039; or &#039;This PC&#039;, go to &#039;Properties&#039;, click &#039;Advanced System Settings&#039;, Click &#039;Environmental Variables&#039;, double-click &#039;Path&#039;, add &#039;c:\python27&#039;.&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.10 Install emscripten ===&lt;br /&gt;
    http://kripken.github.io/emscripten-site/&lt;br /&gt;
&lt;br /&gt;
You need this is you want to build for HTML5 + Facebook games.&lt;br /&gt;
&lt;br /&gt;
Using a shell or MSYS2 (previously installed) on windows, go to your home or C: folder and type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://github.com/juj/emsdk.git&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Once that has completed open a command prompt in that folder on Windows, on other system just cd to the folder.&lt;br /&gt;
&lt;br /&gt;
Using emsdk, install and activate all the latest packages:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
#(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install latest&lt;br /&gt;
emsdk activate latest&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(PC) Type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
emsdk_env.bat&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(MAC) Type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
source ./emsdk_env.sh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To use incoming branch of emscripten, use these commands instead:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
#(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install sdk-incoming-64bit&lt;br /&gt;
emsdk activate sdk-incoming-64bit&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To further use Gideros own git fork of emscripten:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
cd emscripten/incoming&lt;br /&gt;
# Add a git remote link to your own repository.&lt;br /&gt;
git remote add gideros https://github.com/gideros/emscripten.git&lt;br /&gt;
# Obtain the changes in your link.&lt;br /&gt;
git fetch gideros&lt;br /&gt;
# Switch the emscripten-incoming tool to use your fork.&lt;br /&gt;
git checkout -b gideros_incoming --track gideros/incoming&lt;br /&gt;
#Get back to emscripten directory and rebuild&lt;br /&gt;
cd ../..&lt;br /&gt;
emsdk install sdk-incoming-64bit&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
These can also be installed within emsdk: git, crunch, and spidermonkey&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install git-1.9.4&lt;br /&gt;
emsdk install crunch-1.03&lt;br /&gt;
emsdk install spidermonkey-37.0.1-64bit&lt;br /&gt;
emsdk activate git-1.9.4&lt;br /&gt;
emsdk activate crunch-1.03&lt;br /&gt;
emsdk activate spidermonkey-37.0.1-64bit&lt;br /&gt;
(PC) emsdk_env.bat&lt;br /&gt;
(MAC) source ./emsdk_env.sh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(PC) Make sure the environment variable EM_CONFIG is set to the location of your emscripten config file.&lt;br /&gt;
&lt;br /&gt;
The emscripten build also needs the CMake command.  You can download it and extract it to your home or C: folder.  Don&#039;t forget to add it&#039;s path to the end of the EMSDKPATH in Makefile.def.&lt;br /&gt;
&lt;br /&gt;
https://cmake.org/download/&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.11 Install Steam SDK ===&lt;br /&gt;
    https://partner.steamgames.com/?goto=%2Fdownloads%2Fsteamworks_sdk.zip&lt;br /&gt;
&lt;br /&gt;
Extract the archive/zip file to your home or C: folder, for example if the file is called &#039;steamworks_sdk_142.zip&#039; then you will have a &#039;c:\steamworks_sdk_142&#039; folder with a solder called &#039;sdk&#039; within it.  The sdk folder contains other folders such as glmgr, public, tools, etc.&lt;br /&gt;
&lt;br /&gt;
This is necessary for the Steam plugin.&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.12 Install Gideros ===&lt;br /&gt;
&lt;br /&gt;
==== 1.12.1 Fetch gideros source code ====&lt;br /&gt;
(PC) Open MSYS2 32 bit shell&lt;br /&gt;
&lt;br /&gt;
(MAC/Linux) Open a terminal&lt;br /&gt;
&lt;br /&gt;
Navigate to the folder where you into to work.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    git clone https://github.com/gideros/gideros &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== 1.12.2 Configure scripts ====&lt;br /&gt;
Make a copy of the file gideros/scripts/Makefile.def.example, rename it to Makefile.def and update the file copy according &lt;br /&gt;
to your installation. Ensure that the QT\_ARCH and QT_TOOLSARCH paths are formatted correctly according to your Qt &lt;br /&gt;
install directory structure (see below that they are named differently by Qt).&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;&#039;&#039;&#039;Example:&#039;&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;On PC:&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
For Qt:&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;gt;QTBASEDIR=/c/Qt&lt;br /&gt;
QT_ARCH=mingw53_32&lt;br /&gt;
QT_TOOLSARCH=mingw530_32&lt;br /&gt;
QTVER=5.9.1&lt;br /&gt;
QT5ICUVER=59&lt;br /&gt;
&lt;br /&gt;
STEAMSDK=/c/Applications/steamworks_sdk_142&lt;br /&gt;
export STEAMSDK&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
For Android:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
# on Windows, also add this to PATH&lt;br /&gt;
NDK_HOME=/c/android/android-ndk-r17b&lt;br /&gt;
NDKBUILD=cmd //c /c/android/android-ndk-r17b/ndk-build.cmd&lt;br /&gt;
#We use windows syntax for this one, as it will be used by gradle.bat script&lt;br /&gt;
JAVA_HOME=C:\Program Files\Java\jdk1.8.0_144&lt;br /&gt;
#Windows syntax with quadruple backslashs!&lt;br /&gt;
ANDROID_HOME=C:\\\\Users\\\\Gideros\\\\AppData\\\\Local\\\\Android\\\\sdk&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
For WinRT:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
FXC=&amp;quot;/c/Program Files (x86)/Windows Kits/8.1/bin/x86/fxc.exe&amp;quot; &lt;br /&gt;
MSBUILD=&amp;quot;/c/Program Files (x86)/MSBuild/14.0/Bin/MSbuild.exe&amp;quot; &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
For html5:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
EMSDK=/c/emsdkwin&lt;br /&gt;
EMSDKPATH=$(EMSDK):$(EMSDK)/clang/e1.35.0_64bit:$(EMSDK)/node/4.1.1_64bit/bin:$(EMSDK)/python/2.7.5.3_64bit:$(EMSDK)/emscripten/1.35.0&lt;br /&gt;
EMSDK_PREFIX=PATH=$(EMSDKPATH):$$$$PATH cmd //c&lt;br /&gt;
CRUNCHME=crunchme-win32.exe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;On MAC:&#039;&#039;&#039; &lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
QTBASEDIR=~/Qt QT_ARCH=clang_64 &lt;br /&gt;
QT_TOOLSARCH=clang_64 &lt;br /&gt;
QTVER=5.8 &lt;br /&gt;
QT5ICUVER=54 #deprecated stuff &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;On Linux:&#039;&#039;&#039; &lt;br /&gt;
(tested on Debian 11)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
QT=/usr&lt;br /&gt;
QMAKE=qmake6&lt;br /&gt;
QTLIBS=/lib/x86_64-linux-gnu&lt;br /&gt;
QTPLUGINS=$(QTLIBS)/qt6/plugins&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== 1.12.3 Complete working example Makefile.def for Windows ====&lt;br /&gt;
&lt;br /&gt;
Here is a working example, you will have to change the filename details to match your setup:&lt;br /&gt;
&lt;br /&gt;
[[Example Makefile.def file|example Makefile.def file]].&lt;br /&gt;
&lt;br /&gt;
==== 1.12.4 Fetch additional repositories ====&lt;br /&gt;
&lt;br /&gt;
Go into just cloned gideros source folder and run make prep.repo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    cd gideros&lt;br /&gt;
    make -f scripts/Makefile.gid prep.repo &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
If you intend to build the studio, you&#039;ll need scintilla and Lexilla libraries. Compile them now with:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    make -f scripts/Makefile.gid qlexilla&lt;br /&gt;
    make -f scripts/Makefile.gid qscintilla&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
== 2. Building ==&lt;br /&gt;
&lt;br /&gt;
If you have all dependencies in place for all targets, you can build everything at once via MSYS2 or Terminal with:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 2.1 Compilation on PC :===&lt;br /&gt;
&lt;br /&gt;
Open MSYS2 shell (msys2_shell.cmd). Standard compilation is 32 bit so use a 32 bit shell. Make sure you have installed the necessary build tools in MSYS2 using pacman, as detailed in [[#1.2 (PC) Install MSYS2 Console|Install MSYS2 Console]].&lt;br /&gt;
.&lt;br /&gt;
&lt;br /&gt;
Navigate to gideros folder &lt;br /&gt;
 &lt;br /&gt;
==== 2.1.1 Build QT tools : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid qtapp.install&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
-&amp;gt; files GiderosStudio.exe, GiderosPlayer.exe, GiderosTexturePacker.exe (…) in Build.Win folder &lt;br /&gt;
&lt;br /&gt;
==== 2.1.2 Android: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid android.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= file GiderosAndroidPlayer.apk in folder Build.Win/Players &lt;br /&gt;
&lt;br /&gt;
==== 2.1.3 winRT: ====&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;If necessary :&#039;&#039;&lt;br /&gt;
Open the solution, gideros/winRT_example/giderosgame.sln in Visual Studio. Check that the SQLite version for Windows and Windows Phone is up to date. Save and close the solution. &lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid winrt.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= file _bundle.appxupload in folder Build.Win/Players/WinRT&lt;br /&gt;
&lt;br /&gt;
==== 2.1.4 win32: ====&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid win32.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= files in folder Build.Win/Templates/win32 &lt;br /&gt;
 &lt;br /&gt;
==== 2.1.5 Html5: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid html5.install&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
-&amp;gt; files in folders Build.Win//Players/Html5 and Build.Win/Templates/Html5&lt;br /&gt;
&lt;br /&gt;
==== 2.1.6 Plugins: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.win &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= folder bin and file gplugin in folder Build.Win/All Plugins&lt;br /&gt;
&lt;br /&gt;
==== 2.1.7 To build everything that can be built on Windows ====&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid all&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Then you need to copy all the plugins to the &#039;Build.Win&#039; folder with:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.win&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 2.2 Compilation on Mac :===&lt;br /&gt;
Open Terminal.  &lt;br /&gt;
&lt;br /&gt;
cd to the folder « gideros » &lt;br /&gt;
&lt;br /&gt;
==== 2.2.1 QT : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid qtapp.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= GiderosStudio.exe, GiderosPlayer.exe, GiderosTexturePacker.exe (…) in folder Build.Mac &lt;br /&gt;
&lt;br /&gt;
==== 2.2.2 iOS : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid ios.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= GiderosiOSPlayer.zip in folder Buid.Mac/Players &lt;br /&gt;
&lt;br /&gt;
==== 2.2.3 Plugins: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.mac &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= folders bin and files gplugin in folder Buid.Mac/All Plugins&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
== 3. Cleaning ==&lt;br /&gt;
&lt;br /&gt;
If you want to reset the build process and start again then you can issue a &#039;clean&#039; command.  To do this type &#039;make -f scripts/Makefile.gid clean&#039;.&lt;br /&gt;
&lt;br /&gt;
eg:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid clean&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Sometimes you need to make a clean a particular build.  To do this type &#039;make -f scripts/Makefile.gid &#039; followed by something like &#039;html5&#039; then &#039;.clean&#039;.&lt;br /&gt;
&lt;br /&gt;
eg:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid html5.clean&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Compiling_Gideros_Source&amp;diff=22487</id>
		<title>Compiling Gideros Source</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Compiling_Gideros_Source&amp;diff=22487"/>
		<updated>2023-08-22T12:28:50Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* 1.3.1 (Linux/Debian) Install Git, build-tools */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;The following instructions are for developers who want to contribute to or otherwise experiment with the Gideros C/C++ engine and are &#039;&#039;not&#039;&#039; necessary for either building or deploying apps made with Gideros.&lt;br /&gt;
&lt;br /&gt;
The Gideros project consists of the Gideros Studio IDE, the Gideros SDK libraries, Gideros Texture Packer, Gideros Font Creator, &amp;quot;players&amp;quot; or export templates for all the platforms Gideros supports, all targets of all plugins, a daemon and a bridge. The build system is flexible, so you only need the tools for the targets you are interested in deploying to with Qt (and MSYS2 on Windows) being a realistic minimum.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div class=&amp;quot;noautonum&amp;quot;&amp;gt;__TOC__&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 1. Requirements ==&lt;br /&gt;
=== 1.1 Install QT ===&lt;br /&gt;
https://www.qt.io/download-open-source/&lt;br /&gt;
&lt;br /&gt;
Recommended version 6.3 with MinGW &amp;lt;br /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Double click on the downloaded file and follow instructions. When installing, expand the tree view and ensure you have ticked the MinGW child option of the Qt version checkbox, as well as the MinGW option in the Tools section.&lt;br /&gt;
Beside main QT package, you&#039;ll need the following additional components:&lt;br /&gt;
* WebSocket additional library&lt;br /&gt;
* Multimedia additional library&lt;br /&gt;
* Qt5 Compatibility addon&lt;br /&gt;
  &lt;br /&gt;
(MAC) Move the created folder into your user account folder &lt;br /&gt;
&lt;br /&gt;
(LINUX) &lt;br /&gt;
On Debian 11:&lt;br /&gt;
echo &amp;quot;deb http://deb.debian.org/debian bullseye-backports main&amp;quot; &amp;gt;&amp;gt;/etc/apt/sources.list&lt;br /&gt;
apt update&lt;br /&gt;
apt install qt6-base-dev qt6-websockets-dev qt6-multimedia-dev qt6-5compat-dev&lt;br /&gt;
&lt;br /&gt;
Depending on your distribution, you may need to install qt5 websocket lib seperately (sudo apt-get install libqt5websockets5-dev)&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
===1.2 (PC) Install MSYS2 Console===&lt;br /&gt;
    https://msys2.github.io/ &lt;br /&gt;
&lt;br /&gt;
Double click on the downloaded file (msys2-i686) and follow instructions. &lt;br /&gt;
&lt;br /&gt;
Open 32 bit MSYS2 shell: msys2_shell.cmd&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
pacman -Sy pacman&lt;br /&gt;
pacman -Syu&lt;br /&gt;
pacman -Su&lt;br /&gt;
pacman -S tar&lt;br /&gt;
pacman -S zip&lt;br /&gt;
pacman -S unzip&lt;br /&gt;
pacman -S git&lt;br /&gt;
pacman -S base-devel&lt;br /&gt;
pacman -S python&lt;br /&gt;
#For compiling win32/32bit under a MinGW64&lt;br /&gt;
pacman -S mingw-w64-i686-toolchain&lt;br /&gt;
pacman -S mingw-w64-i686-glew&lt;br /&gt;
pacman -S mingw-w64-i686-curl&lt;br /&gt;
pacman -S mingw-w64-i686-libpng&lt;br /&gt;
#For compiling win32/64bit under a MinGW64&lt;br /&gt;
pacman -S mingw-w64-x86_64-toolchain&lt;br /&gt;
pacman -S mingw-w64-x86_64-glew&lt;br /&gt;
pacman -S mingw-w64-x86_64-curl&lt;br /&gt;
pacman -S mingw-w64-x86_64-libpng&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.3 (Mac) Install Git &amp;amp; xcpretty ===&lt;br /&gt;
    http://git-scm.com/downloads&lt;br /&gt;
    &lt;br /&gt;
Ctrl + right click, open with « Install program.app » Follow instructions keeping default values as they are. &lt;br /&gt;
&lt;br /&gt;
(MAC) open a terminal window &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
git config -global user.name &amp;quot;your git login&amp;quot; &lt;br /&gt;
git config -global user.email &amp;quot;your git email&amp;quot;&lt;br /&gt;
sudo gem install xcpretty&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
=== 1.3.1 (Linux/Debian) Install Git, build-tools ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
apt install git build-essential libxcb-xinerama0 libgl1-mesa-dev libz-dev libasound2-dev libglew-dev libglfw3-dev libcurl4-openssl-dev patchelf&lt;br /&gt;
git config --global user.email &amp;quot;your git email&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.4 (PC) Android requirements ===&lt;br /&gt;
&lt;br /&gt;
==== 1.4.1 Install Android Studio and NDK ====&lt;br /&gt;
&lt;br /&gt;
    https://developer.android.com/studio/index.html&lt;br /&gt;
    https://developer.android.com/ndk/downloads/older_releases.html&lt;br /&gt;
&lt;br /&gt;
Recommended NDK is 25c (the x86_64 version)&lt;br /&gt;
&lt;br /&gt;
Once downloaded, copy the contents of the NDK to your home or C: folder, rename the folder that you copied to &#039;android-ndk&#039;, for example you will end up with &#039;c:\android-ndk&#039; and below that folders that say build, meta, platforms, etc.&lt;br /&gt;
&lt;br /&gt;
==== 1.4.2 Install Ant (no longer required but kept util someone confirms this)====&lt;br /&gt;
    https://ant.apache.org/&lt;br /&gt;
&lt;br /&gt;
Once downloaded, copy the contents of the install archive/zip file to your home folder or C: drive.&lt;br /&gt;
Eg: so you have a folder called c:\apache-ant-1.10.5 with bin, etc, lib, manual folders within that.&lt;br /&gt;
&lt;br /&gt;
==== 1.4.3 Mix Old and New Tools (no longer required but kept util someone confirms this) ====&lt;br /&gt;
&lt;br /&gt;
Gideros uses Ant to build the player, unfortunately the tools to support Ant are now missing from the latest Android tools.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
There is a fix for this:&lt;br /&gt;
&lt;br /&gt;
# Rename the existing &#039;tools&#039; folder in the Android SDK folder to &#039;tools_new&#039;.&lt;br /&gt;
# Download an older (March 2016) version of the tools and copy that folder to the Android SDK folder.&lt;br /&gt;
# Copy the contents of &#039;tools_new&#039; over the contents of &#039;tools&#039;.&lt;br /&gt;
&lt;br /&gt;
Here is where you can download the compatible set of tools from:&lt;br /&gt;
&lt;br /&gt;
(PC) https://dl.google.com/android/repository/tools_r25.2.5-windows.zip&lt;br /&gt;
&lt;br /&gt;
(MAC) https://dl.google.com/android/repository/tools_r25.2.5-macosx.zip&lt;br /&gt;
&lt;br /&gt;
(LINUX) https://dl.google.com/android/repository/tools_r25.2.5-linux.zip&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.5 Install Java ===&lt;br /&gt;
You need the Java JDK&lt;br /&gt;
https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.6 (PC) Install Visual Studio ===&lt;br /&gt;
    https://www.visualstudio.com/downloads/&lt;br /&gt;
&lt;br /&gt;
Install [https://developer.microsoft.com/en-us/windows/downloads/windows-8-1-sdk Win 8.1 SDK]&lt;br /&gt;
&lt;br /&gt;
Install [https://marketplace.visualstudio.com/items?itemName=AdMediator.MicrosoftAdvertisingSDKforWindowsandWindowsPhone8x Microsoft Advertising SDK for Windows and Windows Phone 8.x]&lt;br /&gt;
&lt;br /&gt;
Ensure that you have MSBuild v12 or v14 installed (building with the makefile will fail with an incorrect version).&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.7 (MAC) Install Xcode ===&lt;br /&gt;
    https://itunes.apple.com/fr/app/xcode/id497799835?mt=12&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.8 (Mac) ensure xcode command line tools are working ===&lt;br /&gt;
(MAC) Open a terminal window &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
sudo xCodebuild -license &lt;br /&gt;
quit&lt;br /&gt;
agree&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br /&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.9 Install Python ===&lt;br /&gt;
https://www.python.org/downloads/release/python-2712/&lt;br /&gt;
&lt;br /&gt;
You need Python 2.7.12 or later to install emscripten properly.&lt;br /&gt;
&lt;br /&gt;
Once installed, add it to your command line path, eg: c:\python27, on windows you can do this by right-clicking on &#039;myComputer&#039; or &#039;This PC&#039;, go to &#039;Properties&#039;, click &#039;Advanced System Settings&#039;, Click &#039;Environmental Variables&#039;, double-click &#039;Path&#039;, add &#039;c:\python27&#039;.&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.10 Install emscripten ===&lt;br /&gt;
    http://kripken.github.io/emscripten-site/&lt;br /&gt;
&lt;br /&gt;
You need this is you want to build for HTML5 + Facebook games.&lt;br /&gt;
&lt;br /&gt;
Using a shell or MSYS2 (previously installed) on windows, go to your home or C: folder and type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://github.com/juj/emsdk.git&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Once that has completed open a command prompt in that folder on Windows, on other system just cd to the folder.&lt;br /&gt;
&lt;br /&gt;
Using emsdk, install and activate all the latest packages:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
#(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install latest&lt;br /&gt;
emsdk activate latest&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(PC) Type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
emsdk_env.bat&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(MAC) Type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
source ./emsdk_env.sh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To use incoming branch of emscripten, use these commands instead:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
#(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install sdk-incoming-64bit&lt;br /&gt;
emsdk activate sdk-incoming-64bit&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To further use Gideros own git fork of emscripten:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
cd emscripten/incoming&lt;br /&gt;
# Add a git remote link to your own repository.&lt;br /&gt;
git remote add gideros https://github.com/gideros/emscripten.git&lt;br /&gt;
# Obtain the changes in your link.&lt;br /&gt;
git fetch gideros&lt;br /&gt;
# Switch the emscripten-incoming tool to use your fork.&lt;br /&gt;
git checkout -b gideros_incoming --track gideros/incoming&lt;br /&gt;
#Get back to emscripten directory and rebuild&lt;br /&gt;
cd ../..&lt;br /&gt;
emsdk install sdk-incoming-64bit&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
These can also be installed within emsdk: git, crunch, and spidermonkey&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install git-1.9.4&lt;br /&gt;
emsdk install crunch-1.03&lt;br /&gt;
emsdk install spidermonkey-37.0.1-64bit&lt;br /&gt;
emsdk activate git-1.9.4&lt;br /&gt;
emsdk activate crunch-1.03&lt;br /&gt;
emsdk activate spidermonkey-37.0.1-64bit&lt;br /&gt;
(PC) emsdk_env.bat&lt;br /&gt;
(MAC) source ./emsdk_env.sh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(PC) Make sure the environment variable EM_CONFIG is set to the location of your emscripten config file.&lt;br /&gt;
&lt;br /&gt;
The emscripten build also needs the CMake command.  You can download it and extract it to your home or C: folder.  Don&#039;t forget to add it&#039;s path to the end of the EMSDKPATH in Makefile.def.&lt;br /&gt;
&lt;br /&gt;
https://cmake.org/download/&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.11 Install Steam SDK ===&lt;br /&gt;
    https://partner.steamgames.com/?goto=%2Fdownloads%2Fsteamworks_sdk.zip&lt;br /&gt;
&lt;br /&gt;
Extract the archive/zip file to your home or C: folder, for example if the file is called &#039;steamworks_sdk_142.zip&#039; then you will have a &#039;c:\steamworks_sdk_142&#039; folder with a solder called &#039;sdk&#039; within it.  The sdk folder contains other folders such as glmgr, public, tools, etc.&lt;br /&gt;
&lt;br /&gt;
This is necessary for the Steam plugin.&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.12 Install Gideros ===&lt;br /&gt;
&lt;br /&gt;
==== 1.12.1 Fetch gideros source code ====&lt;br /&gt;
(PC) Open MSYS2 32 bit shell&lt;br /&gt;
&lt;br /&gt;
(MAC/Linux) Open a terminal&lt;br /&gt;
&lt;br /&gt;
Navigate to the folder where you into to work.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    git clone https://github.com/gideros/gideros &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== 1.12.2 Configure scripts ====&lt;br /&gt;
Make a copy of the file gideros/scripts/Makefile.def.example, rename it to Makefile.def and update the file copy according &lt;br /&gt;
to your installation. Ensure that the QT\_ARCH and QT_TOOLSARCH paths are formatted correctly according to your Qt &lt;br /&gt;
install directory structure (see below that they are named differently by Qt).&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;&#039;&#039;&#039;Example:&#039;&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;On PC:&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
For Qt:&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;gt;QTBASEDIR=/c/Qt&lt;br /&gt;
QT_ARCH=mingw53_32&lt;br /&gt;
QT_TOOLSARCH=mingw530_32&lt;br /&gt;
QTVER=5.9.1&lt;br /&gt;
QT5ICUVER=59&lt;br /&gt;
&lt;br /&gt;
STEAMSDK=/c/Applications/steamworks_sdk_142&lt;br /&gt;
export STEAMSDK&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
For Android:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
# on Windows, also add this to PATH&lt;br /&gt;
NDK_HOME=/c/android/android-ndk-r17b&lt;br /&gt;
NDKBUILD=cmd //c /c/android/android-ndk-r17b/ndk-build.cmd&lt;br /&gt;
#We use windows syntax for this one, as it will be used by gradle.bat script&lt;br /&gt;
JAVA_HOME=C:\Program Files\Java\jdk1.8.0_144&lt;br /&gt;
#Windows syntax with quadruple backslashs!&lt;br /&gt;
ANDROID_HOME=C:\\\\Users\\\\Gideros\\\\AppData\\\\Local\\\\Android\\\\sdk&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
For WinRT:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
FXC=&amp;quot;/c/Program Files (x86)/Windows Kits/8.1/bin/x86/fxc.exe&amp;quot; &lt;br /&gt;
MSBUILD=&amp;quot;/c/Program Files (x86)/MSBuild/14.0/Bin/MSbuild.exe&amp;quot; &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
For html5:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
EMSDK=/c/emsdkwin&lt;br /&gt;
EMSDKPATH=$(EMSDK):$(EMSDK)/clang/e1.35.0_64bit:$(EMSDK)/node/4.1.1_64bit/bin:$(EMSDK)/python/2.7.5.3_64bit:$(EMSDK)/emscripten/1.35.0&lt;br /&gt;
EMSDK_PREFIX=PATH=$(EMSDKPATH):$$$$PATH cmd //c&lt;br /&gt;
CRUNCHME=crunchme-win32.exe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;On MAC:&#039;&#039;&#039; &lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
QTBASEDIR=~/Qt QT_ARCH=clang_64 &lt;br /&gt;
QT_TOOLSARCH=clang_64 &lt;br /&gt;
QTVER=5.8 &lt;br /&gt;
QT5ICUVER=54 #deprecated stuff &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;On Linux:&#039;&#039;&#039; &lt;br /&gt;
(tested on Debian 11)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
QT=/usr&lt;br /&gt;
QMAKE=qmake6&lt;br /&gt;
QTLIBS=/lib/x86_64-linux-gnu&lt;br /&gt;
QTPLUGINS=$(QTLIBS)/qt6/plugins&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== 1.12.3 Complete working example Makefile.def for Windows ====&lt;br /&gt;
&lt;br /&gt;
Here is a working example, you will have to change the filename details to match your setup:&lt;br /&gt;
&lt;br /&gt;
[[Example Makefile.def file|example Makefile.def file]].&lt;br /&gt;
&lt;br /&gt;
==== 1.12.4 Fetch additional repositories ====&lt;br /&gt;
&lt;br /&gt;
Go into just cloned gideros source folder and run make prep.repo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    cd gideros&lt;br /&gt;
    make -f scripts/Makefile.gid prep.repo &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
If you intend to build the studio, you&#039;ll need scintilla and Lexilla libraries. Compile them now with:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    make -f scripts/Makefile.gid qlexilla&lt;br /&gt;
    make -f scripts/Makefile.gid qscintilla&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
== 2. Building ==&lt;br /&gt;
&lt;br /&gt;
If you have all dependencies in place for all targets, you can build everything at once via MSYS2 or Terminal with:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 2.1 Compilation on PC :===&lt;br /&gt;
&lt;br /&gt;
Open MSYS2 shell (msys2_shell.cmd). Standard compilation is 32 bit so use a 32 bit shell. Make sure you have installed the necessary build tools in MSYS2 using pacman, as detailed in [[#1.2 (PC) Install MSYS2 Console|Install MSYS2 Console]].&lt;br /&gt;
.&lt;br /&gt;
&lt;br /&gt;
Navigate to gideros folder &lt;br /&gt;
 &lt;br /&gt;
==== 2.1.1 Build QT tools : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid qtapp.install&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
-&amp;gt; files GiderosStudio.exe, GiderosPlayer.exe, GiderosTexturePacker.exe (…) in Build.Win folder &lt;br /&gt;
&lt;br /&gt;
==== 2.1.2 Android: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid android.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= file GiderosAndroidPlayer.apk in folder Build.Win/Players &lt;br /&gt;
&lt;br /&gt;
==== 2.1.3 winRT: ====&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;If necessary :&#039;&#039;&lt;br /&gt;
Open the solution, gideros/winRT_example/giderosgame.sln in Visual Studio. Check that the SQLite version for Windows and Windows Phone is up to date. Save and close the solution. &lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid winrt.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= file _bundle.appxupload in folder Build.Win/Players/WinRT&lt;br /&gt;
&lt;br /&gt;
==== 2.1.4 win32: ====&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid win32.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= files in folder Build.Win/Templates/win32 &lt;br /&gt;
 &lt;br /&gt;
==== 2.1.5 Html5: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid html5.install&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
-&amp;gt; files in folders Build.Win//Players/Html5 and Build.Win/Templates/Html5&lt;br /&gt;
&lt;br /&gt;
==== 2.1.6 Plugins: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.win &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= folder bin and file gplugin in folder Build.Win/All Plugins&lt;br /&gt;
&lt;br /&gt;
==== 2.1.7 To build everything that can be built on Windows ====&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid all&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Then you need to copy all the plugins to the &#039;Build.Win&#039; folder with:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.win&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 2.2 Compilation on Mac :===&lt;br /&gt;
Open Terminal.  &lt;br /&gt;
&lt;br /&gt;
cd to the folder « gideros » &lt;br /&gt;
&lt;br /&gt;
==== 2.2.1 QT : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid qtapp.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= GiderosStudio.exe, GiderosPlayer.exe, GiderosTexturePacker.exe (…) in folder Build.Mac &lt;br /&gt;
&lt;br /&gt;
==== 2.2.2 iOS : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid ios.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= GiderosiOSPlayer.zip in folder Buid.Mac/Players &lt;br /&gt;
&lt;br /&gt;
==== 2.2.3 Plugins: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.mac &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= folders bin and files gplugin in folder Buid.Mac/All Plugins&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
== 3. Cleaning ==&lt;br /&gt;
&lt;br /&gt;
If you want to reset the build process and start again then you can issue a &#039;clean&#039; command.  To do this type &#039;make -f scripts/Makefile.gid clean&#039;.&lt;br /&gt;
&lt;br /&gt;
eg:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid clean&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Sometimes you need to make a clean a particular build.  To do this type &#039;make -f scripts/Makefile.gid &#039; followed by something like &#039;html5&#039; then &#039;.clean&#039;.&lt;br /&gt;
&lt;br /&gt;
eg:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid html5.clean&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Compiling_Gideros_Source&amp;diff=22486</id>
		<title>Compiling Gideros Source</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Compiling_Gideros_Source&amp;diff=22486"/>
		<updated>2023-08-21T13:45:18Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* 1.3.1 (Linux/Debian) Install Git, build-tools */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;The following instructions are for developers who want to contribute to or otherwise experiment with the Gideros C/C++ engine and are &#039;&#039;not&#039;&#039; necessary for either building or deploying apps made with Gideros.&lt;br /&gt;
&lt;br /&gt;
The Gideros project consists of the Gideros Studio IDE, the Gideros SDK libraries, Gideros Texture Packer, Gideros Font Creator, &amp;quot;players&amp;quot; or export templates for all the platforms Gideros supports, all targets of all plugins, a daemon and a bridge. The build system is flexible, so you only need the tools for the targets you are interested in deploying to with Qt (and MSYS2 on Windows) being a realistic minimum.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div class=&amp;quot;noautonum&amp;quot;&amp;gt;__TOC__&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 1. Requirements ==&lt;br /&gt;
=== 1.1 Install QT ===&lt;br /&gt;
https://www.qt.io/download-open-source/&lt;br /&gt;
&lt;br /&gt;
Recommended version 6.3 with MinGW &amp;lt;br /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Double click on the downloaded file and follow instructions. When installing, expand the tree view and ensure you have ticked the MinGW child option of the Qt version checkbox, as well as the MinGW option in the Tools section.&lt;br /&gt;
Beside main QT package, you&#039;ll need the following additional components:&lt;br /&gt;
* WebSocket additional library&lt;br /&gt;
* Multimedia additional library&lt;br /&gt;
* Qt5 Compatibility addon&lt;br /&gt;
  &lt;br /&gt;
(MAC) Move the created folder into your user account folder &lt;br /&gt;
&lt;br /&gt;
(LINUX) &lt;br /&gt;
On Debian 11:&lt;br /&gt;
echo &amp;quot;deb http://deb.debian.org/debian bullseye-backports main&amp;quot; &amp;gt;&amp;gt;/etc/apt/sources.list&lt;br /&gt;
apt update&lt;br /&gt;
apt install qt6-base-dev qt6-websockets-dev qt6-multimedia-dev qt6-5compat-dev&lt;br /&gt;
&lt;br /&gt;
Depending on your distribution, you may need to install qt5 websocket lib seperately (sudo apt-get install libqt5websockets5-dev)&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
===1.2 (PC) Install MSYS2 Console===&lt;br /&gt;
    https://msys2.github.io/ &lt;br /&gt;
&lt;br /&gt;
Double click on the downloaded file (msys2-i686) and follow instructions. &lt;br /&gt;
&lt;br /&gt;
Open 32 bit MSYS2 shell: msys2_shell.cmd&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
pacman -Sy pacman&lt;br /&gt;
pacman -Syu&lt;br /&gt;
pacman -Su&lt;br /&gt;
pacman -S tar&lt;br /&gt;
pacman -S zip&lt;br /&gt;
pacman -S unzip&lt;br /&gt;
pacman -S git&lt;br /&gt;
pacman -S base-devel&lt;br /&gt;
pacman -S python&lt;br /&gt;
#For compiling win32/32bit under a MinGW64&lt;br /&gt;
pacman -S mingw-w64-i686-toolchain&lt;br /&gt;
pacman -S mingw-w64-i686-glew&lt;br /&gt;
pacman -S mingw-w64-i686-curl&lt;br /&gt;
pacman -S mingw-w64-i686-libpng&lt;br /&gt;
#For compiling win32/64bit under a MinGW64&lt;br /&gt;
pacman -S mingw-w64-x86_64-toolchain&lt;br /&gt;
pacman -S mingw-w64-x86_64-glew&lt;br /&gt;
pacman -S mingw-w64-x86_64-curl&lt;br /&gt;
pacman -S mingw-w64-x86_64-libpng&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.3 (Mac) Install Git &amp;amp; xcpretty ===&lt;br /&gt;
    http://git-scm.com/downloads&lt;br /&gt;
    &lt;br /&gt;
Ctrl + right click, open with « Install program.app » Follow instructions keeping default values as they are. &lt;br /&gt;
&lt;br /&gt;
(MAC) open a terminal window &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
git config -global user.name &amp;quot;your git login&amp;quot; &lt;br /&gt;
git config -global user.email &amp;quot;your git email&amp;quot;&lt;br /&gt;
sudo gem install xcpretty&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
=== 1.3.1 (Linux/Debian) Install Git, build-tools ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
apt install git build-essential libxcb-xinerama0 libgl1-mesa-dev libz-dev libasound2-dev libglew-dev libglfw3-dev libcurl4-openssl-dev&lt;br /&gt;
git config --global user.email &amp;quot;your git email&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.4 (PC) Android requirements ===&lt;br /&gt;
&lt;br /&gt;
==== 1.4.1 Install Android Studio and NDK ====&lt;br /&gt;
&lt;br /&gt;
    https://developer.android.com/studio/index.html&lt;br /&gt;
    https://developer.android.com/ndk/downloads/older_releases.html&lt;br /&gt;
&lt;br /&gt;
Recommended NDK is 25c (the x86_64 version)&lt;br /&gt;
&lt;br /&gt;
Once downloaded, copy the contents of the NDK to your home or C: folder, rename the folder that you copied to &#039;android-ndk&#039;, for example you will end up with &#039;c:\android-ndk&#039; and below that folders that say build, meta, platforms, etc.&lt;br /&gt;
&lt;br /&gt;
==== 1.4.2 Install Ant (no longer required but kept util someone confirms this)====&lt;br /&gt;
    https://ant.apache.org/&lt;br /&gt;
&lt;br /&gt;
Once downloaded, copy the contents of the install archive/zip file to your home folder or C: drive.&lt;br /&gt;
Eg: so you have a folder called c:\apache-ant-1.10.5 with bin, etc, lib, manual folders within that.&lt;br /&gt;
&lt;br /&gt;
==== 1.4.3 Mix Old and New Tools (no longer required but kept util someone confirms this) ====&lt;br /&gt;
&lt;br /&gt;
Gideros uses Ant to build the player, unfortunately the tools to support Ant are now missing from the latest Android tools.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
There is a fix for this:&lt;br /&gt;
&lt;br /&gt;
# Rename the existing &#039;tools&#039; folder in the Android SDK folder to &#039;tools_new&#039;.&lt;br /&gt;
# Download an older (March 2016) version of the tools and copy that folder to the Android SDK folder.&lt;br /&gt;
# Copy the contents of &#039;tools_new&#039; over the contents of &#039;tools&#039;.&lt;br /&gt;
&lt;br /&gt;
Here is where you can download the compatible set of tools from:&lt;br /&gt;
&lt;br /&gt;
(PC) https://dl.google.com/android/repository/tools_r25.2.5-windows.zip&lt;br /&gt;
&lt;br /&gt;
(MAC) https://dl.google.com/android/repository/tools_r25.2.5-macosx.zip&lt;br /&gt;
&lt;br /&gt;
(LINUX) https://dl.google.com/android/repository/tools_r25.2.5-linux.zip&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.5 Install Java ===&lt;br /&gt;
You need the Java JDK&lt;br /&gt;
https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.6 (PC) Install Visual Studio ===&lt;br /&gt;
    https://www.visualstudio.com/downloads/&lt;br /&gt;
&lt;br /&gt;
Install [https://developer.microsoft.com/en-us/windows/downloads/windows-8-1-sdk Win 8.1 SDK]&lt;br /&gt;
&lt;br /&gt;
Install [https://marketplace.visualstudio.com/items?itemName=AdMediator.MicrosoftAdvertisingSDKforWindowsandWindowsPhone8x Microsoft Advertising SDK for Windows and Windows Phone 8.x]&lt;br /&gt;
&lt;br /&gt;
Ensure that you have MSBuild v12 or v14 installed (building with the makefile will fail with an incorrect version).&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.7 (MAC) Install Xcode ===&lt;br /&gt;
    https://itunes.apple.com/fr/app/xcode/id497799835?mt=12&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.8 (Mac) ensure xcode command line tools are working ===&lt;br /&gt;
(MAC) Open a terminal window &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
sudo xCodebuild -license &lt;br /&gt;
quit&lt;br /&gt;
agree&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br /&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.9 Install Python ===&lt;br /&gt;
https://www.python.org/downloads/release/python-2712/&lt;br /&gt;
&lt;br /&gt;
You need Python 2.7.12 or later to install emscripten properly.&lt;br /&gt;
&lt;br /&gt;
Once installed, add it to your command line path, eg: c:\python27, on windows you can do this by right-clicking on &#039;myComputer&#039; or &#039;This PC&#039;, go to &#039;Properties&#039;, click &#039;Advanced System Settings&#039;, Click &#039;Environmental Variables&#039;, double-click &#039;Path&#039;, add &#039;c:\python27&#039;.&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.10 Install emscripten ===&lt;br /&gt;
    http://kripken.github.io/emscripten-site/&lt;br /&gt;
&lt;br /&gt;
You need this is you want to build for HTML5 + Facebook games.&lt;br /&gt;
&lt;br /&gt;
Using a shell or MSYS2 (previously installed) on windows, go to your home or C: folder and type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://github.com/juj/emsdk.git&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Once that has completed open a command prompt in that folder on Windows, on other system just cd to the folder.&lt;br /&gt;
&lt;br /&gt;
Using emsdk, install and activate all the latest packages:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
#(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install latest&lt;br /&gt;
emsdk activate latest&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(PC) Type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
emsdk_env.bat&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(MAC) Type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
source ./emsdk_env.sh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To use incoming branch of emscripten, use these commands instead:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
#(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install sdk-incoming-64bit&lt;br /&gt;
emsdk activate sdk-incoming-64bit&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To further use Gideros own git fork of emscripten:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
cd emscripten/incoming&lt;br /&gt;
# Add a git remote link to your own repository.&lt;br /&gt;
git remote add gideros https://github.com/gideros/emscripten.git&lt;br /&gt;
# Obtain the changes in your link.&lt;br /&gt;
git fetch gideros&lt;br /&gt;
# Switch the emscripten-incoming tool to use your fork.&lt;br /&gt;
git checkout -b gideros_incoming --track gideros/incoming&lt;br /&gt;
#Get back to emscripten directory and rebuild&lt;br /&gt;
cd ../..&lt;br /&gt;
emsdk install sdk-incoming-64bit&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
These can also be installed within emsdk: git, crunch, and spidermonkey&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install git-1.9.4&lt;br /&gt;
emsdk install crunch-1.03&lt;br /&gt;
emsdk install spidermonkey-37.0.1-64bit&lt;br /&gt;
emsdk activate git-1.9.4&lt;br /&gt;
emsdk activate crunch-1.03&lt;br /&gt;
emsdk activate spidermonkey-37.0.1-64bit&lt;br /&gt;
(PC) emsdk_env.bat&lt;br /&gt;
(MAC) source ./emsdk_env.sh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(PC) Make sure the environment variable EM_CONFIG is set to the location of your emscripten config file.&lt;br /&gt;
&lt;br /&gt;
The emscripten build also needs the CMake command.  You can download it and extract it to your home or C: folder.  Don&#039;t forget to add it&#039;s path to the end of the EMSDKPATH in Makefile.def.&lt;br /&gt;
&lt;br /&gt;
https://cmake.org/download/&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.11 Install Steam SDK ===&lt;br /&gt;
    https://partner.steamgames.com/?goto=%2Fdownloads%2Fsteamworks_sdk.zip&lt;br /&gt;
&lt;br /&gt;
Extract the archive/zip file to your home or C: folder, for example if the file is called &#039;steamworks_sdk_142.zip&#039; then you will have a &#039;c:\steamworks_sdk_142&#039; folder with a solder called &#039;sdk&#039; within it.  The sdk folder contains other folders such as glmgr, public, tools, etc.&lt;br /&gt;
&lt;br /&gt;
This is necessary for the Steam plugin.&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.12 Install Gideros ===&lt;br /&gt;
&lt;br /&gt;
==== 1.12.1 Fetch gideros source code ====&lt;br /&gt;
(PC) Open MSYS2 32 bit shell&lt;br /&gt;
&lt;br /&gt;
(MAC/Linux) Open a terminal&lt;br /&gt;
&lt;br /&gt;
Navigate to the folder where you into to work.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    git clone https://github.com/gideros/gideros &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== 1.12.2 Configure scripts ====&lt;br /&gt;
Make a copy of the file gideros/scripts/Makefile.def.example, rename it to Makefile.def and update the file copy according &lt;br /&gt;
to your installation. Ensure that the QT\_ARCH and QT_TOOLSARCH paths are formatted correctly according to your Qt &lt;br /&gt;
install directory structure (see below that they are named differently by Qt).&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;&#039;&#039;&#039;Example:&#039;&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;On PC:&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
For Qt:&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;gt;QTBASEDIR=/c/Qt&lt;br /&gt;
QT_ARCH=mingw53_32&lt;br /&gt;
QT_TOOLSARCH=mingw530_32&lt;br /&gt;
QTVER=5.9.1&lt;br /&gt;
QT5ICUVER=59&lt;br /&gt;
&lt;br /&gt;
STEAMSDK=/c/Applications/steamworks_sdk_142&lt;br /&gt;
export STEAMSDK&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
For Android:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
# on Windows, also add this to PATH&lt;br /&gt;
NDK_HOME=/c/android/android-ndk-r17b&lt;br /&gt;
NDKBUILD=cmd //c /c/android/android-ndk-r17b/ndk-build.cmd&lt;br /&gt;
#We use windows syntax for this one, as it will be used by gradle.bat script&lt;br /&gt;
JAVA_HOME=C:\Program Files\Java\jdk1.8.0_144&lt;br /&gt;
#Windows syntax with quadruple backslashs!&lt;br /&gt;
ANDROID_HOME=C:\\\\Users\\\\Gideros\\\\AppData\\\\Local\\\\Android\\\\sdk&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
For WinRT:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
FXC=&amp;quot;/c/Program Files (x86)/Windows Kits/8.1/bin/x86/fxc.exe&amp;quot; &lt;br /&gt;
MSBUILD=&amp;quot;/c/Program Files (x86)/MSBuild/14.0/Bin/MSbuild.exe&amp;quot; &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
For html5:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
EMSDK=/c/emsdkwin&lt;br /&gt;
EMSDKPATH=$(EMSDK):$(EMSDK)/clang/e1.35.0_64bit:$(EMSDK)/node/4.1.1_64bit/bin:$(EMSDK)/python/2.7.5.3_64bit:$(EMSDK)/emscripten/1.35.0&lt;br /&gt;
EMSDK_PREFIX=PATH=$(EMSDKPATH):$$$$PATH cmd //c&lt;br /&gt;
CRUNCHME=crunchme-win32.exe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;On MAC:&#039;&#039;&#039; &lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
QTBASEDIR=~/Qt QT_ARCH=clang_64 &lt;br /&gt;
QT_TOOLSARCH=clang_64 &lt;br /&gt;
QTVER=5.8 &lt;br /&gt;
QT5ICUVER=54 #deprecated stuff &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;On Linux:&#039;&#039;&#039; &lt;br /&gt;
(tested on Debian 11)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
QT=/usr&lt;br /&gt;
QMAKE=qmake6&lt;br /&gt;
QTLIBS=/lib/x86_64-linux-gnu&lt;br /&gt;
QTPLUGINS=$(QTLIBS)/qt6/plugins&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== 1.12.3 Complete working example Makefile.def for Windows ====&lt;br /&gt;
&lt;br /&gt;
Here is a working example, you will have to change the filename details to match your setup:&lt;br /&gt;
&lt;br /&gt;
[[Example Makefile.def file|example Makefile.def file]].&lt;br /&gt;
&lt;br /&gt;
==== 1.12.4 Fetch additional repositories ====&lt;br /&gt;
&lt;br /&gt;
Go into just cloned gideros source folder and run make prep.repo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    cd gideros&lt;br /&gt;
    make -f scripts/Makefile.gid prep.repo &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
If you intend to build the studio, you&#039;ll need scintilla and Lexilla libraries. Compile them now with:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    make -f scripts/Makefile.gid qlexilla&lt;br /&gt;
    make -f scripts/Makefile.gid qscintilla&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
== 2. Building ==&lt;br /&gt;
&lt;br /&gt;
If you have all dependencies in place for all targets, you can build everything at once via MSYS2 or Terminal with:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 2.1 Compilation on PC :===&lt;br /&gt;
&lt;br /&gt;
Open MSYS2 shell (msys2_shell.cmd). Standard compilation is 32 bit so use a 32 bit shell. Make sure you have installed the necessary build tools in MSYS2 using pacman, as detailed in [[#1.2 (PC) Install MSYS2 Console|Install MSYS2 Console]].&lt;br /&gt;
.&lt;br /&gt;
&lt;br /&gt;
Navigate to gideros folder &lt;br /&gt;
 &lt;br /&gt;
==== 2.1.1 Build QT tools : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid qtapp.install&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
-&amp;gt; files GiderosStudio.exe, GiderosPlayer.exe, GiderosTexturePacker.exe (…) in Build.Win folder &lt;br /&gt;
&lt;br /&gt;
==== 2.1.2 Android: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid android.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= file GiderosAndroidPlayer.apk in folder Build.Win/Players &lt;br /&gt;
&lt;br /&gt;
==== 2.1.3 winRT: ====&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;If necessary :&#039;&#039;&lt;br /&gt;
Open the solution, gideros/winRT_example/giderosgame.sln in Visual Studio. Check that the SQLite version for Windows and Windows Phone is up to date. Save and close the solution. &lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid winrt.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= file _bundle.appxupload in folder Build.Win/Players/WinRT&lt;br /&gt;
&lt;br /&gt;
==== 2.1.4 win32: ====&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid win32.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= files in folder Build.Win/Templates/win32 &lt;br /&gt;
 &lt;br /&gt;
==== 2.1.5 Html5: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid html5.install&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
-&amp;gt; files in folders Build.Win//Players/Html5 and Build.Win/Templates/Html5&lt;br /&gt;
&lt;br /&gt;
==== 2.1.6 Plugins: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.win &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= folder bin and file gplugin in folder Build.Win/All Plugins&lt;br /&gt;
&lt;br /&gt;
==== 2.1.7 To build everything that can be built on Windows ====&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid all&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Then you need to copy all the plugins to the &#039;Build.Win&#039; folder with:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.win&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 2.2 Compilation on Mac :===&lt;br /&gt;
Open Terminal.  &lt;br /&gt;
&lt;br /&gt;
cd to the folder « gideros » &lt;br /&gt;
&lt;br /&gt;
==== 2.2.1 QT : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid qtapp.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= GiderosStudio.exe, GiderosPlayer.exe, GiderosTexturePacker.exe (…) in folder Build.Mac &lt;br /&gt;
&lt;br /&gt;
==== 2.2.2 iOS : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid ios.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= GiderosiOSPlayer.zip in folder Buid.Mac/Players &lt;br /&gt;
&lt;br /&gt;
==== 2.2.3 Plugins: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.mac &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= folders bin and files gplugin in folder Buid.Mac/All Plugins&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
== 3. Cleaning ==&lt;br /&gt;
&lt;br /&gt;
If you want to reset the build process and start again then you can issue a &#039;clean&#039; command.  To do this type &#039;make -f scripts/Makefile.gid clean&#039;.&lt;br /&gt;
&lt;br /&gt;
eg:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid clean&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Sometimes you need to make a clean a particular build.  To do this type &#039;make -f scripts/Makefile.gid &#039; followed by something like &#039;html5&#039; then &#039;.clean&#039;.&lt;br /&gt;
&lt;br /&gt;
eg:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid html5.clean&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Compiling_Gideros_Source&amp;diff=22485</id>
		<title>Compiling Gideros Source</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Compiling_Gideros_Source&amp;diff=22485"/>
		<updated>2023-08-21T07:48:16Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* 1.3.1 (Linux/Debian) Install Git, build-tools */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;The following instructions are for developers who want to contribute to or otherwise experiment with the Gideros C/C++ engine and are &#039;&#039;not&#039;&#039; necessary for either building or deploying apps made with Gideros.&lt;br /&gt;
&lt;br /&gt;
The Gideros project consists of the Gideros Studio IDE, the Gideros SDK libraries, Gideros Texture Packer, Gideros Font Creator, &amp;quot;players&amp;quot; or export templates for all the platforms Gideros supports, all targets of all plugins, a daemon and a bridge. The build system is flexible, so you only need the tools for the targets you are interested in deploying to with Qt (and MSYS2 on Windows) being a realistic minimum.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div class=&amp;quot;noautonum&amp;quot;&amp;gt;__TOC__&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 1. Requirements ==&lt;br /&gt;
=== 1.1 Install QT ===&lt;br /&gt;
https://www.qt.io/download-open-source/&lt;br /&gt;
&lt;br /&gt;
Recommended version 6.3 with MinGW &amp;lt;br /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Double click on the downloaded file and follow instructions. When installing, expand the tree view and ensure you have ticked the MinGW child option of the Qt version checkbox, as well as the MinGW option in the Tools section.&lt;br /&gt;
Beside main QT package, you&#039;ll need the following additional components:&lt;br /&gt;
* WebSocket additional library&lt;br /&gt;
* Multimedia additional library&lt;br /&gt;
* Qt5 Compatibility addon&lt;br /&gt;
  &lt;br /&gt;
(MAC) Move the created folder into your user account folder &lt;br /&gt;
&lt;br /&gt;
(LINUX) &lt;br /&gt;
On Debian 11:&lt;br /&gt;
echo &amp;quot;deb http://deb.debian.org/debian bullseye-backports main&amp;quot; &amp;gt;&amp;gt;/etc/apt/sources.list&lt;br /&gt;
apt update&lt;br /&gt;
apt install qt6-base-dev qt6-websockets-dev qt6-multimedia-dev qt6-5compat-dev&lt;br /&gt;
&lt;br /&gt;
Depending on your distribution, you may need to install qt5 websocket lib seperately (sudo apt-get install libqt5websockets5-dev)&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
===1.2 (PC) Install MSYS2 Console===&lt;br /&gt;
    https://msys2.github.io/ &lt;br /&gt;
&lt;br /&gt;
Double click on the downloaded file (msys2-i686) and follow instructions. &lt;br /&gt;
&lt;br /&gt;
Open 32 bit MSYS2 shell: msys2_shell.cmd&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
pacman -Sy pacman&lt;br /&gt;
pacman -Syu&lt;br /&gt;
pacman -Su&lt;br /&gt;
pacman -S tar&lt;br /&gt;
pacman -S zip&lt;br /&gt;
pacman -S unzip&lt;br /&gt;
pacman -S git&lt;br /&gt;
pacman -S base-devel&lt;br /&gt;
pacman -S python&lt;br /&gt;
#For compiling win32/32bit under a MinGW64&lt;br /&gt;
pacman -S mingw-w64-i686-toolchain&lt;br /&gt;
pacman -S mingw-w64-i686-glew&lt;br /&gt;
pacman -S mingw-w64-i686-curl&lt;br /&gt;
pacman -S mingw-w64-i686-libpng&lt;br /&gt;
#For compiling win32/64bit under a MinGW64&lt;br /&gt;
pacman -S mingw-w64-x86_64-toolchain&lt;br /&gt;
pacman -S mingw-w64-x86_64-glew&lt;br /&gt;
pacman -S mingw-w64-x86_64-curl&lt;br /&gt;
pacman -S mingw-w64-x86_64-libpng&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.3 (Mac) Install Git &amp;amp; xcpretty ===&lt;br /&gt;
    http://git-scm.com/downloads&lt;br /&gt;
    &lt;br /&gt;
Ctrl + right click, open with « Install program.app » Follow instructions keeping default values as they are. &lt;br /&gt;
&lt;br /&gt;
(MAC) open a terminal window &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
git config -global user.name &amp;quot;your git login&amp;quot; &lt;br /&gt;
git config -global user.email &amp;quot;your git email&amp;quot;&lt;br /&gt;
sudo gem install xcpretty&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
=== 1.3.1 (Linux/Debian) Install Git, build-tools ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
apt install git build-essential libxcb-xinerama0 libgl1-mesa-dev libz-dev libasound2-dev libglew-dev libglfw3-dev&lt;br /&gt;
git config --global user.email &amp;quot;your git email&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.4 (PC) Android requirements ===&lt;br /&gt;
&lt;br /&gt;
==== 1.4.1 Install Android Studio and NDK ====&lt;br /&gt;
&lt;br /&gt;
    https://developer.android.com/studio/index.html&lt;br /&gt;
    https://developer.android.com/ndk/downloads/older_releases.html&lt;br /&gt;
&lt;br /&gt;
Recommended NDK is 25c (the x86_64 version)&lt;br /&gt;
&lt;br /&gt;
Once downloaded, copy the contents of the NDK to your home or C: folder, rename the folder that you copied to &#039;android-ndk&#039;, for example you will end up with &#039;c:\android-ndk&#039; and below that folders that say build, meta, platforms, etc.&lt;br /&gt;
&lt;br /&gt;
==== 1.4.2 Install Ant (no longer required but kept util someone confirms this)====&lt;br /&gt;
    https://ant.apache.org/&lt;br /&gt;
&lt;br /&gt;
Once downloaded, copy the contents of the install archive/zip file to your home folder or C: drive.&lt;br /&gt;
Eg: so you have a folder called c:\apache-ant-1.10.5 with bin, etc, lib, manual folders within that.&lt;br /&gt;
&lt;br /&gt;
==== 1.4.3 Mix Old and New Tools (no longer required but kept util someone confirms this) ====&lt;br /&gt;
&lt;br /&gt;
Gideros uses Ant to build the player, unfortunately the tools to support Ant are now missing from the latest Android tools.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
There is a fix for this:&lt;br /&gt;
&lt;br /&gt;
# Rename the existing &#039;tools&#039; folder in the Android SDK folder to &#039;tools_new&#039;.&lt;br /&gt;
# Download an older (March 2016) version of the tools and copy that folder to the Android SDK folder.&lt;br /&gt;
# Copy the contents of &#039;tools_new&#039; over the contents of &#039;tools&#039;.&lt;br /&gt;
&lt;br /&gt;
Here is where you can download the compatible set of tools from:&lt;br /&gt;
&lt;br /&gt;
(PC) https://dl.google.com/android/repository/tools_r25.2.5-windows.zip&lt;br /&gt;
&lt;br /&gt;
(MAC) https://dl.google.com/android/repository/tools_r25.2.5-macosx.zip&lt;br /&gt;
&lt;br /&gt;
(LINUX) https://dl.google.com/android/repository/tools_r25.2.5-linux.zip&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.5 Install Java ===&lt;br /&gt;
You need the Java JDK&lt;br /&gt;
https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.6 (PC) Install Visual Studio ===&lt;br /&gt;
    https://www.visualstudio.com/downloads/&lt;br /&gt;
&lt;br /&gt;
Install [https://developer.microsoft.com/en-us/windows/downloads/windows-8-1-sdk Win 8.1 SDK]&lt;br /&gt;
&lt;br /&gt;
Install [https://marketplace.visualstudio.com/items?itemName=AdMediator.MicrosoftAdvertisingSDKforWindowsandWindowsPhone8x Microsoft Advertising SDK for Windows and Windows Phone 8.x]&lt;br /&gt;
&lt;br /&gt;
Ensure that you have MSBuild v12 or v14 installed (building with the makefile will fail with an incorrect version).&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.7 (MAC) Install Xcode ===&lt;br /&gt;
    https://itunes.apple.com/fr/app/xcode/id497799835?mt=12&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.8 (Mac) ensure xcode command line tools are working ===&lt;br /&gt;
(MAC) Open a terminal window &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
sudo xCodebuild -license &lt;br /&gt;
quit&lt;br /&gt;
agree&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br /&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.9 Install Python ===&lt;br /&gt;
https://www.python.org/downloads/release/python-2712/&lt;br /&gt;
&lt;br /&gt;
You need Python 2.7.12 or later to install emscripten properly.&lt;br /&gt;
&lt;br /&gt;
Once installed, add it to your command line path, eg: c:\python27, on windows you can do this by right-clicking on &#039;myComputer&#039; or &#039;This PC&#039;, go to &#039;Properties&#039;, click &#039;Advanced System Settings&#039;, Click &#039;Environmental Variables&#039;, double-click &#039;Path&#039;, add &#039;c:\python27&#039;.&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.10 Install emscripten ===&lt;br /&gt;
    http://kripken.github.io/emscripten-site/&lt;br /&gt;
&lt;br /&gt;
You need this is you want to build for HTML5 + Facebook games.&lt;br /&gt;
&lt;br /&gt;
Using a shell or MSYS2 (previously installed) on windows, go to your home or C: folder and type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://github.com/juj/emsdk.git&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Once that has completed open a command prompt in that folder on Windows, on other system just cd to the folder.&lt;br /&gt;
&lt;br /&gt;
Using emsdk, install and activate all the latest packages:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
#(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install latest&lt;br /&gt;
emsdk activate latest&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(PC) Type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
emsdk_env.bat&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(MAC) Type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
source ./emsdk_env.sh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To use incoming branch of emscripten, use these commands instead:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
#(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install sdk-incoming-64bit&lt;br /&gt;
emsdk activate sdk-incoming-64bit&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To further use Gideros own git fork of emscripten:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
cd emscripten/incoming&lt;br /&gt;
# Add a git remote link to your own repository.&lt;br /&gt;
git remote add gideros https://github.com/gideros/emscripten.git&lt;br /&gt;
# Obtain the changes in your link.&lt;br /&gt;
git fetch gideros&lt;br /&gt;
# Switch the emscripten-incoming tool to use your fork.&lt;br /&gt;
git checkout -b gideros_incoming --track gideros/incoming&lt;br /&gt;
#Get back to emscripten directory and rebuild&lt;br /&gt;
cd ../..&lt;br /&gt;
emsdk install sdk-incoming-64bit&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
These can also be installed within emsdk: git, crunch, and spidermonkey&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install git-1.9.4&lt;br /&gt;
emsdk install crunch-1.03&lt;br /&gt;
emsdk install spidermonkey-37.0.1-64bit&lt;br /&gt;
emsdk activate git-1.9.4&lt;br /&gt;
emsdk activate crunch-1.03&lt;br /&gt;
emsdk activate spidermonkey-37.0.1-64bit&lt;br /&gt;
(PC) emsdk_env.bat&lt;br /&gt;
(MAC) source ./emsdk_env.sh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(PC) Make sure the environment variable EM_CONFIG is set to the location of your emscripten config file.&lt;br /&gt;
&lt;br /&gt;
The emscripten build also needs the CMake command.  You can download it and extract it to your home or C: folder.  Don&#039;t forget to add it&#039;s path to the end of the EMSDKPATH in Makefile.def.&lt;br /&gt;
&lt;br /&gt;
https://cmake.org/download/&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.11 Install Steam SDK ===&lt;br /&gt;
    https://partner.steamgames.com/?goto=%2Fdownloads%2Fsteamworks_sdk.zip&lt;br /&gt;
&lt;br /&gt;
Extract the archive/zip file to your home or C: folder, for example if the file is called &#039;steamworks_sdk_142.zip&#039; then you will have a &#039;c:\steamworks_sdk_142&#039; folder with a solder called &#039;sdk&#039; within it.  The sdk folder contains other folders such as glmgr, public, tools, etc.&lt;br /&gt;
&lt;br /&gt;
This is necessary for the Steam plugin.&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.12 Install Gideros ===&lt;br /&gt;
&lt;br /&gt;
==== 1.12.1 Fetch gideros source code ====&lt;br /&gt;
(PC) Open MSYS2 32 bit shell&lt;br /&gt;
&lt;br /&gt;
(MAC/Linux) Open a terminal&lt;br /&gt;
&lt;br /&gt;
Navigate to the folder where you into to work.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    git clone https://github.com/gideros/gideros &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== 1.12.2 Configure scripts ====&lt;br /&gt;
Make a copy of the file gideros/scripts/Makefile.def.example, rename it to Makefile.def and update the file copy according &lt;br /&gt;
to your installation. Ensure that the QT\_ARCH and QT_TOOLSARCH paths are formatted correctly according to your Qt &lt;br /&gt;
install directory structure (see below that they are named differently by Qt).&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;&#039;&#039;&#039;Example:&#039;&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;On PC:&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
For Qt:&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;gt;QTBASEDIR=/c/Qt&lt;br /&gt;
QT_ARCH=mingw53_32&lt;br /&gt;
QT_TOOLSARCH=mingw530_32&lt;br /&gt;
QTVER=5.9.1&lt;br /&gt;
QT5ICUVER=59&lt;br /&gt;
&lt;br /&gt;
STEAMSDK=/c/Applications/steamworks_sdk_142&lt;br /&gt;
export STEAMSDK&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
For Android:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
# on Windows, also add this to PATH&lt;br /&gt;
NDK_HOME=/c/android/android-ndk-r17b&lt;br /&gt;
NDKBUILD=cmd //c /c/android/android-ndk-r17b/ndk-build.cmd&lt;br /&gt;
#We use windows syntax for this one, as it will be used by gradle.bat script&lt;br /&gt;
JAVA_HOME=C:\Program Files\Java\jdk1.8.0_144&lt;br /&gt;
#Windows syntax with quadruple backslashs!&lt;br /&gt;
ANDROID_HOME=C:\\\\Users\\\\Gideros\\\\AppData\\\\Local\\\\Android\\\\sdk&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
For WinRT:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
FXC=&amp;quot;/c/Program Files (x86)/Windows Kits/8.1/bin/x86/fxc.exe&amp;quot; &lt;br /&gt;
MSBUILD=&amp;quot;/c/Program Files (x86)/MSBuild/14.0/Bin/MSbuild.exe&amp;quot; &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
For html5:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
EMSDK=/c/emsdkwin&lt;br /&gt;
EMSDKPATH=$(EMSDK):$(EMSDK)/clang/e1.35.0_64bit:$(EMSDK)/node/4.1.1_64bit/bin:$(EMSDK)/python/2.7.5.3_64bit:$(EMSDK)/emscripten/1.35.0&lt;br /&gt;
EMSDK_PREFIX=PATH=$(EMSDKPATH):$$$$PATH cmd //c&lt;br /&gt;
CRUNCHME=crunchme-win32.exe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;On MAC:&#039;&#039;&#039; &lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
QTBASEDIR=~/Qt QT_ARCH=clang_64 &lt;br /&gt;
QT_TOOLSARCH=clang_64 &lt;br /&gt;
QTVER=5.8 &lt;br /&gt;
QT5ICUVER=54 #deprecated stuff &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;On Linux:&#039;&#039;&#039; &lt;br /&gt;
(tested on Debian 11)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
QT=/usr&lt;br /&gt;
QMAKE=qmake6&lt;br /&gt;
QTLIBS=/lib/x86_64-linux-gnu&lt;br /&gt;
QTPLUGINS=$(QTLIBS)/qt6/plugins&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== 1.12.3 Complete working example Makefile.def for Windows ====&lt;br /&gt;
&lt;br /&gt;
Here is a working example, you will have to change the filename details to match your setup:&lt;br /&gt;
&lt;br /&gt;
[[Example Makefile.def file|example Makefile.def file]].&lt;br /&gt;
&lt;br /&gt;
==== 1.12.4 Fetch additional repositories ====&lt;br /&gt;
&lt;br /&gt;
Go into just cloned gideros source folder and run make prep.repo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    cd gideros&lt;br /&gt;
    make -f scripts/Makefile.gid prep.repo &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
If you intend to build the studio, you&#039;ll need scintilla and Lexilla libraries. Compile them now with:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    make -f scripts/Makefile.gid qlexilla&lt;br /&gt;
    make -f scripts/Makefile.gid qscintilla&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
== 2. Building ==&lt;br /&gt;
&lt;br /&gt;
If you have all dependencies in place for all targets, you can build everything at once via MSYS2 or Terminal with:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 2.1 Compilation on PC :===&lt;br /&gt;
&lt;br /&gt;
Open MSYS2 shell (msys2_shell.cmd). Standard compilation is 32 bit so use a 32 bit shell. Make sure you have installed the necessary build tools in MSYS2 using pacman, as detailed in [[#1.2 (PC) Install MSYS2 Console|Install MSYS2 Console]].&lt;br /&gt;
.&lt;br /&gt;
&lt;br /&gt;
Navigate to gideros folder &lt;br /&gt;
 &lt;br /&gt;
==== 2.1.1 Build QT tools : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid qtapp.install&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
-&amp;gt; files GiderosStudio.exe, GiderosPlayer.exe, GiderosTexturePacker.exe (…) in Build.Win folder &lt;br /&gt;
&lt;br /&gt;
==== 2.1.2 Android: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid android.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= file GiderosAndroidPlayer.apk in folder Build.Win/Players &lt;br /&gt;
&lt;br /&gt;
==== 2.1.3 winRT: ====&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;If necessary :&#039;&#039;&lt;br /&gt;
Open the solution, gideros/winRT_example/giderosgame.sln in Visual Studio. Check that the SQLite version for Windows and Windows Phone is up to date. Save and close the solution. &lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid winrt.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= file _bundle.appxupload in folder Build.Win/Players/WinRT&lt;br /&gt;
&lt;br /&gt;
==== 2.1.4 win32: ====&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid win32.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= files in folder Build.Win/Templates/win32 &lt;br /&gt;
 &lt;br /&gt;
==== 2.1.5 Html5: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid html5.install&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
-&amp;gt; files in folders Build.Win//Players/Html5 and Build.Win/Templates/Html5&lt;br /&gt;
&lt;br /&gt;
==== 2.1.6 Plugins: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.win &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= folder bin and file gplugin in folder Build.Win/All Plugins&lt;br /&gt;
&lt;br /&gt;
==== 2.1.7 To build everything that can be built on Windows ====&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid all&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Then you need to copy all the plugins to the &#039;Build.Win&#039; folder with:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.win&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 2.2 Compilation on Mac :===&lt;br /&gt;
Open Terminal.  &lt;br /&gt;
&lt;br /&gt;
cd to the folder « gideros » &lt;br /&gt;
&lt;br /&gt;
==== 2.2.1 QT : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid qtapp.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= GiderosStudio.exe, GiderosPlayer.exe, GiderosTexturePacker.exe (…) in folder Build.Mac &lt;br /&gt;
&lt;br /&gt;
==== 2.2.2 iOS : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid ios.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= GiderosiOSPlayer.zip in folder Buid.Mac/Players &lt;br /&gt;
&lt;br /&gt;
==== 2.2.3 Plugins: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.mac &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= folders bin and files gplugin in folder Buid.Mac/All Plugins&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
== 3. Cleaning ==&lt;br /&gt;
&lt;br /&gt;
If you want to reset the build process and start again then you can issue a &#039;clean&#039; command.  To do this type &#039;make -f scripts/Makefile.gid clean&#039;.&lt;br /&gt;
&lt;br /&gt;
eg:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid clean&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Sometimes you need to make a clean a particular build.  To do this type &#039;make -f scripts/Makefile.gid &#039; followed by something like &#039;html5&#039; then &#039;.clean&#039;.&lt;br /&gt;
&lt;br /&gt;
eg:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid html5.clean&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Ads:checkConsent&amp;diff=22484</id>
		<title>Ads:checkConsent</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Ads:checkConsent&amp;diff=22484"/>
		<updated>2023-08-18T06:27:52Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2023.8&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[Ads]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Triggers consent check and flow, if any supported by the Ad engine.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
Ads:checkConsent(parameters)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The &#039;&#039;&#039;parameters&#039;&#039;&#039; table is mandatory and can contain the following fields:&amp;lt;br/&amp;gt;&lt;br /&gt;
- &#039;&#039;&#039;reset&#039;&#039;&#039;: (boolean) Reset saved consent information, for testing purposes&amp;lt;br/&amp;gt;&lt;br /&gt;
- &#039;&#039;&#039;underAge&#039;&#039;&#039;: (boolean) Tells if the user is under age as per the Ad engine guidelines&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Parameters ===&lt;br /&gt;
&#039;&#039;&#039;parameters&#039;&#039;&#039;: (table) consent options&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Return values ===&lt;br /&gt;
&#039;&#039;&#039;Returns&#039;&#039;&#039; (boolean) &#039;&#039;true&#039;&#039; if consent flow is supported and if an [[Event.AD_CONSENT]] event will be triggered, &#039;&#039;false&#039;&#039; otherwise.&lt;br /&gt;
&lt;br /&gt;
{{Ads}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Ads:checkConsent&amp;diff=22483</id>
		<title>Ads:checkConsent</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Ads:checkConsent&amp;diff=22483"/>
		<updated>2023-08-18T06:25:35Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* Description */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2023.8&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[Ads]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Triggers consent check and flow, if any supported by the Ad engine.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
Ads:checkConsent(parameters)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The &#039;&#039;&#039;parameters&#039;&#039;&#039; table is mandatory and can contain the following fields:&amp;lt;br/&amp;gt;&lt;br /&gt;
- &#039;&#039;&#039;reset&#039;&#039;&#039;: (boolean) Reset saved consent information, for testing purposes&amp;lt;br/&amp;gt;&lt;br /&gt;
- &#039;&#039;&#039;underAge&#039;&#039;&#039;: (boolean) Tells if the user is under age as per the Ad engine guidelines&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Parameters ===&lt;br /&gt;
&#039;&#039;&#039;parameters&#039;&#039;&#039;: (table) consent options&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Ads}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Ads:checkConsent&amp;diff=22482</id>
		<title>Ads:checkConsent</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Ads:checkConsent&amp;diff=22482"/>
		<updated>2023-08-18T06:25:18Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: Created page with &amp;quot;__NOTOC__ &amp;#039;&amp;#039;&amp;#039;Available since:&amp;#039;&amp;#039;&amp;#039; Gideros 2023.8&amp;lt;br/&amp;gt; &amp;#039;&amp;#039;&amp;#039;Class:&amp;#039;&amp;#039;&amp;#039; Ads&amp;lt;br/&amp;gt;  === Description === Triggers consent check and flow, if any supported by the Ad engine. &amp;lt;syntax...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2023.8&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[Ads]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Triggers consent check and flow, if any supported by the Ad engine.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
Ads:checkConsent(parameters)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The &#039;&#039;&#039;parameters&#039;&#039;&#039; table is mandatory and can contain the following fields:&lt;br /&gt;
- &#039;&#039;&#039;reset&#039;&#039;&#039;: (boolean) Reset saved consent information, for testing purposes&lt;br /&gt;
- &#039;&#039;&#039;underAge&#039;&#039;&#039;: (boolean) Tells if the user is under age as per the Ad engine guidelines&lt;br /&gt;
&lt;br /&gt;
=== Parameters ===&lt;br /&gt;
&#039;&#039;&#039;parameters&#039;&#039;&#039;: (table) consent options&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Ads}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Ads:loadAd&amp;diff=22481</id>
		<title>Ads:loadAd</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Ads:loadAd&amp;diff=22481"/>
		<updated>2023-08-18T06:21:13Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: Created page with &amp;quot;__NOTOC__ &amp;#039;&amp;#039;&amp;#039;Available since:&amp;#039;&amp;#039;&amp;#039; Gideros 2011.6&amp;lt;br/&amp;gt; &amp;#039;&amp;#039;&amp;#039;Class:&amp;#039;&amp;#039;&amp;#039; Ads&amp;lt;br/&amp;gt;  === Description === Preloads provided ad type with any other additional information. &amp;lt;syntaxhig...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2011.6&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Class:&#039;&#039;&#039; [[Ads]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Preloads provided ad type with any other additional information.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
Ads:loadAd(adType,...)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Parameters ===&lt;br /&gt;
&#039;&#039;&#039;adType&#039;&#039;&#039;: (string) ad type or format&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;...&#039;&#039;&#039;: (varies) varies for each ad framework&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Ads}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Event.ADS_READY&amp;diff=22480</id>
		<title>Event.ADS READY</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Event.ADS_READY&amp;diff=22480"/>
		<updated>2023-08-18T06:18:17Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: Created page with &amp;quot;__NOTOC__ &amp;#039;&amp;#039;&amp;#039;Available since:&amp;#039;&amp;#039;&amp;#039; Gideros 2020&amp;lt;br/&amp;gt; &amp;#039;&amp;#039;&amp;#039;Value:&amp;#039;&amp;#039;&amp;#039; adsReady&amp;lt;br/&amp;gt; &amp;#039;&amp;#039;&amp;#039;Defined by:&amp;#039;&amp;#039;&amp;#039; Ads&amp;lt;br/&amp;gt;  === Description === Sent when Ad engine is ready to be used. Only...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2020&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Value:&#039;&#039;&#039; adsReady&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Defined by:&#039;&#039;&#039; [[Ads]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Sent when Ad engine is ready to be used. Only some engines send this event.&lt;br /&gt;
&lt;br /&gt;
{{Ads}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Event.AD_CONSENT&amp;diff=22479</id>
		<title>Event.AD CONSENT</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Event.AD_CONSENT&amp;diff=22479"/>
		<updated>2023-08-18T06:16:28Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: Created page with &amp;quot;__NOTOC__ &amp;#039;&amp;#039;&amp;#039;Available since:&amp;#039;&amp;#039;&amp;#039; Gideros 2023.8&amp;lt;br/&amp;gt; &amp;#039;&amp;#039;&amp;#039;Value:&amp;#039;&amp;#039;&amp;#039; adConsent&amp;lt;br/&amp;gt; &amp;#039;&amp;#039;&amp;#039;Defined by:&amp;#039;&amp;#039;&amp;#039; Ads&amp;lt;br/&amp;gt;  === Description === Consent flow has finished.  === Parameters...&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2023.8&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Value:&#039;&#039;&#039; adConsent&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Defined by:&#039;&#039;&#039; [[Ads]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
Consent flow has finished.&lt;br /&gt;
&lt;br /&gt;
=== Parameters ===&lt;br /&gt;
&#039;&#039;&#039;error&#039;&#039;&#039;: (string) string describing error if any&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;errorcode&#039;&#039;&#039;: (number) error code, or 0 if success&lt;br /&gt;
&lt;br /&gt;
{{Ads}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Ads&amp;diff=22478</id>
		<title>Ads</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Ads&amp;diff=22478"/>
		<updated>2023-08-18T06:14:43Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* Events */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&amp;lt;!-- GIDEROSOBJ:Ads --&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Supported platforms:&#039;&#039;&#039; [[File:Platform android.png]][[File:Platform ios.png]][[File:Platform html5.png]][[File:Platform winrt.png]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2011.6&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Inherits from:&#039;&#039;&#039; [[EventDispatcher]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
The idea is to provide a common Ads interface for most of available ad frameworks. A common ads interface allows users to switch and fall back between ad frameworks at runtime.&lt;br /&gt;
&lt;br /&gt;
More information available in [http://docs.giderosmobile.com/interface/ads](Ads interface guide).&lt;br /&gt;
&lt;br /&gt;
=== Examples ===&lt;br /&gt;
&#039;&#039;&#039;Admob&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
Ads = Core.class(Sprite) -- you need to add &amp;quot;Ads&amp;quot; and &amp;quot;Gaming&amp;quot; to your project Plugins&lt;br /&gt;
&lt;br /&gt;
function Ads:init()&lt;br /&gt;
	-- ads&lt;br /&gt;
	self.ADMOB_APP_ID = &amp;quot;ca-app-pub-3940256099942544~3347511713&amp;quot; -- google test id&lt;br /&gt;
	self.ADMOB_UNIT_ID = &amp;quot;ca-app-pub-3940256099942544/6300978111&amp;quot; -- google test id&lt;br /&gt;
&lt;br /&gt;
	-- admob (setup for simple banner adverts), note: only visible on phone/tablet&lt;br /&gt;
	if application:getDeviceInfo() == &amp;quot;Android&amp;quot; then&lt;br /&gt;
		require &#039;ads&#039; --create real object for on device&lt;br /&gt;
		self.ADMOB = Ads.new(&#039;admob&#039;)&lt;br /&gt;
		self.ADMOB:setKey(self.ADMOB_APP_ID)&lt;br /&gt;
		self.ADMOB:addEventListener(Event.AD_RECEIVED, function() -- show ad&lt;br /&gt;
			self.ADMOB:showAd(&#039;banner&#039;)&lt;br /&gt;
			self.ADMOB:setAlignment(&#039;center&#039;, &#039;bottom&#039;)&lt;br /&gt;
		end)&lt;br /&gt;
		self.ADMOB:addEventListener(Event.AD_FAILED, function(e) end)&lt;br /&gt;
		self.ADMOB:addEventListener(Event.AD_ACTION_BEGIN, function() end)&lt;br /&gt;
		self.ADMOB:addEventListener(Event.AD_ACTION_END, function() end)&lt;br /&gt;
		self.ADMOB:addEventListener(Event.AD_DISMISSED, function() end)&lt;br /&gt;
&lt;br /&gt;
		self.ADMOB:loadAd(&amp;quot;banner&amp;quot;, self.ADMOB_UNIT_ID) -- load ad&lt;br /&gt;
	else&lt;br /&gt;
		self.ADMOB = {} -- create fake object for testing in windows player&lt;br /&gt;
		self.ADMOB.loadAd = function() end&lt;br /&gt;
		self.ADMOB.showAd = function() end&lt;br /&gt;
	end&lt;br /&gt;
&lt;br /&gt;
	-- LISTENERS&lt;br /&gt;
	self:addEventListener(&amp;quot;enterBegin&amp;quot;, self.onTransitionInBegin, self)&lt;br /&gt;
	self:addEventListener(&amp;quot;enterEnd&amp;quot;, self.onTransitionInEnd, self)&lt;br /&gt;
	self:addEventListener(&amp;quot;exitBegin&amp;quot;, self.onTransitionOutBegin, self)&lt;br /&gt;
	self:addEventListener(&amp;quot;exitEnd&amp;quot;, self.onTransitionOutEnd, self)&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
-- EVENT LISTENERS&lt;br /&gt;
function Ads:onTransitionInBegin()&lt;br /&gt;
end&lt;br /&gt;
function Ads:onTransitionInEnd()&lt;br /&gt;
end&lt;br /&gt;
function Ads:onTransitionOutBegin()&lt;br /&gt;
end&lt;br /&gt;
function Ads:onTransitionOutEnd()&lt;br /&gt;
end&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Creating fallbacks with Ads frameworks&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
--require plugin&lt;br /&gt;
require &amp;quot;ads&amp;quot;&lt;br /&gt;
&lt;br /&gt;
--initialize amazon&lt;br /&gt;
amazon = Ads.new(&amp;quot;amazon&amp;quot;)&lt;br /&gt;
amazon:setKey(&amp;quot;amazon-key&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
--initialize admob&lt;br /&gt;
admob = Ads.new(&amp;quot;admob&amp;quot;)&lt;br /&gt;
admob:setKey(&amp;quot;admob-key&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
--if amazon fails&lt;br /&gt;
--show admob&lt;br /&gt;
amazon:addEventListener(Event.AD_FAILED, function(e)&lt;br /&gt;
	print(&amp;quot;amazon AD_FAILED&amp;quot;, e.error)&lt;br /&gt;
	admob:showAd(&amp;quot;auto&amp;quot;)&lt;br /&gt;
end)&lt;br /&gt;
&lt;br /&gt;
--if admob fails&lt;br /&gt;
--show amazon&lt;br /&gt;
admob:addEventListener(Event.AD_FAILED, function(e)&lt;br /&gt;
	print(&amp;quot;admob AD_FAILED&amp;quot;, e.error)&lt;br /&gt;
	amazon:showAd(&amp;quot;auto&amp;quot;)&lt;br /&gt;
end)&lt;br /&gt;
&lt;br /&gt;
--start displaying amazon ads&lt;br /&gt;
amazon:showAd(&amp;quot;auto&amp;quot;)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{|-&lt;br /&gt;
| style=&amp;quot;width: 50%; vertical-align:top;&amp;quot;|&lt;br /&gt;
=== Methods ===&lt;br /&gt;
[[Ads.new]] &#039;&#039;initializes new ad framework&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads.new(adframework) initializes a new ad framework--&amp;gt;&lt;br /&gt;
[[Ads:checkConsent]] &#039;&#039;triggers consent flow if needed&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!-- GIDEROSMTD:Ads:checkConsent(parameters) triggers consent flow if need --&amp;gt;&lt;br /&gt;
[[Ads:enableTesting]] &#039;&#039;enables testing ads&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:enableTesting() enables testing ads--&amp;gt;&lt;br /&gt;
[[Ads:get]] &#039;&#039;gets property value of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:get(property) gets the property value of the ad--&amp;gt;&lt;br /&gt;
[[Ads:getHeight]] &#039;&#039;gets height of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:getHeight() gets the height of the ad--&amp;gt;&lt;br /&gt;
[[Ads:getPosition]] &#039;&#039;gets x and y position of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:getPosition() gets the x and y position of the ad--&amp;gt;&lt;br /&gt;
[[Ads:getWidth]] &#039;&#039;gets width of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:getWidth() gets the width of the ad--&amp;gt;&lt;br /&gt;
[[Ads:getX]] &#039;&#039;gets x position of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:getX() gets the x position of the ad--&amp;gt;&lt;br /&gt;
[[Ads:getY]] &#039;&#039;gets y position of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:getY() gets the y position of the ad--&amp;gt;&lt;br /&gt;
[[Ads:hideAd]] &#039;&#039;hides the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!-- GIDEROSMTD:Ads:hideAd() hides the ad--&amp;gt;&lt;br /&gt;
[[Ads:loadAd]] &#039;&#039;loads the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!-- GIDEROSMTD:Ads:loadAd() loads an ad--&amp;gt;&lt;br /&gt;
[[Ads:set]] &#039;&#039;sets property value of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:set(property,value) sets the property value of the ad--&amp;gt;&lt;br /&gt;
[[Ads:setAlignment]] &#039;&#039;sets alignment of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:setAlignment(horizontal,vertical) sets the alignment of the ad--&amp;gt;&lt;br /&gt;
[[Ads:setKey]] &#039;&#039;sets keys for the framework&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:setKey(...) sets the keys for the framework--&amp;gt;&lt;br /&gt;
[[Ads:setPosition]] &#039;&#039;sets position of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:setPosition(x,y) sets the position of the ad--&amp;gt;&lt;br /&gt;
[[Ads:setX]] &#039;&#039;sets x position of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:setX(x) sets the x position of the ad--&amp;gt;&lt;br /&gt;
[[Ads:setY]] &#039;&#039;sets y position of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:setY(y) sets the y position of the ad--&amp;gt;&lt;br /&gt;
[[Ads:showAd]] &#039;&#039;displays the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:showAd(...) displays the ad--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
| style=&amp;quot;width: 50%; vertical-align:top;&amp;quot;|&lt;br /&gt;
&lt;br /&gt;
=== Events ===&lt;br /&gt;
[[Event.AD_ACTION_BEGIN]]&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSEVT:Event.AD_ACTION_BEGIN adActionBegin--&amp;gt;&lt;br /&gt;
[[Event.AD_ACTION_END]]&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSEVT:Event.AD_ACTION_END adActionEnd--&amp;gt;&lt;br /&gt;
[[Event.AD_CONSENT]]&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSEVT:Event.AD_CONSENTD adConsent--&amp;gt;&lt;br /&gt;
[[Event.AD_DISMISSED]]&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSEVT:Event.AD_DISMISSED adDismissed--&amp;gt;&lt;br /&gt;
[[Event.AD_ERROR]]&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSEVT:Event.AD_ERROR adError--&amp;gt;&lt;br /&gt;
[[Event.AD_FAILED]]&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSEVT:Event.AD_FAILED adFailed--&amp;gt;&lt;br /&gt;
[[Event.AD_RECEIVED]]&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSEVT:Event.AD_RECEIVED adReceived--&amp;gt;&lt;br /&gt;
[[Event.AD_REWARDED]]&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSEVT:Event.AD_REWARDED adRewarded--&amp;gt;&lt;br /&gt;
[[Event.ADS_READY]]&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSEVT:Event.ADS_READY adsReady--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Constants ===&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
{{GIDEROS IMPORTANT LINKS}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Ads&amp;diff=22477</id>
		<title>Ads</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Ads&amp;diff=22477"/>
		<updated>2023-08-18T06:12:27Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* Methods */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&amp;lt;!-- GIDEROSOBJ:Ads --&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Supported platforms:&#039;&#039;&#039; [[File:Platform android.png]][[File:Platform ios.png]][[File:Platform html5.png]][[File:Platform winrt.png]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Available since:&#039;&#039;&#039; Gideros 2011.6&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;Inherits from:&#039;&#039;&#039; [[EventDispatcher]]&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Description ===&lt;br /&gt;
The idea is to provide a common Ads interface for most of available ad frameworks. A common ads interface allows users to switch and fall back between ad frameworks at runtime.&lt;br /&gt;
&lt;br /&gt;
More information available in [http://docs.giderosmobile.com/interface/ads](Ads interface guide).&lt;br /&gt;
&lt;br /&gt;
=== Examples ===&lt;br /&gt;
&#039;&#039;&#039;Admob&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
Ads = Core.class(Sprite) -- you need to add &amp;quot;Ads&amp;quot; and &amp;quot;Gaming&amp;quot; to your project Plugins&lt;br /&gt;
&lt;br /&gt;
function Ads:init()&lt;br /&gt;
	-- ads&lt;br /&gt;
	self.ADMOB_APP_ID = &amp;quot;ca-app-pub-3940256099942544~3347511713&amp;quot; -- google test id&lt;br /&gt;
	self.ADMOB_UNIT_ID = &amp;quot;ca-app-pub-3940256099942544/6300978111&amp;quot; -- google test id&lt;br /&gt;
&lt;br /&gt;
	-- admob (setup for simple banner adverts), note: only visible on phone/tablet&lt;br /&gt;
	if application:getDeviceInfo() == &amp;quot;Android&amp;quot; then&lt;br /&gt;
		require &#039;ads&#039; --create real object for on device&lt;br /&gt;
		self.ADMOB = Ads.new(&#039;admob&#039;)&lt;br /&gt;
		self.ADMOB:setKey(self.ADMOB_APP_ID)&lt;br /&gt;
		self.ADMOB:addEventListener(Event.AD_RECEIVED, function() -- show ad&lt;br /&gt;
			self.ADMOB:showAd(&#039;banner&#039;)&lt;br /&gt;
			self.ADMOB:setAlignment(&#039;center&#039;, &#039;bottom&#039;)&lt;br /&gt;
		end)&lt;br /&gt;
		self.ADMOB:addEventListener(Event.AD_FAILED, function(e) end)&lt;br /&gt;
		self.ADMOB:addEventListener(Event.AD_ACTION_BEGIN, function() end)&lt;br /&gt;
		self.ADMOB:addEventListener(Event.AD_ACTION_END, function() end)&lt;br /&gt;
		self.ADMOB:addEventListener(Event.AD_DISMISSED, function() end)&lt;br /&gt;
&lt;br /&gt;
		self.ADMOB:loadAd(&amp;quot;banner&amp;quot;, self.ADMOB_UNIT_ID) -- load ad&lt;br /&gt;
	else&lt;br /&gt;
		self.ADMOB = {} -- create fake object for testing in windows player&lt;br /&gt;
		self.ADMOB.loadAd = function() end&lt;br /&gt;
		self.ADMOB.showAd = function() end&lt;br /&gt;
	end&lt;br /&gt;
&lt;br /&gt;
	-- LISTENERS&lt;br /&gt;
	self:addEventListener(&amp;quot;enterBegin&amp;quot;, self.onTransitionInBegin, self)&lt;br /&gt;
	self:addEventListener(&amp;quot;enterEnd&amp;quot;, self.onTransitionInEnd, self)&lt;br /&gt;
	self:addEventListener(&amp;quot;exitBegin&amp;quot;, self.onTransitionOutBegin, self)&lt;br /&gt;
	self:addEventListener(&amp;quot;exitEnd&amp;quot;, self.onTransitionOutEnd, self)&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
-- EVENT LISTENERS&lt;br /&gt;
function Ads:onTransitionInBegin()&lt;br /&gt;
end&lt;br /&gt;
function Ads:onTransitionInEnd()&lt;br /&gt;
end&lt;br /&gt;
function Ads:onTransitionOutBegin()&lt;br /&gt;
end&lt;br /&gt;
function Ads:onTransitionOutEnd()&lt;br /&gt;
end&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Creating fallbacks with Ads frameworks&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;lua&amp;quot;&amp;gt;&lt;br /&gt;
--require plugin&lt;br /&gt;
require &amp;quot;ads&amp;quot;&lt;br /&gt;
&lt;br /&gt;
--initialize amazon&lt;br /&gt;
amazon = Ads.new(&amp;quot;amazon&amp;quot;)&lt;br /&gt;
amazon:setKey(&amp;quot;amazon-key&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
--initialize admob&lt;br /&gt;
admob = Ads.new(&amp;quot;admob&amp;quot;)&lt;br /&gt;
admob:setKey(&amp;quot;admob-key&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
--if amazon fails&lt;br /&gt;
--show admob&lt;br /&gt;
amazon:addEventListener(Event.AD_FAILED, function(e)&lt;br /&gt;
	print(&amp;quot;amazon AD_FAILED&amp;quot;, e.error)&lt;br /&gt;
	admob:showAd(&amp;quot;auto&amp;quot;)&lt;br /&gt;
end)&lt;br /&gt;
&lt;br /&gt;
--if admob fails&lt;br /&gt;
--show amazon&lt;br /&gt;
admob:addEventListener(Event.AD_FAILED, function(e)&lt;br /&gt;
	print(&amp;quot;admob AD_FAILED&amp;quot;, e.error)&lt;br /&gt;
	amazon:showAd(&amp;quot;auto&amp;quot;)&lt;br /&gt;
end)&lt;br /&gt;
&lt;br /&gt;
--start displaying amazon ads&lt;br /&gt;
amazon:showAd(&amp;quot;auto&amp;quot;)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{|-&lt;br /&gt;
| style=&amp;quot;width: 50%; vertical-align:top;&amp;quot;|&lt;br /&gt;
=== Methods ===&lt;br /&gt;
[[Ads.new]] &#039;&#039;initializes new ad framework&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads.new(adframework) initializes a new ad framework--&amp;gt;&lt;br /&gt;
[[Ads:checkConsent]] &#039;&#039;triggers consent flow if needed&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!-- GIDEROSMTD:Ads:checkConsent(parameters) triggers consent flow if need --&amp;gt;&lt;br /&gt;
[[Ads:enableTesting]] &#039;&#039;enables testing ads&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:enableTesting() enables testing ads--&amp;gt;&lt;br /&gt;
[[Ads:get]] &#039;&#039;gets property value of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:get(property) gets the property value of the ad--&amp;gt;&lt;br /&gt;
[[Ads:getHeight]] &#039;&#039;gets height of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:getHeight() gets the height of the ad--&amp;gt;&lt;br /&gt;
[[Ads:getPosition]] &#039;&#039;gets x and y position of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:getPosition() gets the x and y position of the ad--&amp;gt;&lt;br /&gt;
[[Ads:getWidth]] &#039;&#039;gets width of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:getWidth() gets the width of the ad--&amp;gt;&lt;br /&gt;
[[Ads:getX]] &#039;&#039;gets x position of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:getX() gets the x position of the ad--&amp;gt;&lt;br /&gt;
[[Ads:getY]] &#039;&#039;gets y position of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:getY() gets the y position of the ad--&amp;gt;&lt;br /&gt;
[[Ads:hideAd]] &#039;&#039;hides the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!-- GIDEROSMTD:Ads:hideAd() hides the ad--&amp;gt;&lt;br /&gt;
[[Ads:loadAd]] &#039;&#039;loads the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!-- GIDEROSMTD:Ads:loadAd() loads an ad--&amp;gt;&lt;br /&gt;
[[Ads:set]] &#039;&#039;sets property value of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:set(property,value) sets the property value of the ad--&amp;gt;&lt;br /&gt;
[[Ads:setAlignment]] &#039;&#039;sets alignment of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:setAlignment(horizontal,vertical) sets the alignment of the ad--&amp;gt;&lt;br /&gt;
[[Ads:setKey]] &#039;&#039;sets keys for the framework&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:setKey(...) sets the keys for the framework--&amp;gt;&lt;br /&gt;
[[Ads:setPosition]] &#039;&#039;sets position of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:setPosition(x,y) sets the position of the ad--&amp;gt;&lt;br /&gt;
[[Ads:setX]] &#039;&#039;sets x position of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:setX(x) sets the x position of the ad--&amp;gt;&lt;br /&gt;
[[Ads:setY]] &#039;&#039;sets y position of the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:setY(y) sets the y position of the ad--&amp;gt;&lt;br /&gt;
[[Ads:showAd]] &#039;&#039;displays the ad&#039;&#039;&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSMTD:Ads:showAd(...) displays the ad--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
| style=&amp;quot;width: 50%; vertical-align:top;&amp;quot;|&lt;br /&gt;
&lt;br /&gt;
=== Events ===&lt;br /&gt;
[[Event.AD_ACTION_BEGIN]]&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSEVT:Event.AD_ACTION_BEGIN adActionBegin--&amp;gt;&lt;br /&gt;
[[Event.AD_ACTION_END]]&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSEVT:Event.AD_ACTION_END adActionEnd--&amp;gt;&lt;br /&gt;
[[Event.AD_DISMISSED]]&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSEVT:Event.AD_DISMISSED adDismissed--&amp;gt;&lt;br /&gt;
[[Event.AD_ERROR]]&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSEVT:Event.AD_ERROR adError--&amp;gt;&lt;br /&gt;
[[Event.AD_FAILED]]&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSEVT:Event.AD_FAILED adFailed--&amp;gt;&lt;br /&gt;
[[Event.AD_RECEIVED]]&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSEVT:Event.AD_RECEIVED adReceived--&amp;gt;&lt;br /&gt;
[[Event.AD_REWARDED]]&amp;lt;br/&amp;gt;&amp;lt;!--GIDEROSEVT:Event.AD_RECEIVED adReceived--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Constants ===&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
{{GIDEROS IMPORTANT LINKS}}&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Compiling_Gideros_Source&amp;diff=22476</id>
		<title>Compiling Gideros Source</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Compiling_Gideros_Source&amp;diff=22476"/>
		<updated>2023-08-18T06:09:41Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* 1.4.1 Install Android Studio and NDK */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;The following instructions are for developers who want to contribute to or otherwise experiment with the Gideros C/C++ engine and are &#039;&#039;not&#039;&#039; necessary for either building or deploying apps made with Gideros.&lt;br /&gt;
&lt;br /&gt;
The Gideros project consists of the Gideros Studio IDE, the Gideros SDK libraries, Gideros Texture Packer, Gideros Font Creator, &amp;quot;players&amp;quot; or export templates for all the platforms Gideros supports, all targets of all plugins, a daemon and a bridge. The build system is flexible, so you only need the tools for the targets you are interested in deploying to with Qt (and MSYS2 on Windows) being a realistic minimum.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div class=&amp;quot;noautonum&amp;quot;&amp;gt;__TOC__&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 1. Requirements ==&lt;br /&gt;
=== 1.1 Install QT ===&lt;br /&gt;
https://www.qt.io/download-open-source/&lt;br /&gt;
&lt;br /&gt;
Recommended version 6.3 with MinGW &amp;lt;br /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Double click on the downloaded file and follow instructions. When installing, expand the tree view and ensure you have ticked the MinGW child option of the Qt version checkbox, as well as the MinGW option in the Tools section.&lt;br /&gt;
Beside main QT package, you&#039;ll need the following additional components:&lt;br /&gt;
* WebSocket additional library&lt;br /&gt;
* Multimedia additional library&lt;br /&gt;
* Qt5 Compatibility addon&lt;br /&gt;
  &lt;br /&gt;
(MAC) Move the created folder into your user account folder &lt;br /&gt;
&lt;br /&gt;
(LINUX) &lt;br /&gt;
On Debian 11:&lt;br /&gt;
echo &amp;quot;deb http://deb.debian.org/debian bullseye-backports main&amp;quot; &amp;gt;&amp;gt;/etc/apt/sources.list&lt;br /&gt;
apt update&lt;br /&gt;
apt install qt6-base-dev qt6-websockets-dev qt6-multimedia-dev qt6-5compat-dev&lt;br /&gt;
&lt;br /&gt;
Depending on your distribution, you may need to install qt5 websocket lib seperately (sudo apt-get install libqt5websockets5-dev)&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
===1.2 (PC) Install MSYS2 Console===&lt;br /&gt;
    https://msys2.github.io/ &lt;br /&gt;
&lt;br /&gt;
Double click on the downloaded file (msys2-i686) and follow instructions. &lt;br /&gt;
&lt;br /&gt;
Open 32 bit MSYS2 shell: msys2_shell.cmd&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
pacman -Sy pacman&lt;br /&gt;
pacman -Syu&lt;br /&gt;
pacman -Su&lt;br /&gt;
pacman -S tar&lt;br /&gt;
pacman -S zip&lt;br /&gt;
pacman -S unzip&lt;br /&gt;
pacman -S git&lt;br /&gt;
pacman -S base-devel&lt;br /&gt;
pacman -S python&lt;br /&gt;
#For compiling win32/32bit under a MinGW64&lt;br /&gt;
pacman -S mingw-w64-i686-toolchain&lt;br /&gt;
pacman -S mingw-w64-i686-glew&lt;br /&gt;
pacman -S mingw-w64-i686-curl&lt;br /&gt;
pacman -S mingw-w64-i686-libpng&lt;br /&gt;
#For compiling win32/64bit under a MinGW64&lt;br /&gt;
pacman -S mingw-w64-x86_64-toolchain&lt;br /&gt;
pacman -S mingw-w64-x86_64-glew&lt;br /&gt;
pacman -S mingw-w64-x86_64-curl&lt;br /&gt;
pacman -S mingw-w64-x86_64-libpng&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.3 (Mac) Install Git &amp;amp; xcpretty ===&lt;br /&gt;
    http://git-scm.com/downloads&lt;br /&gt;
    &lt;br /&gt;
Ctrl + right click, open with « Install program.app » Follow instructions keeping default values as they are. &lt;br /&gt;
&lt;br /&gt;
(MAC) open a terminal window &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
git config -global user.name &amp;quot;your git login&amp;quot; &lt;br /&gt;
git config -global user.email &amp;quot;your git email&amp;quot;&lt;br /&gt;
sudo gem install xcpretty&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
=== 1.3.1 (Linux/Debian) Install Git, build-tools ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
apt install git build-essential libxcb-xinerama0 libgl1-mesa-dev libz-dev libasound2-dev&lt;br /&gt;
git config --global user.email &amp;quot;your git email&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.4 (PC) Android requirements ===&lt;br /&gt;
&lt;br /&gt;
==== 1.4.1 Install Android Studio and NDK ====&lt;br /&gt;
&lt;br /&gt;
    https://developer.android.com/studio/index.html&lt;br /&gt;
    https://developer.android.com/ndk/downloads/older_releases.html&lt;br /&gt;
&lt;br /&gt;
Recommended NDK is 25c (the x86_64 version)&lt;br /&gt;
&lt;br /&gt;
Once downloaded, copy the contents of the NDK to your home or C: folder, rename the folder that you copied to &#039;android-ndk&#039;, for example you will end up with &#039;c:\android-ndk&#039; and below that folders that say build, meta, platforms, etc.&lt;br /&gt;
&lt;br /&gt;
==== 1.4.2 Install Ant (no longer required but kept util someone confirms this)====&lt;br /&gt;
    https://ant.apache.org/&lt;br /&gt;
&lt;br /&gt;
Once downloaded, copy the contents of the install archive/zip file to your home folder or C: drive.&lt;br /&gt;
Eg: so you have a folder called c:\apache-ant-1.10.5 with bin, etc, lib, manual folders within that.&lt;br /&gt;
&lt;br /&gt;
==== 1.4.3 Mix Old and New Tools (no longer required but kept util someone confirms this) ====&lt;br /&gt;
&lt;br /&gt;
Gideros uses Ant to build the player, unfortunately the tools to support Ant are now missing from the latest Android tools.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
There is a fix for this:&lt;br /&gt;
&lt;br /&gt;
# Rename the existing &#039;tools&#039; folder in the Android SDK folder to &#039;tools_new&#039;.&lt;br /&gt;
# Download an older (March 2016) version of the tools and copy that folder to the Android SDK folder.&lt;br /&gt;
# Copy the contents of &#039;tools_new&#039; over the contents of &#039;tools&#039;.&lt;br /&gt;
&lt;br /&gt;
Here is where you can download the compatible set of tools from:&lt;br /&gt;
&lt;br /&gt;
(PC) https://dl.google.com/android/repository/tools_r25.2.5-windows.zip&lt;br /&gt;
&lt;br /&gt;
(MAC) https://dl.google.com/android/repository/tools_r25.2.5-macosx.zip&lt;br /&gt;
&lt;br /&gt;
(LINUX) https://dl.google.com/android/repository/tools_r25.2.5-linux.zip&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.5 Install Java ===&lt;br /&gt;
You need the Java JDK&lt;br /&gt;
https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.6 (PC) Install Visual Studio ===&lt;br /&gt;
    https://www.visualstudio.com/downloads/&lt;br /&gt;
&lt;br /&gt;
Install [https://developer.microsoft.com/en-us/windows/downloads/windows-8-1-sdk Win 8.1 SDK]&lt;br /&gt;
&lt;br /&gt;
Install [https://marketplace.visualstudio.com/items?itemName=AdMediator.MicrosoftAdvertisingSDKforWindowsandWindowsPhone8x Microsoft Advertising SDK for Windows and Windows Phone 8.x]&lt;br /&gt;
&lt;br /&gt;
Ensure that you have MSBuild v12 or v14 installed (building with the makefile will fail with an incorrect version).&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.7 (MAC) Install Xcode ===&lt;br /&gt;
    https://itunes.apple.com/fr/app/xcode/id497799835?mt=12&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.8 (Mac) ensure xcode command line tools are working ===&lt;br /&gt;
(MAC) Open a terminal window &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
sudo xCodebuild -license &lt;br /&gt;
quit&lt;br /&gt;
agree&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br /&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.9 Install Python ===&lt;br /&gt;
https://www.python.org/downloads/release/python-2712/&lt;br /&gt;
&lt;br /&gt;
You need Python 2.7.12 or later to install emscripten properly.&lt;br /&gt;
&lt;br /&gt;
Once installed, add it to your command line path, eg: c:\python27, on windows you can do this by right-clicking on &#039;myComputer&#039; or &#039;This PC&#039;, go to &#039;Properties&#039;, click &#039;Advanced System Settings&#039;, Click &#039;Environmental Variables&#039;, double-click &#039;Path&#039;, add &#039;c:\python27&#039;.&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.10 Install emscripten ===&lt;br /&gt;
    http://kripken.github.io/emscripten-site/&lt;br /&gt;
&lt;br /&gt;
You need this is you want to build for HTML5 + Facebook games.&lt;br /&gt;
&lt;br /&gt;
Using a shell or MSYS2 (previously installed) on windows, go to your home or C: folder and type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://github.com/juj/emsdk.git&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Once that has completed open a command prompt in that folder on Windows, on other system just cd to the folder.&lt;br /&gt;
&lt;br /&gt;
Using emsdk, install and activate all the latest packages:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
#(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install latest&lt;br /&gt;
emsdk activate latest&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(PC) Type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
emsdk_env.bat&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(MAC) Type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
source ./emsdk_env.sh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To use incoming branch of emscripten, use these commands instead:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
#(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install sdk-incoming-64bit&lt;br /&gt;
emsdk activate sdk-incoming-64bit&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To further use Gideros own git fork of emscripten:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
cd emscripten/incoming&lt;br /&gt;
# Add a git remote link to your own repository.&lt;br /&gt;
git remote add gideros https://github.com/gideros/emscripten.git&lt;br /&gt;
# Obtain the changes in your link.&lt;br /&gt;
git fetch gideros&lt;br /&gt;
# Switch the emscripten-incoming tool to use your fork.&lt;br /&gt;
git checkout -b gideros_incoming --track gideros/incoming&lt;br /&gt;
#Get back to emscripten directory and rebuild&lt;br /&gt;
cd ../..&lt;br /&gt;
emsdk install sdk-incoming-64bit&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
These can also be installed within emsdk: git, crunch, and spidermonkey&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install git-1.9.4&lt;br /&gt;
emsdk install crunch-1.03&lt;br /&gt;
emsdk install spidermonkey-37.0.1-64bit&lt;br /&gt;
emsdk activate git-1.9.4&lt;br /&gt;
emsdk activate crunch-1.03&lt;br /&gt;
emsdk activate spidermonkey-37.0.1-64bit&lt;br /&gt;
(PC) emsdk_env.bat&lt;br /&gt;
(MAC) source ./emsdk_env.sh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(PC) Make sure the environment variable EM_CONFIG is set to the location of your emscripten config file.&lt;br /&gt;
&lt;br /&gt;
The emscripten build also needs the CMake command.  You can download it and extract it to your home or C: folder.  Don&#039;t forget to add it&#039;s path to the end of the EMSDKPATH in Makefile.def.&lt;br /&gt;
&lt;br /&gt;
https://cmake.org/download/&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.11 Install Steam SDK ===&lt;br /&gt;
    https://partner.steamgames.com/?goto=%2Fdownloads%2Fsteamworks_sdk.zip&lt;br /&gt;
&lt;br /&gt;
Extract the archive/zip file to your home or C: folder, for example if the file is called &#039;steamworks_sdk_142.zip&#039; then you will have a &#039;c:\steamworks_sdk_142&#039; folder with a solder called &#039;sdk&#039; within it.  The sdk folder contains other folders such as glmgr, public, tools, etc.&lt;br /&gt;
&lt;br /&gt;
This is necessary for the Steam plugin.&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.12 Install Gideros ===&lt;br /&gt;
&lt;br /&gt;
==== 1.12.1 Fetch gideros source code ====&lt;br /&gt;
(PC) Open MSYS2 32 bit shell&lt;br /&gt;
&lt;br /&gt;
(MAC/Linux) Open a terminal&lt;br /&gt;
&lt;br /&gt;
Navigate to the folder where you into to work.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    git clone https://github.com/gideros/gideros &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== 1.12.2 Configure scripts ====&lt;br /&gt;
Make a copy of the file gideros/scripts/Makefile.def.example, rename it to Makefile.def and update the file copy according &lt;br /&gt;
to your installation. Ensure that the QT\_ARCH and QT_TOOLSARCH paths are formatted correctly according to your Qt &lt;br /&gt;
install directory structure (see below that they are named differently by Qt).&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;&#039;&#039;&#039;Example:&#039;&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;On PC:&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
For Qt:&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;gt;QTBASEDIR=/c/Qt&lt;br /&gt;
QT_ARCH=mingw53_32&lt;br /&gt;
QT_TOOLSARCH=mingw530_32&lt;br /&gt;
QTVER=5.9.1&lt;br /&gt;
QT5ICUVER=59&lt;br /&gt;
&lt;br /&gt;
STEAMSDK=/c/Applications/steamworks_sdk_142&lt;br /&gt;
export STEAMSDK&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
For Android:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
# on Windows, also add this to PATH&lt;br /&gt;
NDK_HOME=/c/android/android-ndk-r17b&lt;br /&gt;
NDKBUILD=cmd //c /c/android/android-ndk-r17b/ndk-build.cmd&lt;br /&gt;
#We use windows syntax for this one, as it will be used by gradle.bat script&lt;br /&gt;
JAVA_HOME=C:\Program Files\Java\jdk1.8.0_144&lt;br /&gt;
#Windows syntax with quadruple backslashs!&lt;br /&gt;
ANDROID_HOME=C:\\\\Users\\\\Gideros\\\\AppData\\\\Local\\\\Android\\\\sdk&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
For WinRT:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
FXC=&amp;quot;/c/Program Files (x86)/Windows Kits/8.1/bin/x86/fxc.exe&amp;quot; &lt;br /&gt;
MSBUILD=&amp;quot;/c/Program Files (x86)/MSBuild/14.0/Bin/MSbuild.exe&amp;quot; &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
For html5:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
EMSDK=/c/emsdkwin&lt;br /&gt;
EMSDKPATH=$(EMSDK):$(EMSDK)/clang/e1.35.0_64bit:$(EMSDK)/node/4.1.1_64bit/bin:$(EMSDK)/python/2.7.5.3_64bit:$(EMSDK)/emscripten/1.35.0&lt;br /&gt;
EMSDK_PREFIX=PATH=$(EMSDKPATH):$$$$PATH cmd //c&lt;br /&gt;
CRUNCHME=crunchme-win32.exe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;On MAC:&#039;&#039;&#039; &lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
QTBASEDIR=~/Qt QT_ARCH=clang_64 &lt;br /&gt;
QT_TOOLSARCH=clang_64 &lt;br /&gt;
QTVER=5.8 &lt;br /&gt;
QT5ICUVER=54 #deprecated stuff &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;On Linux:&#039;&#039;&#039; &lt;br /&gt;
(tested on Debian 11)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
QT=/usr&lt;br /&gt;
QMAKE=qmake6&lt;br /&gt;
QTLIBS=/lib/x86_64-linux-gnu&lt;br /&gt;
QTPLUGINS=$(QTLIBS)/qt6/plugins&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== 1.12.3 Complete working example Makefile.def for Windows ====&lt;br /&gt;
&lt;br /&gt;
Here is a working example, you will have to change the filename details to match your setup:&lt;br /&gt;
&lt;br /&gt;
[[Example Makefile.def file|example Makefile.def file]].&lt;br /&gt;
&lt;br /&gt;
==== 1.12.4 Fetch additional repositories ====&lt;br /&gt;
&lt;br /&gt;
Go into just cloned gideros source folder and run make prep.repo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    cd gideros&lt;br /&gt;
    make -f scripts/Makefile.gid prep.repo &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
If you intend to build the studio, you&#039;ll need scintilla and Lexilla libraries. Compile them now with:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    make -f scripts/Makefile.gid qlexilla&lt;br /&gt;
    make -f scripts/Makefile.gid qscintilla&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
== 2. Building ==&lt;br /&gt;
&lt;br /&gt;
If you have all dependencies in place for all targets, you can build everything at once via MSYS2 or Terminal with:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 2.1 Compilation on PC :===&lt;br /&gt;
&lt;br /&gt;
Open MSYS2 shell (msys2_shell.cmd). Standard compilation is 32 bit so use a 32 bit shell. Make sure you have installed the necessary build tools in MSYS2 using pacman, as detailed in [[#1.2 (PC) Install MSYS2 Console|Install MSYS2 Console]].&lt;br /&gt;
.&lt;br /&gt;
&lt;br /&gt;
Navigate to gideros folder &lt;br /&gt;
 &lt;br /&gt;
==== 2.1.1 Build QT tools : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid qtapp.install&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
-&amp;gt; files GiderosStudio.exe, GiderosPlayer.exe, GiderosTexturePacker.exe (…) in Build.Win folder &lt;br /&gt;
&lt;br /&gt;
==== 2.1.2 Android: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid android.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= file GiderosAndroidPlayer.apk in folder Build.Win/Players &lt;br /&gt;
&lt;br /&gt;
==== 2.1.3 winRT: ====&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;If necessary :&#039;&#039;&lt;br /&gt;
Open the solution, gideros/winRT_example/giderosgame.sln in Visual Studio. Check that the SQLite version for Windows and Windows Phone is up to date. Save and close the solution. &lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid winrt.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= file _bundle.appxupload in folder Build.Win/Players/WinRT&lt;br /&gt;
&lt;br /&gt;
==== 2.1.4 win32: ====&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid win32.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= files in folder Build.Win/Templates/win32 &lt;br /&gt;
 &lt;br /&gt;
==== 2.1.5 Html5: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid html5.install&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
-&amp;gt; files in folders Build.Win//Players/Html5 and Build.Win/Templates/Html5&lt;br /&gt;
&lt;br /&gt;
==== 2.1.6 Plugins: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.win &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= folder bin and file gplugin in folder Build.Win/All Plugins&lt;br /&gt;
&lt;br /&gt;
==== 2.1.7 To build everything that can be built on Windows ====&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid all&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Then you need to copy all the plugins to the &#039;Build.Win&#039; folder with:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.win&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 2.2 Compilation on Mac :===&lt;br /&gt;
Open Terminal.  &lt;br /&gt;
&lt;br /&gt;
cd to the folder « gideros » &lt;br /&gt;
&lt;br /&gt;
==== 2.2.1 QT : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid qtapp.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= GiderosStudio.exe, GiderosPlayer.exe, GiderosTexturePacker.exe (…) in folder Build.Mac &lt;br /&gt;
&lt;br /&gt;
==== 2.2.2 iOS : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid ios.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= GiderosiOSPlayer.zip in folder Buid.Mac/Players &lt;br /&gt;
&lt;br /&gt;
==== 2.2.3 Plugins: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.mac &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= folders bin and files gplugin in folder Buid.Mac/All Plugins&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
== 3. Cleaning ==&lt;br /&gt;
&lt;br /&gt;
If you want to reset the build process and start again then you can issue a &#039;clean&#039; command.  To do this type &#039;make -f scripts/Makefile.gid clean&#039;.&lt;br /&gt;
&lt;br /&gt;
eg:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid clean&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Sometimes you need to make a clean a particular build.  To do this type &#039;make -f scripts/Makefile.gid &#039; followed by something like &#039;html5&#039; then &#039;.clean&#039;.&lt;br /&gt;
&lt;br /&gt;
eg:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid html5.clean&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Compiling_Gideros_Source&amp;diff=22475</id>
		<title>Compiling Gideros Source</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Compiling_Gideros_Source&amp;diff=22475"/>
		<updated>2023-08-18T05:59:09Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;The following instructions are for developers who want to contribute to or otherwise experiment with the Gideros C/C++ engine and are &#039;&#039;not&#039;&#039; necessary for either building or deploying apps made with Gideros.&lt;br /&gt;
&lt;br /&gt;
The Gideros project consists of the Gideros Studio IDE, the Gideros SDK libraries, Gideros Texture Packer, Gideros Font Creator, &amp;quot;players&amp;quot; or export templates for all the platforms Gideros supports, all targets of all plugins, a daemon and a bridge. The build system is flexible, so you only need the tools for the targets you are interested in deploying to with Qt (and MSYS2 on Windows) being a realistic minimum.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div class=&amp;quot;noautonum&amp;quot;&amp;gt;__TOC__&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 1. Requirements ==&lt;br /&gt;
=== 1.1 Install QT ===&lt;br /&gt;
https://www.qt.io/download-open-source/&lt;br /&gt;
&lt;br /&gt;
Recommended version 6.3 with MinGW &amp;lt;br /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Double click on the downloaded file and follow instructions. When installing, expand the tree view and ensure you have ticked the MinGW child option of the Qt version checkbox, as well as the MinGW option in the Tools section.&lt;br /&gt;
Beside main QT package, you&#039;ll need the following additional components:&lt;br /&gt;
* WebSocket additional library&lt;br /&gt;
* Multimedia additional library&lt;br /&gt;
* Qt5 Compatibility addon&lt;br /&gt;
  &lt;br /&gt;
(MAC) Move the created folder into your user account folder &lt;br /&gt;
&lt;br /&gt;
(LINUX) &lt;br /&gt;
On Debian 11:&lt;br /&gt;
echo &amp;quot;deb http://deb.debian.org/debian bullseye-backports main&amp;quot; &amp;gt;&amp;gt;/etc/apt/sources.list&lt;br /&gt;
apt update&lt;br /&gt;
apt install qt6-base-dev qt6-websockets-dev qt6-multimedia-dev qt6-5compat-dev&lt;br /&gt;
&lt;br /&gt;
Depending on your distribution, you may need to install qt5 websocket lib seperately (sudo apt-get install libqt5websockets5-dev)&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
===1.2 (PC) Install MSYS2 Console===&lt;br /&gt;
    https://msys2.github.io/ &lt;br /&gt;
&lt;br /&gt;
Double click on the downloaded file (msys2-i686) and follow instructions. &lt;br /&gt;
&lt;br /&gt;
Open 32 bit MSYS2 shell: msys2_shell.cmd&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
pacman -Sy pacman&lt;br /&gt;
pacman -Syu&lt;br /&gt;
pacman -Su&lt;br /&gt;
pacman -S tar&lt;br /&gt;
pacman -S zip&lt;br /&gt;
pacman -S unzip&lt;br /&gt;
pacman -S git&lt;br /&gt;
pacman -S base-devel&lt;br /&gt;
pacman -S python&lt;br /&gt;
#For compiling win32/32bit under a MinGW64&lt;br /&gt;
pacman -S mingw-w64-i686-toolchain&lt;br /&gt;
pacman -S mingw-w64-i686-glew&lt;br /&gt;
pacman -S mingw-w64-i686-curl&lt;br /&gt;
pacman -S mingw-w64-i686-libpng&lt;br /&gt;
#For compiling win32/64bit under a MinGW64&lt;br /&gt;
pacman -S mingw-w64-x86_64-toolchain&lt;br /&gt;
pacman -S mingw-w64-x86_64-glew&lt;br /&gt;
pacman -S mingw-w64-x86_64-curl&lt;br /&gt;
pacman -S mingw-w64-x86_64-libpng&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.3 (Mac) Install Git &amp;amp; xcpretty ===&lt;br /&gt;
    http://git-scm.com/downloads&lt;br /&gt;
    &lt;br /&gt;
Ctrl + right click, open with « Install program.app » Follow instructions keeping default values as they are. &lt;br /&gt;
&lt;br /&gt;
(MAC) open a terminal window &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
git config -global user.name &amp;quot;your git login&amp;quot; &lt;br /&gt;
git config -global user.email &amp;quot;your git email&amp;quot;&lt;br /&gt;
sudo gem install xcpretty&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
=== 1.3.1 (Linux/Debian) Install Git, build-tools ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
apt install git build-essential libxcb-xinerama0 libgl1-mesa-dev libz-dev libasound2-dev&lt;br /&gt;
git config --global user.email &amp;quot;your git email&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.4 (PC) Android requirements ===&lt;br /&gt;
&lt;br /&gt;
==== 1.4.1 Install Android Studio and NDK ====&lt;br /&gt;
&lt;br /&gt;
    https://developer.android.com/studio/index.html&lt;br /&gt;
    https://developer.android.com/ndk/downloads/older_releases.html&lt;br /&gt;
&lt;br /&gt;
Recommended NDK is 17b (the x86_64 version)&lt;br /&gt;
&lt;br /&gt;
Once downloaded, copy the contents of the NDK to your home or C: folder, rename the folder that you copied to &#039;android-ndk&#039;, for example you will end up with &#039;c:\android-ndk&#039; and below that folders that say build, meta, platforms, etc.&lt;br /&gt;
&lt;br /&gt;
==== 1.4.2 Install Ant (no longer required but kept util someone confirms this)====&lt;br /&gt;
    https://ant.apache.org/&lt;br /&gt;
&lt;br /&gt;
Once downloaded, copy the contents of the install archive/zip file to your home folder or C: drive.&lt;br /&gt;
Eg: so you have a folder called c:\apache-ant-1.10.5 with bin, etc, lib, manual folders within that.&lt;br /&gt;
&lt;br /&gt;
==== 1.4.3 Mix Old and New Tools (no longer required but kept util someone confirms this) ====&lt;br /&gt;
&lt;br /&gt;
Gideros uses Ant to build the player, unfortunately the tools to support Ant are now missing from the latest Android tools.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
There is a fix for this:&lt;br /&gt;
&lt;br /&gt;
# Rename the existing &#039;tools&#039; folder in the Android SDK folder to &#039;tools_new&#039;.&lt;br /&gt;
# Download an older (March 2016) version of the tools and copy that folder to the Android SDK folder.&lt;br /&gt;
# Copy the contents of &#039;tools_new&#039; over the contents of &#039;tools&#039;.&lt;br /&gt;
&lt;br /&gt;
Here is where you can download the compatible set of tools from:&lt;br /&gt;
&lt;br /&gt;
(PC) https://dl.google.com/android/repository/tools_r25.2.5-windows.zip&lt;br /&gt;
&lt;br /&gt;
(MAC) https://dl.google.com/android/repository/tools_r25.2.5-macosx.zip&lt;br /&gt;
&lt;br /&gt;
(LINUX) https://dl.google.com/android/repository/tools_r25.2.5-linux.zip&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.5 Install Java ===&lt;br /&gt;
You need the Java JDK&lt;br /&gt;
https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.6 (PC) Install Visual Studio ===&lt;br /&gt;
    https://www.visualstudio.com/downloads/&lt;br /&gt;
&lt;br /&gt;
Install [https://developer.microsoft.com/en-us/windows/downloads/windows-8-1-sdk Win 8.1 SDK]&lt;br /&gt;
&lt;br /&gt;
Install [https://marketplace.visualstudio.com/items?itemName=AdMediator.MicrosoftAdvertisingSDKforWindowsandWindowsPhone8x Microsoft Advertising SDK for Windows and Windows Phone 8.x]&lt;br /&gt;
&lt;br /&gt;
Ensure that you have MSBuild v12 or v14 installed (building with the makefile will fail with an incorrect version).&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.7 (MAC) Install Xcode ===&lt;br /&gt;
    https://itunes.apple.com/fr/app/xcode/id497799835?mt=12&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.8 (Mac) ensure xcode command line tools are working ===&lt;br /&gt;
(MAC) Open a terminal window &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
sudo xCodebuild -license &lt;br /&gt;
quit&lt;br /&gt;
agree&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br /&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.9 Install Python ===&lt;br /&gt;
https://www.python.org/downloads/release/python-2712/&lt;br /&gt;
&lt;br /&gt;
You need Python 2.7.12 or later to install emscripten properly.&lt;br /&gt;
&lt;br /&gt;
Once installed, add it to your command line path, eg: c:\python27, on windows you can do this by right-clicking on &#039;myComputer&#039; or &#039;This PC&#039;, go to &#039;Properties&#039;, click &#039;Advanced System Settings&#039;, Click &#039;Environmental Variables&#039;, double-click &#039;Path&#039;, add &#039;c:\python27&#039;.&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.10 Install emscripten ===&lt;br /&gt;
    http://kripken.github.io/emscripten-site/&lt;br /&gt;
&lt;br /&gt;
You need this is you want to build for HTML5 + Facebook games.&lt;br /&gt;
&lt;br /&gt;
Using a shell or MSYS2 (previously installed) on windows, go to your home or C: folder and type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://github.com/juj/emsdk.git&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Once that has completed open a command prompt in that folder on Windows, on other system just cd to the folder.&lt;br /&gt;
&lt;br /&gt;
Using emsdk, install and activate all the latest packages:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
#(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install latest&lt;br /&gt;
emsdk activate latest&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(PC) Type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
emsdk_env.bat&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(MAC) Type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
source ./emsdk_env.sh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To use incoming branch of emscripten, use these commands instead:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
#(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install sdk-incoming-64bit&lt;br /&gt;
emsdk activate sdk-incoming-64bit&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To further use Gideros own git fork of emscripten:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
cd emscripten/incoming&lt;br /&gt;
# Add a git remote link to your own repository.&lt;br /&gt;
git remote add gideros https://github.com/gideros/emscripten.git&lt;br /&gt;
# Obtain the changes in your link.&lt;br /&gt;
git fetch gideros&lt;br /&gt;
# Switch the emscripten-incoming tool to use your fork.&lt;br /&gt;
git checkout -b gideros_incoming --track gideros/incoming&lt;br /&gt;
#Get back to emscripten directory and rebuild&lt;br /&gt;
cd ../..&lt;br /&gt;
emsdk install sdk-incoming-64bit&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
These can also be installed within emsdk: git, crunch, and spidermonkey&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install git-1.9.4&lt;br /&gt;
emsdk install crunch-1.03&lt;br /&gt;
emsdk install spidermonkey-37.0.1-64bit&lt;br /&gt;
emsdk activate git-1.9.4&lt;br /&gt;
emsdk activate crunch-1.03&lt;br /&gt;
emsdk activate spidermonkey-37.0.1-64bit&lt;br /&gt;
(PC) emsdk_env.bat&lt;br /&gt;
(MAC) source ./emsdk_env.sh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(PC) Make sure the environment variable EM_CONFIG is set to the location of your emscripten config file.&lt;br /&gt;
&lt;br /&gt;
The emscripten build also needs the CMake command.  You can download it and extract it to your home or C: folder.  Don&#039;t forget to add it&#039;s path to the end of the EMSDKPATH in Makefile.def.&lt;br /&gt;
&lt;br /&gt;
https://cmake.org/download/&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.11 Install Steam SDK ===&lt;br /&gt;
    https://partner.steamgames.com/?goto=%2Fdownloads%2Fsteamworks_sdk.zip&lt;br /&gt;
&lt;br /&gt;
Extract the archive/zip file to your home or C: folder, for example if the file is called &#039;steamworks_sdk_142.zip&#039; then you will have a &#039;c:\steamworks_sdk_142&#039; folder with a solder called &#039;sdk&#039; within it.  The sdk folder contains other folders such as glmgr, public, tools, etc.&lt;br /&gt;
&lt;br /&gt;
This is necessary for the Steam plugin.&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.12 Install Gideros ===&lt;br /&gt;
&lt;br /&gt;
==== 1.12.1 Fetch gideros source code ====&lt;br /&gt;
(PC) Open MSYS2 32 bit shell&lt;br /&gt;
&lt;br /&gt;
(MAC/Linux) Open a terminal&lt;br /&gt;
&lt;br /&gt;
Navigate to the folder where you into to work.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    git clone https://github.com/gideros/gideros &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== 1.12.2 Configure scripts ====&lt;br /&gt;
Make a copy of the file gideros/scripts/Makefile.def.example, rename it to Makefile.def and update the file copy according &lt;br /&gt;
to your installation. Ensure that the QT\_ARCH and QT_TOOLSARCH paths are formatted correctly according to your Qt &lt;br /&gt;
install directory structure (see below that they are named differently by Qt).&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;&#039;&#039;&#039;Example:&#039;&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;On PC:&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
For Qt:&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;gt;QTBASEDIR=/c/Qt&lt;br /&gt;
QT_ARCH=mingw53_32&lt;br /&gt;
QT_TOOLSARCH=mingw530_32&lt;br /&gt;
QTVER=5.9.1&lt;br /&gt;
QT5ICUVER=59&lt;br /&gt;
&lt;br /&gt;
STEAMSDK=/c/Applications/steamworks_sdk_142&lt;br /&gt;
export STEAMSDK&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
For Android:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
# on Windows, also add this to PATH&lt;br /&gt;
NDK_HOME=/c/android/android-ndk-r17b&lt;br /&gt;
NDKBUILD=cmd //c /c/android/android-ndk-r17b/ndk-build.cmd&lt;br /&gt;
#We use windows syntax for this one, as it will be used by gradle.bat script&lt;br /&gt;
JAVA_HOME=C:\Program Files\Java\jdk1.8.0_144&lt;br /&gt;
#Windows syntax with quadruple backslashs!&lt;br /&gt;
ANDROID_HOME=C:\\\\Users\\\\Gideros\\\\AppData\\\\Local\\\\Android\\\\sdk&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
For WinRT:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
FXC=&amp;quot;/c/Program Files (x86)/Windows Kits/8.1/bin/x86/fxc.exe&amp;quot; &lt;br /&gt;
MSBUILD=&amp;quot;/c/Program Files (x86)/MSBuild/14.0/Bin/MSbuild.exe&amp;quot; &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
For html5:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
EMSDK=/c/emsdkwin&lt;br /&gt;
EMSDKPATH=$(EMSDK):$(EMSDK)/clang/e1.35.0_64bit:$(EMSDK)/node/4.1.1_64bit/bin:$(EMSDK)/python/2.7.5.3_64bit:$(EMSDK)/emscripten/1.35.0&lt;br /&gt;
EMSDK_PREFIX=PATH=$(EMSDKPATH):$$$$PATH cmd //c&lt;br /&gt;
CRUNCHME=crunchme-win32.exe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;On MAC:&#039;&#039;&#039; &lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
QTBASEDIR=~/Qt QT_ARCH=clang_64 &lt;br /&gt;
QT_TOOLSARCH=clang_64 &lt;br /&gt;
QTVER=5.8 &lt;br /&gt;
QT5ICUVER=54 #deprecated stuff &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;On Linux:&#039;&#039;&#039; &lt;br /&gt;
(tested on Debian 11)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
QT=/usr&lt;br /&gt;
QMAKE=qmake6&lt;br /&gt;
QTLIBS=/lib/x86_64-linux-gnu&lt;br /&gt;
QTPLUGINS=$(QTLIBS)/qt6/plugins&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== 1.12.3 Complete working example Makefile.def for Windows ====&lt;br /&gt;
&lt;br /&gt;
Here is a working example, you will have to change the filename details to match your setup:&lt;br /&gt;
&lt;br /&gt;
[[Example Makefile.def file|example Makefile.def file]].&lt;br /&gt;
&lt;br /&gt;
==== 1.12.4 Fetch additional repositories ====&lt;br /&gt;
&lt;br /&gt;
Go into just cloned gideros source folder and run make prep.repo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    cd gideros&lt;br /&gt;
    make -f scripts/Makefile.gid prep.repo &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
If you intend to build the studio, you&#039;ll need scintilla and Lexilla libraries. Compile them now with:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    make -f scripts/Makefile.gid qlexilla&lt;br /&gt;
    make -f scripts/Makefile.gid qscintilla&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
== 2. Building ==&lt;br /&gt;
&lt;br /&gt;
If you have all dependencies in place for all targets, you can build everything at once via MSYS2 or Terminal with:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 2.1 Compilation on PC :===&lt;br /&gt;
&lt;br /&gt;
Open MSYS2 shell (msys2_shell.cmd). Standard compilation is 32 bit so use a 32 bit shell. Make sure you have installed the necessary build tools in MSYS2 using pacman, as detailed in [[#1.2 (PC) Install MSYS2 Console|Install MSYS2 Console]].&lt;br /&gt;
.&lt;br /&gt;
&lt;br /&gt;
Navigate to gideros folder &lt;br /&gt;
 &lt;br /&gt;
==== 2.1.1 Build QT tools : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid qtapp.install&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
-&amp;gt; files GiderosStudio.exe, GiderosPlayer.exe, GiderosTexturePacker.exe (…) in Build.Win folder &lt;br /&gt;
&lt;br /&gt;
==== 2.1.2 Android: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid android.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= file GiderosAndroidPlayer.apk in folder Build.Win/Players &lt;br /&gt;
&lt;br /&gt;
==== 2.1.3 winRT: ====&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;If necessary :&#039;&#039;&lt;br /&gt;
Open the solution, gideros/winRT_example/giderosgame.sln in Visual Studio. Check that the SQLite version for Windows and Windows Phone is up to date. Save and close the solution. &lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid winrt.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= file _bundle.appxupload in folder Build.Win/Players/WinRT&lt;br /&gt;
&lt;br /&gt;
==== 2.1.4 win32: ====&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid win32.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= files in folder Build.Win/Templates/win32 &lt;br /&gt;
 &lt;br /&gt;
==== 2.1.5 Html5: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid html5.install&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
-&amp;gt; files in folders Build.Win//Players/Html5 and Build.Win/Templates/Html5&lt;br /&gt;
&lt;br /&gt;
==== 2.1.6 Plugins: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.win &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= folder bin and file gplugin in folder Build.Win/All Plugins&lt;br /&gt;
&lt;br /&gt;
==== 2.1.7 To build everything that can be built on Windows ====&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid all&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Then you need to copy all the plugins to the &#039;Build.Win&#039; folder with:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.win&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 2.2 Compilation on Mac :===&lt;br /&gt;
Open Terminal.  &lt;br /&gt;
&lt;br /&gt;
cd to the folder « gideros » &lt;br /&gt;
&lt;br /&gt;
==== 2.2.1 QT : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid qtapp.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= GiderosStudio.exe, GiderosPlayer.exe, GiderosTexturePacker.exe (…) in folder Build.Mac &lt;br /&gt;
&lt;br /&gt;
==== 2.2.2 iOS : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid ios.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= GiderosiOSPlayer.zip in folder Buid.Mac/Players &lt;br /&gt;
&lt;br /&gt;
==== 2.2.3 Plugins: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.mac &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= folders bin and files gplugin in folder Buid.Mac/All Plugins&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
== 3. Cleaning ==&lt;br /&gt;
&lt;br /&gt;
If you want to reset the build process and start again then you can issue a &#039;clean&#039; command.  To do this type &#039;make -f scripts/Makefile.gid clean&#039;.&lt;br /&gt;
&lt;br /&gt;
eg:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid clean&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Sometimes you need to make a clean a particular build.  To do this type &#039;make -f scripts/Makefile.gid &#039; followed by something like &#039;html5&#039; then &#039;.clean&#039;.&lt;br /&gt;
&lt;br /&gt;
eg:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid html5.clean&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
	<entry>
		<id>https://wiki.gideros.rocks/index.php?title=Compiling_Gideros_Source&amp;diff=22474</id>
		<title>Compiling Gideros Source</title>
		<link rel="alternate" type="text/html" href="https://wiki.gideros.rocks/index.php?title=Compiling_Gideros_Source&amp;diff=22474"/>
		<updated>2023-08-17T13:55:31Z</updated>

		<summary type="html">&lt;p&gt;Hgy29: /* 1.12.2 Configure scripts */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;The following instructions are for developers who want to contribute to or otherwise experiment with the Gideros C/C++ engine and are &#039;&#039;not&#039;&#039; necessary for either building or deploying apps made with Gideros.&lt;br /&gt;
&lt;br /&gt;
The Gideros project consists of the Gideros Studio IDE, the Gideros SDK libraries, Gideros Texture Packer, Gideros Font Creator, &amp;quot;players&amp;quot; or export templates for all the platforms Gideros supports, all targets of all plugins, a daemon and a bridge. The build system is flexible, so you only need the tools for the targets you are interested in deploying to with Qt (and MSYS2 on Windows) being a realistic minimum.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div class=&amp;quot;noautonum&amp;quot;&amp;gt;__TOC__&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 1. Requirements ==&lt;br /&gt;
=== 1.1 Install QT ===&lt;br /&gt;
https://www.qt.io/download-open-source/&lt;br /&gt;
&lt;br /&gt;
Recommended version 6.3 with MinGW &amp;lt;br /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Double click on the downloaded file and follow instructions. When installing, expand the tree view and ensure you have ticked the MinGW child option of the Qt version checkbox, as well as the MinGW option in the Tools section.&lt;br /&gt;
Beside main QT package, you&#039;ll need the following additional components:&lt;br /&gt;
* WebSocket additional library&lt;br /&gt;
* Multimedia additional library&lt;br /&gt;
* Qt5 Compatibility addon&lt;br /&gt;
  &lt;br /&gt;
(MAC) Move the created folder into your user account folder &lt;br /&gt;
&lt;br /&gt;
(LINUX) &lt;br /&gt;
On Debian 11:&lt;br /&gt;
echo &amp;quot;deb http://deb.debian.org/debian bullseye-backports main&amp;quot; &amp;gt;&amp;gt;/etc/apt/sources.list&lt;br /&gt;
apt update&lt;br /&gt;
apt install qt6-base-dev qt6-websockets-dev qt6-multimedia-dev qt6-5compat-dev&lt;br /&gt;
&lt;br /&gt;
Depending on your distribution, you may need to install qt5 websocket lib seperately (sudo apt-get install libqt5websockets5-dev)&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
===1.2 (PC) Install MSYS2 Console===&lt;br /&gt;
    https://msys2.github.io/ &lt;br /&gt;
&lt;br /&gt;
Double click on the downloaded file (msys2-i686) and follow instructions. &lt;br /&gt;
&lt;br /&gt;
Open 32 bit MSYS2 shell: msys2_shell.cmd&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
pacman –Sy pacman&lt;br /&gt;
pacman –Syu&lt;br /&gt;
pacman –Su&lt;br /&gt;
pacman –S tar&lt;br /&gt;
pacman –S zip&lt;br /&gt;
pacman –S unzip&lt;br /&gt;
pacman –S git&lt;br /&gt;
pacman –S base-devel&lt;br /&gt;
pacman -S python&lt;br /&gt;
#For compiling win32/32bit under a MinGW64&lt;br /&gt;
pacman -S mingw-w64-i686-toolchain&lt;br /&gt;
pacman -S mingw-w64-i686-glew&lt;br /&gt;
pacman -S mingw-w64-i686-curl&lt;br /&gt;
pacman -S mingw-w64-i686-libpng&lt;br /&gt;
#For compiling win32/64bit under a MinGW64&lt;br /&gt;
pacman -S mingw-w64-x86_64-toolchain&lt;br /&gt;
pacman -S mingw-w64-x86_64-glew&lt;br /&gt;
pacman -S mingw-w64-x86_64-curl&lt;br /&gt;
pacman -S mingw-w64-x86_64-libpng&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.3 (Mac) Install Git &amp;amp; xcpretty ===&lt;br /&gt;
    http://git-scm.com/downloads&lt;br /&gt;
    &lt;br /&gt;
Ctrl + right click, open with « Install program.app » Follow instructions keeping default values as they are. &lt;br /&gt;
&lt;br /&gt;
(MAC) open a terminal window &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
git config –global user.name &amp;quot;your git login&amp;quot; &lt;br /&gt;
git config –global user.email &amp;quot;your git email&amp;quot;&lt;br /&gt;
sudo gem install xcpretty&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
=== 1.3.1 (Linux/Debian) Install Git, build-tools ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
apt install git build-essential libxcb-xinerama0 libgl1-mesa-dev libz-dev libasound2-dev&lt;br /&gt;
git config --global user.email &amp;quot;your git email&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.4 (PC) Android requirements ===&lt;br /&gt;
&lt;br /&gt;
==== 1.4.1 Install Android Studio and NDK ====&lt;br /&gt;
&lt;br /&gt;
    https://developer.android.com/studio/index.html&lt;br /&gt;
    https://developer.android.com/ndk/downloads/older_releases.html&lt;br /&gt;
&lt;br /&gt;
Recommended NDK is 17b (the x86_64 version)&lt;br /&gt;
&lt;br /&gt;
Once downloaded, copy the contents of the NDK to your home or C: folder, rename the folder that you copied to &#039;android-ndk&#039;, for example you will end up with &#039;c:\android-ndk&#039; and below that folders that say build, meta, platforms, etc.&lt;br /&gt;
&lt;br /&gt;
==== 1.4.2 Install Ant (no longer required but kept util someone confirms this)====&lt;br /&gt;
    https://ant.apache.org/&lt;br /&gt;
&lt;br /&gt;
Once downloaded, copy the contents of the install archive/zip file to your home folder or C: drive.&lt;br /&gt;
Eg: so you have a folder called c:\apache-ant-1.10.5 with bin, etc, lib, manual folders within that.&lt;br /&gt;
&lt;br /&gt;
==== 1.4.3 Mix Old and New Tools (no longer required but kept util someone confirms this) ====&lt;br /&gt;
&lt;br /&gt;
Gideros uses Ant to build the player, unfortunately the tools to support Ant are now missing from the latest Android tools.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
There is a fix for this:&lt;br /&gt;
&lt;br /&gt;
# Rename the existing &#039;tools&#039; folder in the Android SDK folder to &#039;tools_new&#039;.&lt;br /&gt;
# Download an older (March 2016) version of the tools and copy that folder to the Android SDK folder.&lt;br /&gt;
# Copy the contents of &#039;tools_new&#039; over the contents of &#039;tools&#039;.&lt;br /&gt;
&lt;br /&gt;
Here is where you can download the compatible set of tools from:&lt;br /&gt;
&lt;br /&gt;
(PC) https://dl.google.com/android/repository/tools_r25.2.5-windows.zip&lt;br /&gt;
&lt;br /&gt;
(MAC) https://dl.google.com/android/repository/tools_r25.2.5-macosx.zip&lt;br /&gt;
&lt;br /&gt;
(LINUX) https://dl.google.com/android/repository/tools_r25.2.5-linux.zip&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.5 Install Java ===&lt;br /&gt;
You need the Java JDK&lt;br /&gt;
https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.6 (PC) Install Visual Studio ===&lt;br /&gt;
    https://www.visualstudio.com/downloads/&lt;br /&gt;
&lt;br /&gt;
Install [https://developer.microsoft.com/en-us/windows/downloads/windows-8-1-sdk Win 8.1 SDK]&lt;br /&gt;
&lt;br /&gt;
Install [https://marketplace.visualstudio.com/items?itemName=AdMediator.MicrosoftAdvertisingSDKforWindowsandWindowsPhone8x Microsoft Advertising SDK for Windows and Windows Phone 8.x]&lt;br /&gt;
&lt;br /&gt;
Ensure that you have MSBuild v12 or v14 installed (building with the makefile will fail with an incorrect version).&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.7 (MAC) Install Xcode ===&lt;br /&gt;
    https://itunes.apple.com/fr/app/xcode/id497799835?mt=12&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.8 (Mac) ensure xcode command line tools are working ===&lt;br /&gt;
(MAC) Open a terminal window &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
sudo xCodebuild –license &lt;br /&gt;
quit&lt;br /&gt;
agree&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br /&amp;gt;&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.9 Install Python ===&lt;br /&gt;
https://www.python.org/downloads/release/python-2712/&lt;br /&gt;
&lt;br /&gt;
You need Python 2.7.12 or later to install emscripten properly.&lt;br /&gt;
&lt;br /&gt;
Once installed, add it to your command line path, eg: c:\python27, on windows you can do this by right-clicking on &#039;myComputer&#039; or &#039;This PC&#039;, go to &#039;Properties&#039;, click &#039;Advanced System Settings&#039;, Click &#039;Environmental Variables&#039;, double-click &#039;Path&#039;, add &#039;c:\python27&#039;.&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.10 Install emscripten ===&lt;br /&gt;
    http://kripken.github.io/emscripten-site/&lt;br /&gt;
&lt;br /&gt;
You need this is you want to build for HTML5 + Facebook games.&lt;br /&gt;
&lt;br /&gt;
Using a shell or MSYS2 (previously installed) on windows, go to your home or C: folder and type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://github.com/juj/emsdk.git&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Once that has completed open a command prompt in that folder on Windows, on other system just cd to the folder.&lt;br /&gt;
&lt;br /&gt;
Using emsdk, install and activate all the latest packages:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
#(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install latest&lt;br /&gt;
emsdk activate latest&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(PC) Type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
emsdk_env.bat&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(MAC) Type:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
source ./emsdk_env.sh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To use incoming branch of emscripten, use these commands instead:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
#(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install sdk-incoming-64bit&lt;br /&gt;
emsdk activate sdk-incoming-64bit&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To further use Gideros own git fork of emscripten:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
cd emscripten/incoming&lt;br /&gt;
# Add a git remote link to your own repository.&lt;br /&gt;
git remote add gideros https://github.com/gideros/emscripten.git&lt;br /&gt;
# Obtain the changes in your link.&lt;br /&gt;
git fetch gideros&lt;br /&gt;
# Switch the emscripten-incoming tool to use your fork.&lt;br /&gt;
git checkout -b gideros_incoming --track gideros/incoming&lt;br /&gt;
#Get back to emscripten directory and rebuild&lt;br /&gt;
cd ../..&lt;br /&gt;
emsdk install sdk-incoming-64bit&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
These can also be installed within emsdk: git, crunch, and spidermonkey&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
(on non-PC put ./ before emsdk)&lt;br /&gt;
emsdk install git-1.9.4&lt;br /&gt;
emsdk install crunch-1.03&lt;br /&gt;
emsdk install spidermonkey-37.0.1-64bit&lt;br /&gt;
emsdk activate git-1.9.4&lt;br /&gt;
emsdk activate crunch-1.03&lt;br /&gt;
emsdk activate spidermonkey-37.0.1-64bit&lt;br /&gt;
(PC) emsdk_env.bat&lt;br /&gt;
(MAC) source ./emsdk_env.sh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
(PC) Make sure the environment variable EM_CONFIG is set to the location of your emscripten config file.&lt;br /&gt;
&lt;br /&gt;
The emscripten build also needs the CMake command.  You can download it and extract it to your home or C: folder.  Don&#039;t forget to add it&#039;s path to the end of the EMSDKPATH in Makefile.def.&lt;br /&gt;
&lt;br /&gt;
https://cmake.org/download/&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.11 Install Steam SDK ===&lt;br /&gt;
    https://partner.steamgames.com/?goto=%2Fdownloads%2Fsteamworks_sdk.zip&lt;br /&gt;
&lt;br /&gt;
Extract the archive/zip file to your home or C: folder, for example if the file is called &#039;steamworks_sdk_142.zip&#039; then you will have a &#039;c:\steamworks_sdk_142&#039; folder with a solder called &#039;sdk&#039; within it.  The sdk folder contains other folders such as glmgr, public, tools, etc.&lt;br /&gt;
&lt;br /&gt;
This is necessary for the Steam plugin.&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
=== 1.12 Install Gideros ===&lt;br /&gt;
&lt;br /&gt;
==== 1.12.1 Fetch gideros source code ====&lt;br /&gt;
(PC) Open MSYS2 32 bit shell&lt;br /&gt;
&lt;br /&gt;
(MAC/Linux) Open a terminal&lt;br /&gt;
&lt;br /&gt;
Navigate to the folder where you into to work.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    git clone https://github.com/gideros/gideros &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== 1.12.2 Configure scripts ====&lt;br /&gt;
Make a copy of the file gideros/scripts/Makefile.def.example, rename it to Makefile.def and update the file copy according &lt;br /&gt;
to your installation. Ensure that the QT\_ARCH and QT_TOOLSARCH paths are formatted correctly according to your Qt &lt;br /&gt;
install directory structure (see below that they are named differently by Qt).&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;&#039;&#039;&#039;Example:&#039;&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;On PC:&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
For Qt:&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;gt;QTBASEDIR=/c/Qt&lt;br /&gt;
QT_ARCH=mingw53_32&lt;br /&gt;
QT_TOOLSARCH=mingw530_32&lt;br /&gt;
QTVER=5.9.1&lt;br /&gt;
QT5ICUVER=59&lt;br /&gt;
&lt;br /&gt;
STEAMSDK=/c/Applications/steamworks_sdk_142&lt;br /&gt;
export STEAMSDK&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
For Android:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
# on Windows, also add this to PATH&lt;br /&gt;
NDK_HOME=/c/android/android-ndk-r17b&lt;br /&gt;
NDKBUILD=cmd //c /c/android/android-ndk-r17b/ndk-build.cmd&lt;br /&gt;
#We use windows syntax for this one, as it will be used by gradle.bat script&lt;br /&gt;
JAVA_HOME=C:\Program Files\Java\jdk1.8.0_144&lt;br /&gt;
#Windows syntax with quadruple backslashs!&lt;br /&gt;
ANDROID_HOME=C:\\\\Users\\\\Gideros\\\\AppData\\\\Local\\\\Android\\\\sdk&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
For WinRT:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
FXC=&amp;quot;/c/Program Files (x86)/Windows Kits/8.1/bin/x86/fxc.exe&amp;quot; &lt;br /&gt;
MSBUILD=&amp;quot;/c/Program Files (x86)/MSBuild/14.0/Bin/MSbuild.exe&amp;quot; &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
For html5:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
EMSDK=/c/emsdkwin&lt;br /&gt;
EMSDKPATH=$(EMSDK):$(EMSDK)/clang/e1.35.0_64bit:$(EMSDK)/node/4.1.1_64bit/bin:$(EMSDK)/python/2.7.5.3_64bit:$(EMSDK)/emscripten/1.35.0&lt;br /&gt;
EMSDK_PREFIX=PATH=$(EMSDKPATH):$$$$PATH cmd //c&lt;br /&gt;
CRUNCHME=crunchme-win32.exe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;lt;br/&amp;gt;&lt;br /&gt;
&#039;&#039;&#039;On MAC:&#039;&#039;&#039; &lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
QTBASEDIR=~/Qt QT_ARCH=clang_64 &lt;br /&gt;
QT_TOOLSARCH=clang_64 &lt;br /&gt;
QTVER=5.8 &lt;br /&gt;
QT5ICUVER=54 #deprecated stuff &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;On Linux:&#039;&#039;&#039; &lt;br /&gt;
(tested on Debian 11)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
QT=/usr&lt;br /&gt;
QMAKE=qmake6&lt;br /&gt;
QTLIBS=/lib/x86_64-linux-gnu&lt;br /&gt;
QTPLUGINS=$(QTLIBS)/qt6/plugins&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== 1.12.3 Complete working example Makefile.def for Windows ====&lt;br /&gt;
&lt;br /&gt;
Here is a working example, you will have to change the filename details to match your setup:&lt;br /&gt;
&lt;br /&gt;
[[Example Makefile.def file|example Makefile.def file]].&lt;br /&gt;
&lt;br /&gt;
==== 1.12.4 Fetch additional repositories ====&lt;br /&gt;
&lt;br /&gt;
Go into just cloned gideros source folder and run make prep.repo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    cd gideros&lt;br /&gt;
    make -f scripts/Makefile.gid prep.repo &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
If you intend to build the studio, you&#039;ll need scintilla and Lexilla libraries. Compile them now with:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
    make -f scripts/Makefile.gid qlexilla&lt;br /&gt;
    make -f scripts/Makefile.gid qscintilla&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
== 2. Building ==&lt;br /&gt;
&lt;br /&gt;
If you have all dependencies in place for all targets, you can build everything at once via MSYS2 or Terminal with:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 2.1 Compilation on PC :===&lt;br /&gt;
&lt;br /&gt;
Open MSYS2 shell (msys2_shell.cmd). Standard compilation is 32 bit so use a 32 bit shell. Make sure you have installed the necessary build tools in MSYS2 using pacman, as detailed in [[#1.2 (PC) Install MSYS2 Console|Install MSYS2 Console]].&lt;br /&gt;
.&lt;br /&gt;
&lt;br /&gt;
Navigate to gideros folder &lt;br /&gt;
 &lt;br /&gt;
==== 2.1.1 Build QT tools : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make –f scripts/Makefile.gid qtapp.install&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
-&amp;gt; files GiderosStudio.exe, GiderosPlayer.exe, GiderosTexturePacker.exe (…) in Build.Win folder &lt;br /&gt;
&lt;br /&gt;
==== 2.1.2 Android: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make –f scripts/Makefile.gid android.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= file GiderosAndroidPlayer.apk in folder Build.Win/Players &lt;br /&gt;
&lt;br /&gt;
==== 2.1.3 winRT: ====&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;If necessary :&#039;&#039;&lt;br /&gt;
Open the solution, gideros/winRT_example/giderosgame.sln in Visual Studio. Check that the SQLite version for Windows and Windows Phone is up to date. Save and close the solution. &lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make –f scripts/Makefile.gid winrt.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= file _bundle.appxupload in folder Build.Win/Players/WinRT&lt;br /&gt;
&lt;br /&gt;
==== 2.1.4 win32: ====&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make –f scripts/Makefile.gid win32.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= files in folder Build.Win/Templates/win32 &lt;br /&gt;
 &lt;br /&gt;
==== 2.1.5 Html5: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make –f scripts/Makefile.gid html5.install&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
-&amp;gt; files in folders Build.Win//Players/Html5 and Build.Win/Templates/Html5&lt;br /&gt;
&lt;br /&gt;
==== 2.1.6 Plugins: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make –f scripts/Makefile.gid bundle.win &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= folder bin and file gplugin in folder Build.Win/All Plugins&lt;br /&gt;
&lt;br /&gt;
==== 2.1.7 To build everything that can be built on Windows ====&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid all&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Then you need to copy all the plugins to the &#039;Build.Win&#039; folder with:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.win&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 2.2 Compilation on Mac :===&lt;br /&gt;
Open Terminal.  &lt;br /&gt;
&lt;br /&gt;
cd to the folder « gideros » &lt;br /&gt;
&lt;br /&gt;
==== 2.2.1 QT : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid qtapp.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= GiderosStudio.exe, GiderosPlayer.exe, GiderosTexturePacker.exe (…) in folder Build.Mac &lt;br /&gt;
&lt;br /&gt;
==== 2.2.2 iOS : ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid ios.install &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= GiderosiOSPlayer.zip in folder Buid.Mac/Players &lt;br /&gt;
&lt;br /&gt;
==== 2.2.3 Plugins: ====&lt;br /&gt;
&amp;lt;pre lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid bundle.mac &lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= folders bin and files gplugin in folder Buid.Mac/All Plugins&lt;br /&gt;
&lt;br /&gt;
------&lt;br /&gt;
&lt;br /&gt;
== 3. Cleaning ==&lt;br /&gt;
&lt;br /&gt;
If you want to reset the build process and start again then you can issue a &#039;clean&#039; command.  To do this type &#039;make -f scripts/Makefile.gid clean&#039;.&lt;br /&gt;
&lt;br /&gt;
eg:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid clean&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Sometimes you need to make a clean a particular build.  To do this type &#039;make -f scripts/Makefile.gid &#039; followed by something like &#039;html5&#039; then &#039;.clean&#039;.&lt;br /&gt;
&lt;br /&gt;
eg:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
make -f scripts/Makefile.gid html5.clean&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;/div&gt;</summary>
		<author><name>Hgy29</name></author>
	</entry>
</feed>