/Users/ricardoquesada/progs/cocos2d-iphone/cocos2d/CCDirector.h

/*
 * cocos2d for iPhone: http://www.cocos2d-iphone.org
 *
 * Copyright (c) 2008-2010 Ricardo Quesada
 * 
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 * 
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 * 
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 */



//
#import "ccConfig.h"
#import "ccTypes.h"

// OpenGL related
#import "Support/EAGLView.h"

typedef enum {
        kCCPixelFormatRGB565,
        kCCPixelFormatRGBA8888,
        kCCPixelFormatDefault = kCCPixelFormatRGB565,

        // backward compatibility stuff
        kPixelFormatRGB565 = kCCPixelFormatRGB565,
        kRGB565 = kCCPixelFormatRGB565,
        kPixelFormatRGBA8888 = kCCPixelFormatRGBA8888,
        kRGBA8 = kCCPixelFormatRGBA8888,
} tPixelFormat;

typedef enum {
        kCCDepthBufferNone,
        kCCDepthBuffer16,
        kCCDepthBuffer24,
        
        // backward compatibility stuff
        kDepthBuffer16 = kCCDepthBuffer16,
        kDepthBuffer24 = kCCDepthBuffer24,
} tDepthBufferFormat;

typedef enum {
        kCCDirectorProjection2D,
        
        kCCDirectorProjection3D,
        
        kCCDirectorProjectionCustom,
        
        kCCDirectorProjectionDefault = kCCDirectorProjection3D,
        
        // backward compatibility stuff
        CCDirectorProjection2D = kCCDirectorProjection2D,
        CCDirectorProjection3D = kCCDirectorProjection3D,
        CCDirectorProjectionCustom = kCCDirectorProjectionCustom,

} ccDirectorProjection;

typedef enum {
        kCCDirectorTypeNSTimer,
        
        kCCDirectorTypeMainLoop,
        
        kCCDirectorTypeThreadMainLoop,
        
        kCCDirectorTypeDisplayLink,
        
        kCCDirectorTypeDefault = kCCDirectorTypeNSTimer,
        
        // backward compatibility stuff
        CCDirectorTypeNSTimer = kCCDirectorTypeNSTimer,
        CCDirectorTypeMainLoop = kCCDirectorTypeMainLoop,
        CCDirectorTypeThreadMainLoop = kCCDirectorTypeThreadMainLoop,
        CCDirectorTypeDisplayLink = kCCDirectorTypeDisplayLink,
        CCDirectorTypeDefault =kCCDirectorTypeDefault,


} ccDirectorType;

typedef enum {
        kCCDeviceOrientationPortrait = UIDeviceOrientationPortrait,     
    kCCDeviceOrientationPortraitUpsideDown = UIDeviceOrientationPortraitUpsideDown,
    kCCDeviceOrientationLandscapeLeft = UIDeviceOrientationLandscapeLeft,
    kCCDeviceOrientationLandscapeRight = UIDeviceOrientationLandscapeRight,
        
        // Backward compatibility stuff
        CCDeviceOrientationPortrait = kCCDeviceOrientationPortrait,
        CCDeviceOrientationPortraitUpsideDown = kCCDeviceOrientationPortraitUpsideDown,
        CCDeviceOrientationLandscapeLeft = kCCDeviceOrientationLandscapeLeft,
        CCDeviceOrientationLandscapeRight = kCCDeviceOrientationLandscapeRight,
} ccDeviceOrientation;

@class CCLabelAtlas;
@class CCScene;

@interface CCDirector : NSObject
{
        EAGLView        *openGLView_;

        // internal timer
        NSTimeInterval animationInterval_;
        NSTimeInterval oldAnimationInterval_;

        tPixelFormat pixelFormat_;
        tDepthBufferFormat depthBufferFormat_;
        
        /* orientation */
        ccDeviceOrientation     deviceOrientation_;
        
        /* display FPS ? */
        BOOL displayFPS_;

        int frames_;
        ccTime accumDt_;
        ccTime frameRate_;
#if     CC_DIRECTOR_FAST_FPS
        CCLabelAtlas *FPSLabel_;
#endif
        
        /* is the running scene paused */
        BOOL isPaused_;
        
        /* The running scene */
        CCScene *runningScene_;
        
        /* will be the next 'runningScene' in the next frame
         nextScene is a weak reference. */
        CCScene *nextScene_;
        
        /* If YES, then "old" scene will receive the cleanup message */
        BOOL    sendCleanupToScene_;

        /* scheduled scenes */
        NSMutableArray *scenesStack_;
        
        /* last time the main loop was updated */
        struct timeval lastUpdate_;
        /* delta time since last tick to main loop */
        ccTime dt;
        /* whether or not the next delta time will be zero */
        BOOL nextDeltaTimeZero_;
        
        /* projection used */
        ccDirectorProjection projection_;
        
        /* screen, different than surface size */
        CGSize  screenSize_;

        /* screen, different than surface size */
        CGSize  surfaceSize_;
        
        /* content scale factor */
        CGFloat contentScaleFactor_;
        
        /* contentScaleFactor could be simulated */
        BOOL    isContentScaleSupported_;

#if CC_ENABLE_PROFILERS
        ccTime accumDtForProfiler_;
#endif
}

@property (nonatomic,readonly) CCScene* runningScene;
@property (nonatomic,readwrite, assign) NSTimeInterval animationInterval;
@property (nonatomic,readwrite, assign) BOOL displayFPS;
@property (nonatomic,readwrite,retain) EAGLView *openGLView;
@property (nonatomic,readonly) tPixelFormat pixelFormat DEPRECATED_ATTRIBUTE;
@property (nonatomic,readwrite,assign) BOOL nextDeltaTimeZero;
@property (nonatomic,readwrite) ccDeviceOrientation deviceOrientation;
@property (nonatomic,readonly) BOOL isPaused;
@property (nonatomic,readwrite) ccDirectorProjection projection;

@property (nonatomic, readonly) BOOL sendCleanupToScene;

@property (nonatomic, readwrite) CGFloat contentScaleFactor;

+(CCDirector *)sharedDirector;

+(BOOL) setDirectorType:(ccDirectorType) directorType;


// iPhone Specific

-(void) setPixelFormat: (tPixelFormat)p DEPRECATED_ATTRIBUTE;

-(void) setDepthBufferFormat: (tDepthBufferFormat)db DEPRECATED_ATTRIBUTE;

// Integration with UIKit
-(BOOL)detach DEPRECATED_ATTRIBUTE;

-(BOOL)attachInWindow:(UIWindow *)window DEPRECATED_ATTRIBUTE;

-(BOOL)attachInView:(UIView *)view DEPRECATED_ATTRIBUTE;

-(BOOL)attachInView:(UIView *)view withFrame:(CGRect)frame DEPRECATED_ATTRIBUTE;

// Landscape

- (CGSize) winSize;
-(CGSize) displaySize;

-(CGPoint) convertToGL: (CGPoint) p;
-(CGPoint) convertToUI:(CGPoint)p;

// rotates the screen if an orientation differnent than Portrait is used
-(void) applyOrientation;

-(float) getZEye;

// Scene Management

- (void) runWithScene:(CCScene*) scene;

- (void) pushScene:(CCScene*) scene;

- (void) popScene;

-(void) replaceScene: (CCScene*) scene;

-(void) end;

-(void) pause;

-(void) resume;

-(void) stopAnimation;

-(void) startAnimation;

-(void) drawScene;

// Memory Helper

-(void) purgeCachedData;
 

// OpenGL Helper

-(void) setGLDefaultValues;

- (void) setAlphaBlending: (BOOL) on;
- (void) setDepthTest: (BOOL) on;
- (void) recalculateProjectionAndEAGLViewSize;

@end

@interface CCFastDirector : CCDirector
{
        BOOL isRunning;
        
        NSAutoreleasePool       *autoreleasePool;
}
-(void) preMainLoop;
@end

@interface CCThreadedFastDirector : CCDirector
{
        BOOL isRunning; 
}
-(void) preMainLoop;
@end

@interface CCDisplayLinkDirector : CCDirector
{
        id displayLink;
}
-(void) preMainLoop:(id)sender;
@end

@interface CCTimerDirector : CCDirector
{
        NSTimer *animationTimer;
}
@end