GameApi

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 9 Open GitHub ↗

A Library for publishing gltf 3d models in web

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# GameApi Builder and meshpage.org

We proudly present a 3d modelling tool, 3d engine and web site for
displaying 3d models.

Our best feature is gltf rendering and its eventual deployment in web, but our
tools are slightly more flexible than just focusing on gltf area. The software
uses 8 cpus in the following locations:
1) vertex arrays,
2) textures in sprites,
3) url loading,
4) bitmap loading,
5) zip decoding,
6) points,
7) sprites,
8) gltf bitmaps decoding from png/jpeg files

### Android runtime

https://meshpage.org/gameapi_xmas.apk

(given that android security horror prevents changing script.txt file from
  within the apk file, you'll need someone who has full ndk installed and build
  of gameapi near. Thus, if you have designed a script with gameapi builder and
  would want it to work on android, send the codegen script to
  terop@kotiposti.net as email, and I'll install it to apk file and send
  you the resulting apk in return mail.)

### Change your web page
```
<img src="xxx.jpg"/>

You can find the display.html from the generated .zip files.

### Download the repo
  - git clone https://github.com/terop2/GameApi.git

### Dependent packages (ubuntu)
  - apt-get install libsdl2-dev
  - apt-get install libfreetype6-dev
  - apt-get install libsdl2-mixer-dev
  - apt-get install libglew-dev
  - apt-get install curl
  - apt-get install libstdc++0
  - apt-get install libc6
  - apt-get install libgcc-s1
  - apt-get install unzip
  - apt-get install zip
  - apt-get install tar

### Compiling
```
Choose correct directory:
  cd GameApi

To compile (linux):
  make clean     // only in full build
  make -j 8

To compile (emscripten):
 make -f Makefile.LinuxEm clean  // only in full build
 ./emmake.sh EMSCRIPTEN_PATH=path_to_emscripten_emsdk_directory

To compile (windows):
  set_paths_git.bat
  make.bat

Running the software:
  cd editor
  ./a.out

How we normally push our code to hosting space:
  # ./full_deploy.sh
or
  # full_deploy_win32.bat

Android cmdline: (but requires sdl2 and freetype and libcurl compilation)
                 (current status: at least quake_ml[|2|3] are broken.)
  1) SDL2 compilation:
   export ANDROID_NDK=/home/terop/Android/Sdk/ndk/28.0.12674087
   cd androiddeps/SDLBuild[|2|3|4]
   ./cmake.cmd
    make
 2) freetype compilation:
  cd androiddeps/freetype-2.13.3/build
  emacs android_configure.sh
  (should compile to all 4 platforms:
     aarch64-linux-android30-clang++, --host=aarch64-linux-android
     i686-linux-android30-clang++, --host=i686-linux-android
     x86_64-linux-android30-clang++, --host=x86_64-linux-android
     armv7a-linux-androideabi30-clang++, --host=arm-linux-androideabi
     )
  make
 3) libcurl compilation
    git clone https://github.com/Microsoft/vcpkg.git
    ./vcpkg/bootstrap-vcpkg.sh
    ./vcpkg/vcpkg install curl:arm64-android
    ./vcpkg/vcpkg install curl:arm-android
    ./vcpkg/vcpkg install curl:x64-android
    ./vcpkg/vcpkg install curl:x86-android
    (then headers are in ./vcpkg/installed/arm64-android/include)
    (then libs are in ./vcpkg/installed/arm64-android/lib)
 4) Changing paths for sdl2, ndk, sdk and freetype in Makefile.android, cmdline4/build.sh and cmdline4/build_package.sh
 5) Compile package + push it to android device:
  emacs Makefile.android // change ARCH 4 times
  make -f Makefile.android clean
  make -f Makefile.android -j 8
  (cd cmdline4; ./ammake.sh)

```

### Important urls:
  - https://meshpage.org                  (main web site)
  - https://meshpage.org/meshpage_4       (download newest builder tool binaries)
  - https://meshpage.org/view.php         (3d model viewer)
  - https://meshpage.org/gltf_to_zip.php  (gltf to html5 zip converter)
  - https://meshpage.org/meshpage_5       (FAQ)
  
### Deploy Process#1:
 - CREATE: use our technology to create the 3d model display
 - DEPLOY: get a .zip file from gltf_to_zip converter, builder tool(save_deploy) or meshpage.org web site
 - UNZIP: unzip the zip file to a new directory in your hosting space
 - EMBED: use `<iframe src="xxxdir/display.php" width="830" height="630"/>` to embed the 3d model to your html article
 - ENJOY: open the article in web browser via url

### API access:
    - LINK: link to the libGameApi.so or libGameApi.bc library.
    - CALL:
    
      ```
      #include "GameApi.hh"
      tasks_init();

std::string code= "SCRIPT FROM CODEGEN HERE";
      Env e2;
      EveryApi ev(e2);
      ExecuteEnv e;
      ev.mainloop_api.init_window(w_width,w_height,"GameApi", vr_init);
      ev.mainloop_api.set_screen_size(w_width, w_height);
      ev.mainloop_api.set_homepage_url(homepageurl);
      ev.mainloop_api.set_seamless_url(seamless_url);
      ev.shader_api.load_default();
      std::pair<int,std::string> blk = GameApi::execute_codegen(e2, ev, code, e);
      if (blk.second == "RUN") {
      	 RUN r;
    	 r.id = blk.first;
    	 ev.blocker_api.run2(ev,r);
       } else if (blk.second=="OK") {
         BLK b;
         b.id = blk.first;
         ev.blocker_api.run(b);
       } else {
         std::cout << "ERROR: internal error" << std::endl;
       }
       ```

### Deploytool access:
  ```
  cd deploytool
  LD_LIBRARY_PATH=.. ./deploytool --file input_script.txt -o output_zip.zip --homepage=https://meshpage.org/assets/
  ```

### Cmdline access:
  ```
  cd cmdline
  LD_LIBRARY_PATH=.. ./gameapi_cmdline --file input_script.txt
  ```
### ADVANCED -- configuring what parts of the library are included

1) collect all the scripts you want to run with gameapi to script.txt
   (normal linux cat command can create larger script from smaller pieces)

```
   cat script1.txt script2.txt script3.txt >script.txt
  ```

2) use builder tool to generate a header file:
  ```
  cd editor
  ./a.out --deps script.txt
  ```
This --deps option creates ../GameApi_short_defines.hh file.

Then the library needs full recompilation, and you get libGameApi_small.so file, which contains only the parts needed for running the scripts in (1).

### License:

LGPL/GPL

Yours,

GameApi

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README