Initial commit (version 0.2.1)

1 files changed, 95 insertions, 0 deletions

@@ -0,0 +1,95 @@
+/*
+ * cocos2d for iPhone: http://www.cocos2d-iphone.org
+ *
+ * Copyright (c) 2008-2010 Ricardo Quesada
+ * Copyright (c) 2011 Zynga Inc.
+ * 
+ * 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 "CCNode.h"
+
+/** 
+    A CCCamera is used in every CCNode.
+    Useful to look at the object from different views.
+    The OpenGL gluLookAt() function is used to locate the
+    camera.
+
+    If the object is transformed by any of the scale, rotation or
+    position attributes, then they will override the camera.
+ 
+        IMPORTANT: Either your use the camera or the rotation/scale/position properties. You can't use both.
+    World coordinates won't work if you use the camera.
+
+    Limitations:
+ 
+     - Some nodes, like CCParallaxNode, CCParticle uses world node coordinates, and they won't work properly if you move them (or any of their ancestors)
+       using the camera.
+     
+     - It doesn't work on batched nodes like CCSprite objects when they are parented to a CCSpriteBatchNode object.
+ 
+         - It is recommended to use it ONLY if you are going to create 3D effects. For 2D effecs, use the action CCFollow or position/scale/rotate.
+ 
+*/
+
+@interface CCCamera : NSObject
+{
+    float eyeX_;
+    float eyeY_;
+    float eyeZ_;
+
+    float centerX_;
+    float centerY_;
+    float centerZ_;
+
+    float upX_;
+    float upY_;
+    float upZ_;
+        
+        BOOL dirty_;
+}
+
+/** whether of not the camera is dirty */
+@property (nonatomic,readwrite) BOOL dirty;
+
+/** returns the Z eye */
++(float) getZEye;
+
+/** sets the camera in the defaul position */
+-(void) restore;
+/** Sets the camera using gluLookAt using its eye, center and up_vector */
+-(void) locate;
+/** sets the eye values in points */
+-(void) setEyeX: (float)x eyeY:(float)y eyeZ:(float)z;
+/** sets the center values in points */
+-(void) setCenterX: (float)x centerY:(float)y centerZ:(float)z;
+/** sets the up values */
+-(void) setUpX: (float)x upY:(float)y upZ:(float)z;
+
+/** get the eye vector values in points */
+-(void) eyeX:(float*)x eyeY:(float*)y eyeZ:(float*)z;
+/** get the center vector values in points */
+-(void) centerX:(float*)x centerY:(float*)y centerZ:(float*)z;
+/** get the up vector values */
+-(void) upX:(float*)x upY:(float*)y upZ:(float*)z;
+
+
+@end