class GLView : public cocos2d::CCEGLViewProtocol, public QGLWidget
{
// using glew as cocos2d-x using it.
public:

    virtual void    end() = 0;
    virtual bool    isOpenGLReady() = 0;
    virtual void    swapBuffers() = 0;
    virtual void    setIMEKeyboardState(bool bOpen) = 0;
    
};

class Application : public cocos2d::CCApplicationProtocol, public QApplication
{
// main loop..
public:

   virtual void setAnimationInterval(double interval) = 0;
   virtual ccLanguageType getCurrentLanguage() = 0;
   virtual TargetPlatform getTargetPlatform() = 0;
   
   void run();
};

class AppDelegate : public Application
{

};

// GLView w;
// CCDirector->setOpenGLView(&w);
// AppDelegate app;
// app->run();

[quick]:https://github.com/dualface/quick-cocos2d-x
[Qt]:http://qt-project.org/


Quick-cocos2d-x
=======
quick-cocos2d-x is a \*quick\* framework, based cocos2d-x. Make mobile games in Lua. Code Less, Play More!

quick-cocos2d-x 是一个可以让您觉得“爽快”的 cocos2d-x 的扩展版。基于 cocos2d-x，完全的跨平台能力、优异的性能和可靠性。而 quick-cocos2d-x 在这一切的基础上，添加了完善的 Lua 脚本语言支持，让开发者可以使用 Lua 这种简单易用的脚本语言完成商业品质的移动游戏。

> [cocos2d-x](http://www.cocos2d-x.org) is a multi-platform 2D game engine in C++, based on cocos2d-iphone and licensed under MIT. Now this engine has been expanded to iOS, Android, Bada, BlackBerry, Marmalade and desktop operating systems like Linux, WindowsXP & Windows7.

<br />

## Why quick-cocos2d-x

QUICK = SUCCESS !

-   **No risk**: cocos2d-x's Lua support already exists two years, mature, reliable, the choice of large companies.

-   **Full-featured framework**: Write the entire game using Lua, no C++ requirements.

-   **Native extensions**: Integration of third-party components, including Mobile-Pay, Ad, Analysis. Lua-Objective-C and Lua-Java bridge make life easy.

-   **Enhanced Simulator**: Run the game from any directory, multiple resolution switching, debug console.

-   **100% FREE**: cocos2d-x, Lua, quick-cocos2d-x all is Open-Sources project. licensed under MIT.

在这个“以快致胜”的时代，生产力很大程度上决定了成败！

-   **Lua 是成熟、无风险的选择**: cocos2d-x 对 Lua 的支持已经很成熟，国内外多家大型开发商都在使用 cocos2d-x + Lua 开发游戏。而且 Lua 在游戏领域已经有十多年的实践使用，被各种大型端游所应用。所以可以找到各种 Lua 的开源项目来进一步降低开发成本。

-   **低门槛、高效率**: Lua 简单易用，了解任何一种语言的开发者都可以在一周内掌握。而且 quick-cocos2d-x 提供了一个全功能的，基于 Lua 语言的高层开发框架。这个框架可以极大程度降低游戏开发的门槛并提高开发效率。一个没有任何 C++ 知识的团队也能创建商业品质的移动游戏。

-   **出色的框架设计**: quick-cocos2d-x 由具备多年框架和 API 设计经验的资深开发者创建。之前我们创建的 FleaPHP、QeePHP 都是国内顶尖的 PHP 开发框架之一。今时今日，我们将多年来积累的经验带到了移动领域，为移动游戏开发提供了一流质量的开发框架支持。

-   **无痛升级**: 高层开发框架的引入，统一了底层 cocos2d-x 的 API，解决了 cocos2d-x 升级改进时对游戏开发和维护带来的影响。团队不再需要纠结是否升级，没有任何痛苦就可以获得最新版 cocos2d-x 带来的好处。quick-cocos2d-x 将会紧跟 cocos2d-x 的版本发布，并且尽力保证高层框架的 API 不发生破坏兼容性的变化。

-   **无限的扩展能力**: quick-cocos2d-x 准备了多种扩展，让开发者可以用 C++/Java/Objective-C 语言开发与设备操作系统、第三方平台相关的功能，并方便的集成到 Lua 脚本中。而且 quick-cocos2d-x 还附带了预先开发完成的第三方库，可以为游戏添加支付、分析、广告等服务。随着时间的流逝，这些扩展插件还在不断增加，并且全部以开源形式发布。

-   **增强的开发环境**: 在 Windows 和 Mac 环境下，quick-cocos2d-x 提供了更完善的模拟器，开发者只要一个执行文件就可以开始游戏的开发和测试。

-   **最快的脚本引擎**: Lua 是“最快”的脚本语言之一，而 quick-cocos2d-x 集成了 LuaJIT，在支持 JIT 的设备上，可以将 Lua 脚本编译为机器码执行，性能无以伦比。

-   **100% 开源**: cocos2d-x、Lua，以及 quick-cocos2d-x 都是 100% 开源的项目。这意味着更低的成本、自由修改的权利，以及快速发展的技术。

<br />


## Get Started

1.  Download quick-cocos2d-x-kickstart.zip

    download link: Coming very soon.

2.  Open LuaHostWin32.exe or LuaHostMac.app

    Select menu "File->Open Project", choose directory samples/CoinFlip/. Enjoy it !

<br />


## Test samples

Try samples/CoinFlip/proj.ios

<br />


## Create your project

Create project folder, add files:

-   scripts/config.lua:

~~~ lua
-- 0 - disable debug info, 1 - less debug info, 2 - verbose debug info
DEBUG = 2

-- design resolution, landscape
CONFIG_SCREEN_WIDTH  = 960
CONFIG_SCREEN_HEIGHT = 640

-- auto scale mode
CONFIG_SCREEN_AUTOSCALE = "FIXED_HEIGHT"
~~~

-   scripts/main.lua

~~~ lua
-- for CCLuaEngine
function __G__TRACKBACK__(errorMessage)
    CCLuaLog("----------------------------------------")
    CCLuaLog("LUA ERROR: "..tostring(errorMessage).."\n")
    CCLuaLog(debug.traceback("", 2))
    CCLuaLog("----------------------------------------")
end

xpcall(function()
    CCFileUtils:sharedFileUtils():addSearchResolutionsOrder("res")
    
    local MenuScene = require("scenes.MenuScene")
    display.replaceScene(MenuScene.new())
end, __G__TRACKBACK__)
~~~

-   scripts/scenes/MenuScene.lua:

~~~ lua
local MenuScene = class("MenuScene", function()
    return display.newScene("MenuScene")
end)

function MenuScene:ctor()
    local label = ui.newTTFLabel{
        text = "Hello, World",
        font = 32
    }
    label:setPosition(display.cx, display.cy) -- place label center of screen
    self:addChild(label)
end
~~~

<br />

## Framework main features:

-   display: creates scenes, display objects, animation ...
-   transition: moving, fades, creates animation programing easy ...
-   audio: play background music, effect sounds ...
-   ui: creates button, menu, label ...
-   luaoc: Lua call Objective-C, Objective-C call Lua ...
-   luaj: Lua call Java, Java call Lua ...
-   network: Asynchronous HTTP requests, JSON, check the network status ...

<br />


## Documents

Coming soon.

<br />


## Version of quick-cocos2d-x

当前版本号为 quick-cocos2d-x-2.1.1，基于 cocos2d-2.1beta3-x-2.1.1 发布。

相比官方 cocos2d-x，此版本有以下改进：

-   用 LuaJIT-2.0 替换 Lua-5.1.5
-   整合 CCLuaObjcBridge
-   整合 WebP 图像格式的支持 [X]
-   整合 CCShapeNode [X]
-   整合 TTF 字体渲染模糊修正补丁 [X]
-   为新的 CCFileUtils 完善 Lua 支持 [X]

每当 cocos2d-x 发布一个版本，我们都将发布相同版本号的 quick-cocos2d-x。会以发布版的 cocos2d-x 源码为基础，整合各种针对 Lua 的改进。

每一个版本都会提供下列几种发布文件：

-    精简源代码包，包括 quick-cocos2d-x 和 cocos2d-x 的源代码，但去掉了除 iOS/Android/Windows/Mac 以外平台的支持，以便减少文件包的体积。
-    kickstart 包，提供预编译好的 Windows/Mac 模拟器，以及框架、示例程序源代码。

如果要取得完整的源代码，请使用 git 工具 clone quick-cocos2d-x 仓库。

<br />


## Build from sources

**1. Get sources from Github.com**

    git clone git://github.com/dualface/quick-cocos2d-x.git
    cd quick-cocos2d-x
    git submodule init
    git submodule update

Update sources:

    git pull
    git submodule update

<br />

**2. Open Xcode Perferences, add Source Trees:**

![Add Source Trees](http://dualface.github.com/quick-cocos2d-x/images/AddSourceTrees.png)

<br />

**3. Open samples/CoinFlip/proj.ios project, try it!**

**4. Read documents**

API Documents: [http://dualface.github.com/quick-cocos2d-x/docs/framework/index.html](http://dualface.github.com/quick-cocos2d-x/docs/framework/index.html)

<br />


## Changelog

<br />