Aurélien Vivet
ee563fdb4e
- Position: a "Z position" action and condition for 3D objects, an optional Z position in the position and center position actions (left unchanged when empty) and in the object creation actions (0 by default), ignored for 2D objects. - Size: an optional depth in the size action, left unchanged when empty and ignored for 2D objects. - Rotation: an action changing the X, Y and Z rotations at once, a Z rotation action and condition for 3D objects (their angle), and turns around the local X, Y and Z axes of the object, next to the turns around the global axes. - Base object instructions can require a capability (like the 3D one): they are skipped by the code generation for objects without it. - The position, size, scale and rotation actions and conditions are grouped (Position, Center, Size, Scale, Rotation, Turn around local/global axis) and named after their axis. The expressions keep their name, description and group.
GDevelop.js
These are the bindings of GDevelop core classes to WebAssembly+JavaScript. This allows GDevelop Core libraries to run in a browser or on Node.js.
How to build
👋 Usually, if you're working on the GDevelop editor or extensions in JavaScript, you don't need to rebuild GDevelop.js. If you want to make changes in C++ extensions or classes, read this section.
-
Prerequisite tools installed:
- CMake 3.17+ (3.5+ should work on Linux/macOS). On macOS, you can install it via Homebrew (recommended for Apple M1 Architectures).
- Node.js. (We recommend using nvm to be able to switch between Node versions easily).
- Python (via pyenv for versions management).
-
Install Emscripten version
3.1.21, as explained below or on the Emscripten installation instructions:git clone https://github.com/emscripten-core/emsdk/ cd emsdk git pull ./emsdk install 3.1.21 ./emsdk activate 3.1.21 # On Windows, also install an additional Python package: pip install setuptools -
Whenever you try to build GDevelop.js in the future, you will have to load the emsdk environement into your terminal window again by running:
Linux/macOS Windows (Powershell) Windows (cmd.exe) source ./emsdk_env.sh./emsdk_env.ps1./emsdk_env.bat -
With the emscripten environement loaded into your terminal, launch the build from GDevelop.js folder:
cd GDevelop.js npm install # Only the first time. npm run build # After any C++ changes.⏱ The linking (last step) of the build can be made a few seconds faster, useful for development:
npm run build -- --variant=dev. -
You can then launch GDevelop 5 that will use your build of GDevelop.js:
cd .. cd newIDE/app npm install npm start
More information in GDevelop 5 README.
Tests
npm test
Debugging
You can build the library with various level of debugging and memory checks.
npm run build -- --variant=debug # Build with debugging information (useful for stacktraces)
npm run build -- --variant=debug-assertions # Build with assertions and "SAFE_HEAP=1", useful to find memory bugs.
npm run build -- --variant=debug-sanitizers # Build with memory sanitizers. Will be very slow.
It's then recommended to run the tests (npm test) to check if there are any obvious memory bugs found.
About the internal steps of compilation
The npm build task:
- Creates
Binaries/embuilddirectory, - Launches CMake inside to compile GDevelop with emconfigure to use Emscripten toolchain,
- Updates the glue.cpp and glue.js from Bindings.idl using Emscripten WebIDL Binder,
- Launches the compilation with
make(orninjaon Windows with CMake 3.17+) (you can also compile using MinGW-32 usingnpm run build-with-MinGW).
See the CMakeLists.txt for the arguments passed to the Emscripten linker. For instance, if you want to see the function names in stacks or for profiling, the compilation flags can be changed.
Documentation
- The file Bindings.idl describes all the classes available in GDevelop.js.
- Refer to GDevelop documentation for detailed documentation of the original C++ classes.