CCDirector--Cocos2D-Swift v3.3
CCDirector Class Reference
| Inherits from | CC_VIEWCONTROLLER |
| Declared in | CCDirector.h |
Overview
The director creates and handles the main Window and the Cocos2D view. It also presents Scenes and initiates scene updates and drawing.
director创建和处理主窗口和Cocos2D的view，同时显示Scenes和初始化scene的更新和绘制。
CCDirector inherits from CC_VIEWCONTROLLER which is equivalent to UIViewController on iOS, and NSObject on OS X and Android.
CCDiretor继承自CC_VIEWCONTROLLER，相当于iOs的UIViewController
Since the CCDirector is a singleton, the standard way to use its methods and properties is:
[[CCDirector sharedDirector] methodName];[CCDirector sharedDirector].aProperty;
因为CCDirector是单例模式，所以表示的使用方法和属性为：
[[CCDirector sharedDirector] methodName];
[[CCDirector sharedDirector].aProperty;
The CCDirector is responsible for:
- initializing the OpenGL ES / Metal context
- setting the pixel format (default on is RGB565)
- setting the buffer depth (default one is 0-bit)
- setting the projection (default one is 3D)
CCDirector负责：
初始化OPENGL ES/Metal内容
设置像素格式（默认为RGB565）
设置缓存深度（默认为0bit）
设置投影（在3D中默认是1）
The CCDirector also sets the default OpenGL context:
GL_TEXTURE_2Dis enabledGL_VERTEX_ARRAYis enabledGL_COLOR_ARRAYis enabledGL_TEXTURE_COORD_ARRAYis enabled
Tasks
Singleton Accessor
Accessing OpenGL Thread
runningThreadproperty
View Scale
contentScaleFactorpropertyUIScaleFactorpropertydesignSizeproperty
Working with View and Projection
viewpropertyprojectionpropertyprojectionMatrixpropertyglobalShaderUniformspropertydisplayStatsproperty– viewSize– viewSizeInPixels– reshapeProjection:– convertToGL:– convertToUI:
Presenting Scenes
runningSceneproperty– presentScene:– presentScene:withTransition:– pushScene:– popScene– popToRootScene– popToRootSceneWithTransition:– pushScene:withTransition:– popSceneWithTransition:
Animating the Active Scene
animationIntervalpropertyfixedUpdateIntervalpropertynextDeltaTimeZeropropertypausedpropertyanimatingpropertytotalFramespropertysecondsPerFrameproperty– end– pause– resume– stopAnimation– startAnimation
Purging Caches
Properties
UIScaleFactor
UI scaling factor, default value is 1. Positions and content sizes are scale by this factor if the position type is set to scale.
@property (nonatomic, readwrite, assign) float UIScaleFactorSee Also
Declared In
CCDirector.hanimating
Whether or not the Director is active (animating).
@property (nonatomic, readonly, getter=isAnimating) BOOL animatingDeclared In
CCDirector.hanimationInterval
The animation interval is the time per frame. Typically specified as 1.0 / 60.0 where the latter number defines the framerate. The lowest value is 0.0166 (1/60).
@property (nonatomic, readwrite, assign) CCTime animationIntervalSee Also
Declared In
CCDirector.hcontentScaleFactor
Content scaling factor. Sets the ratio of points to pixels. Default value is initalized from the content scale of the GL view used by the director.
@property (nonatomic, assign) CGFloat contentScaleFactorDeclared In
CCDirector.hdesignSize
User definable value that is used for default contentSizes of many node types (CCScene, CCNodeColor, etc). Defaults to the view size.
@property (nonatomic, assign) CGSize designSizeDeclared In
CCDirector.hdisplayStats
Whether or not to display statistics in the view’s lower left corner. From top to bottom the numbers are: number of draw calls, time per frame (in seconds), framerate (average over most recent frames).
@property (nonatomic, readwrite, assign) BOOL displayStatsDeclared In
CCDirector.hfixedUpdateInterval
The fixed animation interval is used to run “fixed updates” at a fixed rate, independently of the framerate. Used primarly by the physics engine.
@property (nonatomic, readwrite, assign) CCTime fixedUpdateIntervalSee Also
Declared In
CCDirector.hglobalShaderUniforms
The current global shader values values.
@property (nonatomic, readonly) NSMutableDictionary *globalShaderUniformsDeclared In
CCDirector.hnextDeltaTimeZero
whether or not the next delta time will be zero
@property (nonatomic, readwrite, assign, getter=isNextDeltaTimeZero) BOOL nextDeltaTimeZeroDeclared In
CCDirector.hpaused
Whether or not the Director is paused.
@property (nonatomic, readonly, getter=isPaused) BOOL pausedSee Also
Declared In
CCDirector.hprojection
Sets an OpenGL projection
@property (nonatomic, readwrite) CCDirectorProjection projectionDeclared In
CCDirector.hprojectionMatrix
Projection matrix used for rendering.
@property (nonatomic, readonly) GLKMatrix4 projectionMatrixSee Also
Declared In
CCDirector.hrunningScene
The current running Scene. Director can only run one Scene at a time.
@property (nonatomic, readonly) CCScene *runningSceneSee Also
Declared In
CCDirector.hrunningThread
If you want to run any Cocos2D task, run it in this thread. Any task that modifies Cocos2D’s OpenGL state must be executed on this thread due to OpenGL state changes only being allowed on the OpenGL thread.
@property (weak, readonly, nonatomic) NSThread *runningThreadReturn Value
The Cocos2D thread, typically this will be the main thread.
Declared In
CCDirector.hsecondsPerFrame
Time it took to render the most recent frames, in seconds per frame.
@property (nonatomic, readonly) CCTime secondsPerFrameDeclared In
CCDirector.htotalFrames
How many frames were called since the director started
@property (nonatomic, readonly) NSUInteger totalFramesDeclared In
CCDirector.hInstance Methods
convertToGL:
Converts a UIKit coordinate to an OpenGL coordinate.
- (CGPoint)convertToGL:(CGPoint)pParameters
- p
-
Point to convert.
Return Value
Converted point.
Discussion
Useful to convert (multi) touch coordinates to the current layout (portrait or landscape).
Declared In
CCDirector.hconvertToUI:
Converts an OpenGL coordinate to a UIKit coordinate.
- (CGPoint)convertToUI:(CGPoint)pParameters
- p
-
Point to convert.
Return Value
Converted point.
Discussion
Useful to convert node points to window points for calls such as glScissor.
Declared In
CCDirector.hend
Ends the execution, releases the running scene. It doesn’t remove the view from the view hierarchy. You have to do it manually.
- (void)endDeclared In
CCDirector.hpause
Pauses the running scene. All scheduled timers and actions will be paused. When paused, the director refreshes the screen at a very low framerate (4 fps) to conserve battery power.
- (void)pauseSee Also
Declared In
CCDirector.hpopScene
Pops out a scene from the queue. This scene will replace the running one. The running scene will be deleted. If there are no more scenes in the stack the execution is terminated.
- (void)popSceneDiscussion
Warning: ONLY call it if there is a running scene.
Declared In
CCDirector.hpopSceneWithTransition:
Replaces the running scene, with the last scene pushed to the stack, using a transition
- (void)popSceneWithTransition:(CCTransition *)transitionParameters
- transition
-
The transition to use
See Also
Declared In
CCDirector.hpopToRootScene
Pops out all scenes from the queue until the root scene in the queue.
- (void)popToRootSceneDiscussion
This scene will replace the running one. Internally it will call popToSceneStackLevel:1
See Also
Declared In
CCDirector.hpopToRootSceneWithTransition:
Pops out all scenes from the queue until the root scene in the queue, using a transition
- (void)popToRootSceneWithTransition:(CCTransition *)transitionParameters
- transition
-
The transition to play.
Discussion
This scene will replace the running one. Internally it will call popToRootScene
See Also
Declared In
CCDirector.hpresentScene:
Presents a new scene.
- (void)presentScene:(CCScene *)sceneParameters
- scene
-
Scene to start.
Discussion
If no scene is currently running, the scene will be started.
If another scene is currently running, this scene will be stopped, and the new scene started.
See Also
Declared In
CCDirector.hpresentScene:withTransition:
Presents a new scene, with a transition.
呈现一个新的scene，加入变化过程。
- (void)presentScene:(CCScene *)scene withTransition:(CCTransition *)transitionParameters
- scene
-
Scene to start.
- transition
-
Transition to use. Can be nil.
Discussion
If no scene is currently running, the new scene will be started without a transition.
If another scene is currently running, this scene will be stopped, and the new scene started, according to the provided transition.
See Also
Declared In
CCDirector.hpurgeCachedData
Removes all the cocos2d resources that have been previously loaded and automatically cached, textures for instance.
- (void)purgeCachedDataDeclared In
CCDirector.hpushScene:
Suspends the execution of the running scene, pushing it on the stack of suspended scenes.
- (void)pushScene:(CCScene *)sceneParameters
- scene
-
New scene to start.
Discussion
The new scene will be executed, the previous scene remains in memory. Try to avoid big stacks of pushed scenes to reduce memory allocation.
Warning: ONLY call it if there is already a running scene.
Declared In
CCDirector.hpushScene:withTransition:
Pushes the running scene onto the scene stack, and presents the incoming scene, using a transition
- (void)pushScene:(CCScene *)scene withTransition:(CCTransition *)transitionParameters
- scene
-
The scene to present
- transition
-
The transition to use
See Also
Declared In
CCDirector.hreshapeProjection:
Changes the projection size.
- (void)reshapeProjection:(CGSize)newViewSizeParameters
- newViewSize
-
New projection size.
Declared In
CCDirector.hresume
Resumes the paused scene and its scheduled timers and actions. The “delta time” will be set to 0 as if the game wasn’t paused.
- (void)resumeSee Also
Declared In
CCDirector.hstartAnimation
Begins drawing the screen. Scheduled timers and actions will run.
- (void)startAnimationDiscussion
Warning: Don’t call this function to start the main loop. To run the main loop call presentScene:
See Also
Declared In
CCDirector.hstopAnimation
Stops the animation. All scheduled updates and actions are effectively paused.
- (void)stopAnimationDiscussion
When not animating, the director doesn’t redraw the view at all. It is best to hide the view when not animating the director. If you need to keep showing the director’s view use pause instead.
See Also
Declared In
CCDirector.hviewSize
The size of the view in points.
- (CGSize)viewSizeReturn Value
The size of the view in points.
See Also
Declared In
CCDirector.h
浙公网安备 33010602011771号