Skip to content

Simple 2D/3D game library for native C++, strongly inspired by MoaiSDK API structure.

Notifications You must be signed in to change notification settings

kengonakajima/moyai

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

moyai

An experimental simple 2D/3D game engine for native C++, strongly inspired by MoaiSDK API structure.

Moai SDK: https://github.com/moai/moai-dev

Features

  • Rendering
  • 2D sprite + 3D mesh
  • OpenGL 2.0 (ES2), [GLFW https://www.glfw.org/]
  • Image
  • PNG read/write from file (lodepng)
  • dynamic texture
  • Audio
  • Reads any WAV files
  • FMOD based ( https://fmod.com/ )
  • Font
  • FreeType2 based, reads TTF files, multi-byte chars

Compatibility

  • OSX 10.8/10.9
  • Windows7 (VS2012)

Performance target

8K~10K sprites at 60FPS with -O0 on UNIX, -O1 on VC++

Example

All of its class names are from MoaiSDK's, and the order of API calls is also completely same as MoaiSDK's.

Some arguments are modified to achieve even simpler usage.

Sprite basics

To show a sprite on your screen, just:

#include "moyai/client.h"

Moyai *g_moyai;

int main() 
{
  g_moyai = new Moyai();

  Viewport *v = new Viewport();
  v->setSize(1024,768);
  v->setScale(1024,768);

  Layer *lay = new Layer();
  lay->setViewport(v);
  
  Camera *c = new Camera();
  c->setLoc(0,0);
  lay->setCamera©;

  g_moyai->insertLayer(lay);

  Texture *tex = new Texture();
  tex->load("spritesheet.png");

  TileDeck *deck = new TileDeck();
  deck->setTexture(tex);
  deck->setSize( 16,16, 16,16); //16x16 of 16pix x 16pix sprites in a sheet

  Prop2D *p = new Prop2D();
  p->setDeck(deck);
  p->setLoc(100,100);
  p->setIndex(13); // index number in the sprite sheet (top-down, left-right)
  p->setScl(32,32);

  lay->insertProp(p);

  // initialize glfw
  glfwInit();
  glfwOpenWindow(1024,768, 0,0,0,0, 0,0, GLFW_WINDOW );

  while(1) {
    static double last_poll_at = 0;
    double t = now();
    double dt = t - last_poll_at;
  
    g_moyai->poll(dt); // everything happens in 
    g_moyai->renderAll();
    
    last_poll_at = t;
  }
}

3D basics

int main() {
  g_moyai = new Moyai();

  glfwInit();
  glfwOpenWindow( SCRW,SCRH, 8,8,8,8, 8,0, GLFW_WINDOW );
  glfwSetWindowTitle( "demo3d");
  glfwEnable( GLFW_STICKY_KEYS );
  glfwSwapInterval(1); // vsync

  glClearColor(0,0,0,1);
  glEnable(GL_DEPTH_TEST);    
  glEnable(GL_DEPTH_BUFFER_BIT);    
  glDepthMask(true );
  glEnable(GL_CULL_FACE);
  glCullFace(GL_BACK);
    
  Viewport *v = new Viewport();
  v->setSize(1024,768);
  v->setClip3D( 0.01, 100 ); // near and far clip
  
  Camera *cam = new Camera();
  cam->setLoc( Vec3(0,0,10) );
  
  Layer *layer = new Layer();
  layer->setCamera(cam);
  layer->setViewport(v);

  Texture *t = new Texture();
  t->load("wood_surface.png");
  Prop3D *p = new Prop3D();
  p->setMesh(mesh); // prepare mesh before
  p->setTexture(t);
  p->setScl(Vec3(2,2,2));
  p->setLoc(Vec3(1,0,0));
  layer->insertProp(p);

  while(1){
    static double last_poll_at = now();
    double t = now();
    double dt = t - last_poll_at;
    g_moyai->poll(dt);
    g_moyai->renderAll();
    last_poll_at = t;
  }
  
}

Audio

To use sound effects or background music, just use SoundSystem and Sound.

It is simply based on FMOD: stable, small and lightweight.

SoundSystem *ss = new SoundSystem();
Sound *s = ss->newSound( "explode.wav" );
s->play();

Fonts

To use TrueType fonts, just use Font and TextBox. Pass wchar_t string to prepare glyphs in texture buffer. Moyai only supports pre-loaded fonts.

wchar_t charcodes[] = L" !\"#$%&\'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`abcdefghijklmnopqrstuvwxyz{|}~あいうえおぁぃぅぇぉかきくけこがぎぐげごさしすせそざじずぜぞたちつてとだぢづでどなにぬねのはひふへほばびぶべぼぱぴぷぺぽまみむめもやゆよゃゅょらりるれろわをん";    
 
Font *f = new Font();
f->loadFromTTF( "cinecaption227.ttf", charcodes, 12 ); 

TextBox *tb = new TextBox();
tb->setFont(f);
tb->setString("こんにちはABC");

layer->insertProp(tb);

Screen capture

Image *img = new Image();
img->setSize(1024,768);
g_moyai->capture(img);
img->writePNG("captured.png");
delete img;

Build

MacOS X 10.8,10.9,10.10: After installing Xcode and command line tools, just do:

$ git clone https://github.com/kengonakajima/moyai
$ cd moyai
$ make
$ ./demo2d
$ ./demo3d

Windows 7/8/8.1 VisualStudio 2012/2013 :

  1. git clone https://github.com/kengonakajima/moyai or use Github For Windows from github.com
  2. Start from demowin/demowin.sln
  3. Build a project "demowin"
  4. Run(Debug) the program

An example screenshot of a program "demo2d" :

Screenshot of "demo3d" :

Classes

List of classes defined in moyai.h :

  • Basic types

    • Vec2
    • Color
    • Moyai
    • Layer
    • Viewport
    • Camera
    • Prop2D : simple sprite
    • Prop3D
  • Rendering and Graphics

    • Image : image in memory
    • Texture : opengl texture
    • TileDeck : sprite sheet
    • ColorReplacerShader : replace pixel color of given texture
    • Grid : m x n grid
    • CharGrid : for simple ascii bitmap fonts
    • Prim : draw lines and rectangles
  • Text and fonts

    • Font : truetype font
    • TextBox
  • Animation

    • AnimCurve
    • Animation
  • Audio

    • SoundSystem
    • Sound

License notes

See LICNSE.txt for Moyai itself.

  • Graphics resources are from Oryx Design Lab: https://oryxdesignlab.com/
  • Music from: Erik Satie Gymnopedie no.1
  • lodepng image loader : Copyright (c) 2005-2013 Lode Vandevenne
  • zlib : (C) 1995-2012 Jean-loup Gailly and Mark Adler
  • bzip2 : copyright (C) 1996-2010 Julian R Seward
  • FMOD : FMOD NON-COMMERCIAL LICENSE
  • FreeType : Copyright 1996-2002, 2006 by David Turner, Robert Wilhelm, and Werner Lemberg
  • freetype-gl : Copyright 2011,2012 Nicolas P. Rougier. All rights reserved.
  • GLFW Copyright (c) 2002-2006 Marcus Geelnard, 2006-2010 Camilla Berglund [email protected]
  • SOIL image loader : 2007 Jonathan Dummer
  • lz4 : 2013 Yann Collet

About

Simple 2D/3D game library for native C++, strongly inspired by MoaiSDK API structure.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published