Cocos2d-x之Director

|   版权声明：本文为博主原创文章，未经博主允许不得转载。

Director类简介

在Cocos2d-x-3.x引擎中，采用节点树形结构来管理游戏对象，一个游戏可以划分为不同的场景，一个场景又可以分为不同的层，一个层又可以拥有任意个可见的游戏节点（即对象，游戏中基本上所有的类都派生于节点类Node）。可以执行Action来修改游戏节点的属性，使其移动、旋转、放大、缩小等等。每一个时刻都有一个场景在独立运行，通过切换不同的场景来完成一个游戏流程，游戏流程的管理由Director来执行，其基本框架类图如下：

                

　　一款游戏好比一部电影，只是游戏具有更强的交互性，不过它们的基本原理是一致的。所以在Cocos2dx中把统筹游戏大局的类抽象为导演（Director），Director是整个cocos2dx引擎的核心，是整个游戏的导航仪，游戏中的一些常用操作就是由Director来控制的，比如OpenGL ES的初始化，场景的转换，游戏暂停继续的控制，世界坐标和GL坐标之间的切换，对节点（游戏元素）的控制等，还有一些游戏数据的保存调用，屏幕尺寸的获取等都要由Director类来管理控制的。因为Director是游戏项目的总导演，会经常调用进行一些控制，所以该Director利用了单件设计模式，也就是项目里取到的director都是同一个。用getInstance() 方法取得Director的实例，具体的API可以参考相关文档，就不做赘述了。

　　Director类是Cocos2D-X游戏引擎的核心，它用来闯将并控制着主屏幕的显示，同时控制场景的显示时间和显示方式。Director类还可以设定游戏呈现方面，包括游戏呈现的窗口，PFS显示，默认帧率上限，纹理颜色为框等；在整个游戏里一般只有一个导演。游戏的开始、结束、暂停都会调用Director类的方法。Director类的主要功能如下：

◆  初始化OpenGL会话

◆  设置OpenGL的一些参数和方式

◆  访问和改变场景以及访问Cocos2D-X的配置细节

◆  访问视图

◆  设置投影和朝向

Director是单例模式，调用Director方法的标准如下：

auto director = Director::getInstance();
director -> 函数名();
或者
Director::getInstance() -> 函数名();

DisplayerLinkDirector继承了Director，是一个自动刷新的导演类。它支持1/60， 1/30， 1/15三种动画帧间隔。

Director类的主要函数：

画红线重要函数的讲解：

getVisibleOrigin：   获得当前窗口的原点坐标

getVisibleSize：  获取可见窗口的大小，返回的是点

getRunningScene： 获得当前正在运行的场景，导演一次只能运行一个场景。

setOpenGLView：      设置绘制所有对象的OpenGL视图

getOpenGLView：      获得绘制所有对象的OpenGL视图

setProjection：      设置OpenGL投影。

getProjection：      获取OpenGL投影。

getWinSize：      获得当前窗口的大小，经常根据返回的窗口尺寸，定位其他节点位置（点坐标）

convertToGL：     将屏幕坐标转换为一个OpenGL坐标。 对于将(多点)触摸坐标转换为当前布局(横向或纵向)很有用。

convertToUI：     转换一个OpenGL坐标到屏幕坐标。 对于比如glScissor调用将node点转换到窗口点很有用。

stopAnimation：      停止动画。不进行绘制。主循环不会再被触发。 如果你不想暂停动画，请调用            [pause]。

startAnimation：  主循环触发一次。 只有之前调用过stopAnimation，才能调用这个函数。不调用这个函数来开始主循环。请调用runWithScene来开始主循环。

end：         结束场景，同时退出应用

下面这几个函数见cocos2d-x引擎框架那里

 runWithScene：    启动游戏，并运行scene场景。这个方法在主程序启动时第一次启动主场景时调用

 popScene：           释放当前场景，再从代执行场景栈中弹出栈顶的场景，并将其设置为当前运行场景。如果栈空，则直接结束应用。

 pushScene:           将当前运行中的场景暂停并压入到带执行场景栈中去，再将传入的scene设置为当前运行场景。

 replaceScene：      直接使用传入的scene替换当前场景来切换画面，当前场景将被释放

 pause：                 暂停当前运行场景中的所有计时器和动作，场景任会显示在屏幕上

 resume：               恢复当前运行场景中被暂停的计时器和动作

导演类的使用代码：

 // on "init" you need to initialize your instance
 bool HelloWorld::init()
 {
 //////////////////////////////
 // 1. super init first
 if ( !Layer::init() )
 {
 return false;
 }

 Size visibleSize = Director::getInstance()->getVisibleSize();
 Vec2 origin = Director::getInstance()->getVisibleOrigin();

 /////////余下部分省略

 return true;
 }

 void HelloWorld::menuCloseCallback(Ref* pSender) //回调函数的功能实现
 {
 Director::getInstance()->end();

 #if (CC_TARGET_PLATFORM == CC_PLATFORM_IOS)
 exit();
 #endif
 }

 bool AppDelegate::applicationDidFinishLaunching() {
 // initialize director
 auto director = Director::getInstance();
 auto glview = director->getOpenGLView();
 if(!glview) {
 #if (CC_TARGET_PLATFORM == CC_PLATFORM_WIN32) || (CC_TARGET_PLATFORM == CC_PLATFORM_MAC) || (CC_TARGET_PLATFORM == CC_PLATFORM_LINUX)
 glview = GLViewImpl::createWithRect("MyGame01", Rect(, , designResolutionSize.width, designResolutionSize.height));
 #else
 glview = GLViewImpl::create("MyGame01");
 #endif
 director->setOpenGLView(glview);
 }

 // turn on display FPS
 director->setDisplayStats(true);

 // set FPS. the default value is 1.0/60 if you don't call this
 director->setAnimationInterval(1.0 / );

 // Set the design resolution
 glview->setDesignResolutionSize(designResolutionSize.width, designResolutionSize.height, ResolutionPolicy::NO_BORDER);
 Size frameSize = glview->getFrameSize();
 // if the frame's height is larger than the height of medium size.
 if (frameSize.height > mediumResolutionSize.height)
 {
 director->setContentScaleFactor(MIN(largeResolutionSize.height/designResolutionSize.height, largeResolutionSize.width/designResolutionSize.width));
 }
 // if the frame's height is larger than the height of small size.
 else if (frameSize.height > smallResolutionSize.height)
 {
 director->setContentScaleFactor(MIN(mediumResolutionSize.height/designResolutionSize.height, mediumResolutionSize.width/designResolutionSize.width));
 }
 // if the frame's height is smaller than the height of medium size.
 else
 {
 director->setContentScaleFactor(MIN(smallResolutionSize.height/designResolutionSize.height, smallResolutionSize.width/designResolutionSize.width));
 }

 register_all_packages();

 // create a scene. it's an autorelease object
 auto scene = MyGame::createScene();

 // run
 director->runWithScene(scene);

 return true;
 }

 // This function will be called when the app is inactive. When comes a phone call,it's be invoked too
 void AppDelegate::applicationDidEnterBackground() {
 Director::getInstance()->stopAnimation();

 // if you use SimpleAudioEngine, it must be pause
 // SimpleAudioEngine::getInstance()->pauseBackgroundMusic();
 }

 // this function will be called when the app is active again
 void AppDelegate::applicationWillEnterForeground() {
 Director::getInstance()->startAnimation();

 // if you use SimpleAudioEngine, it must resume here
 // SimpleAudioEngine::getInstance()->resumeBackgroundMusic();
 }