Don’t add CCRenderTexture.sprite as a child.

Author: slembcke

cocos2d/CCRenderTexture.h

@@ -58,10 +58,8 @@ typedef NS_ENUM(NSInteger, CCRenderTextureImageFormat)
  */
 @interface CCRenderTexture : CCNode
 
-/** The CCSprite being used.
- The sprite, by default, will use the following blending function: GL_ONE, GL_ONE_MINUS_SRC_ALPHA.
- The blending function can be changed in runtime by calling:
-	- [[renderTexture sprite] setBlendFunc:(ccBlendFunc){GL_ONE, GL_ONE_MINUS_SRC_ALPHA}];
+/** The CCSprite that is used for rendering.
+	A sublte change introduced in v3.1.1 is that this sprite is rendered explicitly and is not a child of the render texture.
 */
 @property (nonatomic,readwrite, strong) CCSprite* sprite;
 

cocos2d/CCRenderTexture.m

@@ -131,9 +131,6 @@ -(id)initWithWidth:(int)width height:(int)height pixelFormat:(CCTexturePixelForm
 
 		// Diabled by default.
 		_autoDraw = NO;
-		
-		// add sprite for backward compatibility
-		[self addChild:_sprite];
 	}
 	return self;
 }
@@ -392,18 +389,29 @@ - (void)visit:(CCRenderer *)renderer parentTransform:(const GLKMatrix4 *)parentT
 		[self sortAllChildren];
 
 		for(CCNode *child in _children){
-			if( child != _sprite) [child visit:renderer parentTransform:&_projection];
+			[child visit:renderer parentTransform:&_projection];
 		}
 
 		[self end];
+		
+		GLKMatrix4 transform = [self transform:parentTransform];
+		[self draw:renderer transform:&transform];
+	} else {
+		// Render normally, v3.0 and earlier skipped this.
+		[super visit:renderer parentTransform:parentTransform];
 	}
 
-	GLKMatrix4 transform = [self transform:parentTransform];
-	[_sprite visit:renderer parentTransform:&transform];
-	
 	_orderOfArrival = 0;
 }
 
+-(void)draw:(CCRenderer *)renderer transform:(const GLKMatrix4 *)transform
+{
+	NSAssert(_sprite.zOrder == 0, @"Changing the sprite's zOrder is not supported.");
+	
+	// Force the sprite to render itself.
+	[_sprite visit:renderer parentTransform:transform];
+}
+
 #pragma mark RenderTexture - Save Image
 
 -(CGImageRef) newCGImage