Skip to content

Is-Daouda/is-Engine

BranchesTags

Repository files navigation

header

is::Engine (Infinity Solutions::Engine) 4.0.0

Open source C++ framework which uses the mechanisms of SFML 2 and which also allows to develop with several libraries at the same time (SDL 2, Emscripten) in order to easily export your games / applications on the Nintendo Switch, Web (HTML 5), Mobile and PC (Windows, Linux, macOS).

Contents

SFML logo SDL Web Box2D Logo Tiled Logo Admob Logo Tiny File Dialog VS logo

Features

What's new in this version

  • Nintendo Switch Port
  • Bug Fixes

Extras

  • Here is a Web Game : Arkanoid created thanks to the game engine tutorial.
    It's a Web Game so it's playable on PC and mobile.

Image

  • The engine comes with a Demo (2D Platform Game) that uses only the functions of the engine, in order to show you its power and how to use it. Now imagine what you can do when you use Box 2D and the other tools!

Image

  • Example Pack that show how to use the various features of the game engine.

Game Engine User Guide and Youtube Tutorial

Example of a project created with the engine

Hello Scene Example

Here is an example code of a Scene (the place where the game objects come to life). In less than 50 lines of code, the engine allows to:

  • Change the language of the game (English / French)
  • Display an RPG type message with interaction
  • Animate an object with the possibility of interacting with it (by clicking / touching it)
  • Load resources (Textures, Music)
  • Play music
  • Display a background that scrolls vertically and horizontally with a speed
  • Manages the display depth of each object
  • Automatically manages the game window (closing confirmation, events, ...)
  • Change the background color of the window (scene color)
class HelloScene : public is::GameDisplay {
public:
    HelloScene(is::GameSystemExtended &gameSysExt):
        GameDisplay(gameSysExt, sf::Color::White /* => scene color*/) {}

    void loadResources() {
        m_gameSysExt.m_gameLanguage = is::lang::ENGLISH; // set default game language

        // uncomment to change English language in French
        // m_gameSysExt.m_gameLanguage = is::lang::FRANCAIS;

        // load font and texture
        GameDisplay::loadParentResources(); // allows to load system resource (very important never forgot to call him)
        GRMaddTexture("hello_world", is::GameConfig::SPRITES_DIR + "hello_world.png");
        auto &texBg = GRMaddTexture("background", is::GameConfig::TILES_DIR + "background.png");
        auto &texDialog = GRMaddTexture("dialog_box", is::GameConfig::GUI_DIR + "dialog_box.png");

        // add a background to the position x = 0, y = 0 which will fill the scene and which will be scrolled (scrolling speed = 0.5)
        SDMaddSceneObject(std::make_shared<is::Background>(texBg, 0.f, 0.f, this, 0.5f, -0.5f, false, false));

        // add an object at position x = 0, y = 0 which will be updated and displayed in the scene
        SDMaddSceneObject(std::make_shared<HelloWorld>(0.f, 0.f, this));

        // add RPG style game dialog
        auto gameDialog = std::make_shared<is::GameDialog>(texDialog, GRMgetFont("font_msg"), this);
        gameDialog->setDepth(-2); // the display depth (make it appear on all objects. The object with the smallest value appears on the others)
        gameDialog->setDialog(is::GameDialog::DialogIndex::DIALOG_HELLO); // set the corresponding dialog (See GameDialog.h and GameLanguage.h for more details on creating a message for dialogue)
        SDMaddSceneObject(gameDialog);

        GSMaddSound("game_music", is::GameConfig::MUSIC_DIR + "game_music.wav"); // add music
        GSMplaySound("game_music"); // play music
    }
};

Prerequisites

How to use is::Engine with the different development tools:

switch Nintendo Switch

This project uses the template of carstene1ns.

1. Prerequisites

  • DevkitPro with MSYS2

danger Very important

  • All your source files (only .cpp or .c) must be located in the root of the cpp folder otherwise the compiler will not find them!
  • The Switch uses the same touch functions as Android.
  • The engine has been configured so that you can use the PC functions keyIsPressed(is::GameConfig::KEY_UP) or keyIsPressed(is::GameConfig::KEY_A), etc. on the Switch.

2. Installation

Windows
  1. Download devkitPro and install it in C:/devkitPro/.
  2. During installation:
  • Check "devkitA64" (for Switch)
  • Check "MSYS2 Base System"
  • Check "portlibs" if available
  1. Once installed, open the MSYS2 terminal (C:\devkitPro\msys2\msys2.exe)
  2. Enter these commands in the console to download libraries:
pacman -Syu
pacman -S switch-sdl2 switch-sdl2_image switch-sdl2_mixer switch-sdl2_net switch-sdl2_ttf
  1. Move the is-Engine project to your C:/ (C:/is-Engine).
  2. Run the file copy_assets.cmd so that it transfers your resources which are in the assets folder to romfs (this folder will be created when executing the copy_assets.cmd file) necessary for the compilation.
  3. Enter these commands in the console:
cd c:/is-Engine/app/src/main/
make

If all goes well you will have a main.nro file in the main folder that you can launch via Nintendo Switch emulators (Yuzu, Ryujinx, ...).

Image

Enjoy!

android Android Studio

This project uses the template of Georgik and Lauchmelder23.

1. Prerequisites

  • Android Studio (4.0.1 +)
  • Android SDK and NDK (r20b)

danger Very important

  • On Android SFML games run with SDL library. If you want to use SDL functions in your source code, use the IS_ENGINE_SDL_2 macro.
  • The audio format supported at the moment is .WAV
  • Some SFML functions like: Vertex Array, Render Texture are not yet supported. These additions will be made soon!
  • Your help to improve the engine will be welcome!
  • Please read this.

2. Installation

Windows
  1. Download Android Studio 3.x (recommended version 4.0.1).
  2. Download the Android SDK and install it in C:/Android/SDK.
  3. Download Android NDK android-ndk-r20b-windows-x86_64 and create a folder on your disk as follows C:/Android/NDK then extract the contents of the zip in this folder.
  4. Set the environment variable ANDROID_NDK with the path C:/Android/NDK.
  5. Move the is-Engine project to your C:/ (C:/is-Engine).
  6. Open the is-Engine folder with Android Studio and start the compilation.

If all goes well you will have a Hello World Screen on your Android emulator.

Image

Enjoy!

2. How to replace the package name (com.author.isengine) of the application

  • Follow these steps carefully. A single error and the application will crash wonderfully when launching on emulator / mobile!
  1. Replace this line in the gradle.app file.
  2. Replace this line in the AndroidManifest.xml file.
  3. Replace this line in the SDLActivity.java file.
  4. Replace the abresence com/author/isengine in which is the file SDLActivity.java that you have just modified at the top by yours (example com/yourname/yourgamename).
  5. Replace this part ..._ com_author_isengine _... of line 20 and 23 in the file SDL_android_main.c by yours (example com_yourname_yourgamename).
  6. Replace this part ..._ com_author_isengine _... on the 23 lines of the file SDL_android.c by yours (example com_yourname_yourgamename).
  • I strongly advise you to use the replace function of your text editor (on Notepad++ we use Ctrl + F + Replace option).
  1. Replace this line in the GameConfig.h file.
  • Note that this part is only required if you want to use the game engine data save / load functions.

3. Adding Source Files

4. Application location

  • The application can be found in is-Engine/app/build/outputs/apk.

web Web (HTML 5 - CSS 3)

If you want to make your SFML project compatible with the Web (Be able to run it in a web browser), please watch this video tutorial.
danger Now you can put texts and geometric shapes (Rectangle, Circle) in Outline on the Web (It was not available in the old versions)!

1. Prerequisites

  • Emscripen (1.39.7 +)
  • Python (3.8.1 +)
  • CMake (3.1 +)
  • Java
  • SDL 2 (It is downloaded with the internet connection when executing commands)

2. Installation

Windows
  1. Download Emscripten and install it in C:/emsdk, define its path in the environment variable Path
  2. Download Python after installation, define its path in the environment variable Path
  3. Download CMake after installation, define its path in the environment variable Path
  4. Download Java after installation, define its path in the environment variable Path
  5. Move the is-Engine project to your C:/ (C:/is-Engine).
  6. Execute this command :
cd c:/is-Engine/app/src/main
mkdir bin-web
cd bin-web
emsdk activate latest
emcmake cmake ..
make -j3
python -m http.server
  1. Visit this url localhost:8000 in your Web Browser.

If all goes well you will have a Hello World Screen on your Web Browser.

Image

Enjoy!

3. Adding Source Files

danger Very important

  • is::Engine works on the Web thanks to SDL 2.
  • These libraries: TMXLite, TMXLoader, TinyFileDialog are not supported in the web version of is::Engine.
  • If you want to use SDL functions in your source code, use the IS_ENGINE_SDL_2 macro.
  • Note that some SFML functions like: Vertex Array, Render Texture are not yet supported. These additions will be made soon!

Web Push Notification Web Push Notification

  • If you want to make your SFML project compatible with the Web (Be able to run it in a web browser), please watch this video tutorial.

  • danger
    By default the web push notification has been disabled. Because to make it work you must have an internet connection. In case there is no internet access and it is not well launched, it can prevent the execution of the web program.
    To enable it, please modify these lines in index.html : 7, 23, 108

Installation

  • This shows how to test the push notification. Note that normally to use it, you have to associate it with a database (backend). But here we will use it with the Push Companion site (It will serve as a backend for us!).
  • For more information on Push Notification please see this page.
  1. Web browser (preferably Google Chrome)
  2. Web server for Chrome or your own web server.
  3. Define the Application Server Keys in the main.js file. You can get this keys (We will use the public key) here.
  4. Launch the web or bin-web folder (generate using emscripten) via the web server.
  5. Click on the "Enable Push Messaging" button to activate the sending of Push Notifications. Once done you will have a code (which can be used to send you push notifications).
  6. Go to this site and enter the code in the "Subscription to Send To" text field followed by your message in "Text to Send" text field. Click on the "Send Push Message" button.
  7. If all goes well you will have a push notification followed by the message you sent in the console (development tool) of your browser.

image

Configure the Push Notification

  1. To change the information (title, details, ...) of the Push Notification you must refer to the sw.js file.
  2. To change the Push Notification image files, refer to the images folder.
  3. To change the page that is launched when you click on the notification, refer to the sw.js file.

cmake CMake

1. Prerequisites

  • CMake (3.1 +)

2. Installation

Windows

  1. Compile SFML with CMake to have static libraries and put on C:/ (C:/SFML).
  2. Move the is-Engine project to your C:/ (C:/is-Engine).
  3. Execute this command :
cmake -S "C:/is-Engine" -B "C:/build"
cd build
make

Linux

  1. Install SFML 2.5.1 on your machine.
  2. Move the is-Engine project to /home/user/ (/home/user/is-Engine).
  3. Execute this command :
sudo cmake -S "is-Engine" -B "build"
cd build
sudo make

3. After installation

  • You will have a bin folder in which the engine demo is located.

5. Adding Source Files

vs Visual Studio

1. Installation

Windows

Download Visual Studio Community 2022 here and install it.

2. Opening the project with the IDE:

Windows

Open the file vs-sfml.sln in the location is-Engine/app/src/main/

qt Qt

1. Installation

Windows

  1. Download Qt 5.12.9 MinGW here and install it.
  2. Download this version of SFML already compiled for Qt 5.12.9 and extract it in C:/ (C:/SFML_Qt_MinGW).

2. Opening the project with the IDE:

Windows

  1. Run the file open_qt_creator.bat in the main directory (Make sure you have included the path to the Qt executable in your PATH environment variable).
  2. Or open the file is-Engine.pro in the location is-Engine/app/src/main/qt

3. Executable location

  • The compiler files can be found in is-Engine/app/src/main/bin-Qt.

vsc Visual Studio Code

This project uses the template of andrew-r-king. For more information on this template click here.

1. Prerequisites

Windows

Linux

  • Get SFML 2.5.1 from your distro if it has it, or compile from source.

2. Installation

Windows

  1. Download & Extract SFML 2.5.1 to C:/SFML/ where the bin/lib/include folders are contained within.
  2. Download & Extract MinGW to C:/mingw32/ where the bin/lib/include folders are contained within.

Linux

  1. Ensure the GCC Toolchain is installed (sudo apt install build-essential).
  2. Run sudo apt install libsfml-dev. The SFML version you got will vary depending on the distro. 2.5.1 is included in Ubuntu 19.04 Disco Dingo for example.

3. Opening the project with the IDE:

Windows

  1. Run the file open_vscode.bat in the main directory.

Linux

  1. Execute this command in the main directory:
code -n "./app/src/main"

All

  1. Or open the is-Engine/app/src/main folder with Solution Explorer.

4. Executable location

  • The compiler files can be found in is-Engine/app/src/main/bin-vscode.

cb Code::Blocks

1. Installation

Windows

  1. Download Code::Blocks 20.03 MinGW here and install it.
  2. Download this version of SFML already compiled for Code::Blocks 20.03 and extract it in C:/ (C:/SFML_CB_MinGW).

Linux

  1. Download Code::Blocks 20.03 and install it.
  2. Ensure the GCC Toolchain is installed (sudo apt install build-essential).
  3. Run sudo apt install libsfml-dev. The SFML version you got will vary depending on the distro. 2.5.1 is included in Ubuntu 19.04 Disco Dingo for example.

2. Opening the project with the IDE:

Windows

  1. Run the file open_codeblocks.bat in the main directory (Make sure you have included the path to the Code::Blocks executable in your PATH environment variable).
  2. Or open the file is-Engine-windows.cbp in the location is-Engine/app/src/main

Linux

  1. Execute this command in the main directory:
codeblocks "./app/src/main/is-Engine-linux.cbp"
  1. Or open the file is-Engine-linux.cbp in the location is-Engine/app/src/main.

3. Executable location

  • The compiler files can be found in is-Engine/app/src/main/bin-codeblocks.

cb Develop SFML games with SDL 2

1. Installation

Windows

  1. Download Code::Blocks 20.03 MinGW here and install it.
  2. Download this version of SDL 2 and extract it in C:/ (C:/SDL2).
  3. Put the .dll files which is in the bin folder of SDL2 in the main folder.

Linux

  1. Download Code::Blocks 20.03 and install it.
  2. Ensure the GCC Toolchain is installed (sudo apt install build-essential).
  3. Run sudo apt install libsdl2-2.0-0 libsdl2-gfx-1.0-0 libsdl2-image-2.0-0 libsdl2-mixer-2.0-0 libsdl2-net-2.0-0 libsdl2-ttf-2.0-0 to install all SDL 2 libraries.

2. Opening the project with the IDE:

Windows

  1. Run the file open_codeblocks_sdl.bat in the main directory (Make sure you have included the path to the Code::Blocks executable in your PATH environment variable).
  2. Or open the file is-Engine-windows-SDL2.cbp in the location is-Engine/app/src/main

Linux

  1. Execute this command in the main directory:
codeblocks "./app/src/main/is-Engine-linux-SDL2.cbp"
  1. Or open the file is-Engine-linux-SDL2.cbp in the location is-Engine/app/src/main.

3. Executable location

  • The compiler files can be found in is-Engine/app/src/main/bin-codeblocks.

danger Very important

  • If you want to use SDL functions in your source code, use the IS_ENGINE_SDL_2 macro.
  • Note that some SFML functions like: Vertex Array, Render Texture are not yet supported. These additions will be made soon!

icon Change application icon:

Nintendo Switch

Android

  • To change the icon of the application you must go to the location is-Engine/app/src/main/res replace all the images (PNG) which are in the drawable subfolders.

Web (HTML 5 - CSS 3)

Windows

Linux

Description of the project structure:

header

1. main.cpp file

Contains the entry point of the program, inside there are two instructions :

  • game.play(): Launches the engine rendering loop which allows to manage the introduction screen, main menu, level and game over.
  • game.basicSFMLmain() (disabled by default): Launches the display of a classic SFML window. The implementation is in the basicSFMLmain.cpp file. Very useful if you already have a project under development and you want to associate it with the engine. You can also use it to implement your own components to the engine.

2. app_src folder

Contains the source code of the game. Description of these sub-directories:

  • activity : Contains the Activity class which allows the interaction of the different scenes of the game.
  • config : Contains the GameConfig.h file which allows to define the general parameters of the game. It also contains the file ExtraConfig.h which allows to activate / deactivate certain engine functionality (Engine optimization, SDM, Admob, Main Render Loop, ...).
  • gamesystem_ext : Contains GameSystemExtended a class derived from GameSystem which allows to manipulate game data (save, load, ...).
  • language : Contains the GameLanguage.h file which allows to manage everything related to game languages.
  • levels : Contains game levels and the Level.h file which allows to integrate them into the game.
  • objects : Contains the objects that will be used in the different scenes.
  • scenes : Contains the different scenes of the game (Introduction, Main menu, ...).

3. assets folder

Contains game resource files (music, sound sfx, image, ...)

4. isEngine folder

Contains the source code of the game engine

Special things to know about the engine

is::LibConnect

With the is::LibConnect you can write code for a specific library. Here is how to do it:

sf::Text text;
text.setString(
// on PC (Windows / Linux)
#if define(IS_ENGINE_SFML)    
    "We use SFML 2 library"

// When we develop for the Nintendo Switch   
#elif define(IS_ENGINE_SWITCH)
    "SFML 2 on Switch"

// on Android or when you use SDL to create SFML games on PC (only for Code::Block at the moment)    
#elif define(IS_ENGINE_SDL_2)
    "Run SFML 2 with SDL 2"

// When we develop for the web (HTML 5) with Emscripten    
#elif define(IS_ENGINE_HTML_5)
    "SFML 2 on Web"
#endif
              );

If you have discovered another way to use the game engine, don't hesitate to share it! We will put it in this Special section so that other people can benefit from it!

How to update an is::Engine project

  1. First of all the part of is::Engine that changes most often during updates is the isEngine folder. But it also happens that these files can be modified:
  1. To update your old project with a new version of is::Engine: the files (.h and .cpp) you need to move are in objects and scenes. Note that these folders never change whatever the version!

How to activate the use of Admob?

Coming soon!

Contribute

  • If you want to participate in the development of the project to help me improve the engine, please note that you are welcome! Together we go further!
  • One of the objectives of this project is to create a large community that can work on the engine to allow many people around the world to easily realize their dream games / applications!

Contacts

About

C++, SDL 2 and SFML game engine that allows to create games on Nintendo Switch, Web (HTML 5), Mobile and PC.

linktr.ee/is_daouda

Topics

android html ios qt web html5 cplusplus game-engine cpp css3 sdl sfml webassembly visual-studio-code emscripten code-blocks android-studio tmx nintendo-switch box-2d

Resources

Readme

License

Zlib license
Activity

Stars

206 stars

Watchers

13 watching

Forks

16 forks
Report repository

Releases 1

v3.3.4 Latest
Sep 15, 2021

Packages

No packages published

Languages