Pixel Perfect Collision Detection (Using Cocos2d-x)

This post found its way because I couldnt find the answer to one of the questions I asked on StackOverflow (http://stackoverflow.com/questions/18546066/pixel-perfect-collision-detection-in-cocos2dx) and thought there would be others like me in search for an answer.

Collision detection is an integral part of almost all games. It is used to find when a bullet hits an enemy or when you bump into a wall etc.
There are many different requirements when we do collision detection and depending on our game we choose one of the many detection techniques.

The default Collision detection mechanism used by games and provided in almost all game engines and frameworks is a “Bounding Box” collision.
Simply put, a “Bounding Box” collision detection system the sprites/objects being checked for collision are treated as the smallest rectangle which completely engulfs them. Then these two Boxes are checked if they are colliding with each other.

But sometimes this very simple collision detection system is not accurate. Specially when we use sprites with alpha values (mostly png files) or when our objects are rotated by some angles. See the image below:

     

Pixel – Perfect collision detection is a system where we check if the objects concerned are actually colliding rather than just being part of a bounding box which is bigger than their size. WARNING: This system though more accurate is obviously more performance intensive and hence depending on your game requirements choose wisely about which of the different systems you want to use.

TIP: This system though written specially for Cocos2d-x framework can be easily understood and implemented for any language/framework you are using.

So its time to get our hands dirty,

We are going to develop a Singleton Class for collision detection and just plug and play this in any project we are doing.

Things used:
1. Singleton Class – CollisionDetection
2. Opengl Vertex and Fragment Shaders
3. CCRenderTexture Class – Cocos2d-x

Theory:
1. Create a CCRenderTexture which is going to serve as a secondary draw buffer.
2. We first do a simple collision detection (Bounding Box) to check if the two sprite’s bounds are colliding
3. If step 2 is a success then we are going to draw the two concerned objects in our secondary buffer we created in step 1. (We are going to set its visibility to false, so that even though we draw something, nothing will we visible to the end user)
4. Using openGL fragment shaders we are going to draw one of the objects completely RED and the other completely BLUE!

     
5. Using another of openGL functionality glReadPixels we are going to read the pixels data of all the pixels in the Rectangular area (Intersection area) of the bounding box collision
6. We are then going to loop through all the pixel values and check if a single pixel has BOTH the RED and the BLUE pixels. If they have then the objects are actually colliding or else not.

Now here is the code for the above steps. I have commented the code for you to understand what is going on. If there are any questions please leave in the comments and I will try and answer to the best of my knowledge

CollisionDetection.h

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35

// //  CollisionDetection.h //  Created by Mudit Jaju on 30/08/13. // //  SINGLETON class for checking Pixel Based Collision Detection #ifndef __CollisionDetection__ #define __CollisionDetection__ #include <iostream> #include "cocos2d.h" USING_NS_CC; class CollisionDetection { public:     //Handle for getting the Singleton Object     static CollisionDetection* GetInstance();     //Function signature for checking for collision detection spr1, spr2 are the concerned sprites     //pp is bool, set to true if Pixel Perfection Collision is required. Else set to false     //_rt is the secondary buffer used in our system     bool areTheSpritesColliding(CCSprite* spr1, CCSprite* spr2, bool pp, CCRenderTexture* _rt); private:     static CollisionDetection* instance;     CollisionDetection();     // Values below are all required for openGL shading     CCGLProgram *glProgram;     ccColor4B *buffer;     int uniformColorRed;     int uniformColorBlue; }; #endif /* defined(__CollisionDetection__) */

CollisionDetection.cpp

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140

// //  CollisionDetection.cpp //  Created by Mudit Jaju on 30/08/13. // //  SINGLETON class for checking Pixel Based Collision Detection #include "CollisionDetection.h" // Singleton Instance set to NULL initially CollisionDetection* CollisionDetection::instance = NULL; // Handle to get Singleton Instance CollisionDetection* CollisionDetection::GetInstance() {     if (instance == NULL) {         instance = new CollisionDetection();     }     return instance; } // Private Constructor being called from within the GetInstance handle CollisionDetection::CollisionDetection() {     // Code below to setup shaders for use in Cocos2d-x     glProgram = new CCGLProgram();     glProgram->retain();     glProgram->initWithVertexShaderFilename("SolidVertexShader.vsh", "SolidColorShader.fsh");     glProgram->addAttribute(kCCAttributeNamePosition, kCCVertexAttrib_Position);     glProgram->addAttribute(kCCAttributeNameTexCoord, kCCVertexAttrib_TexCoords);     glProgram->link();     glProgram->updateUniforms();     glProgram->use();     uniformColorRed = glGetUniformLocation(glProgram->getProgram(), "u_color_red");     uniformColorBlue = glGetUniformLocation(glProgram->getProgram(), "u_color_blue");     // A large buffer created and re-used again and again to store glReadPixels data     buffer = (ccColor4B *)malloc( sizeof(ccColor4B) * 10000 ); } bool CollisionDetection::areTheSpritesColliding(cocos2d::CCSprite* spr1, cocos2d::CCSprite* spr2, bool pp, CCRenderTexture* _rt) {     bool isColliding = false;     // Rectangle of the intersecting area if the sprites are colliding according to Bounding Box collision     CCRect intersection;     // Bounding box of the Two concerned sprites being saved     CCRect r1 = spr1->boundingBox();     CCRect r2 = spr2->boundingBox();     // Look for simple bounding box collision     if (r1.intersectsRect(r2)) {         // If we're not checking for pixel perfect collisions, return true         if (!pp) {             return true;         }         float tempX;         float tempY;         float tempWidth;         float tempHeight;         //OPTIMIZE FURTHER         //CONSIDER THE CASE WHEN ONE BOUDNING BOX IS COMPLETELY INSIDE ANOTHER BOUNDING BOX!         if (r1.getMaxX() > r2.getMinX()) {             tempX = r2.getMinX();             tempWidth = r1.getMaxX() - r2.getMinX();         } else {             tempX = r1.getMinX();             tempWidth = r2.getMaxX() - r1.getMinX();         }         if (r2.getMaxY() < r1.getMaxY()) {             tempY = r1.getMinY();             tempHeight = r2.getMaxY() - r1.getMinY();         } else {             tempY = r2.getMinY();             tempHeight = r1.getMaxY() - r2.getMinY();         }         // We make the rectangle for the intersection area         intersection = CCRectMake(tempX * CC_CONTENT_SCALE_FACTOR(), tempY * CC_CONTENT_SCALE_FACTOR(), tempWidth * CC_CONTENT_SCALE_FACTOR(), tempHeight * CC_CONTENT_SCALE_FACTOR());         unsigned int x = intersection.origin.x;         unsigned int y = intersection.origin.y;         unsigned int w = intersection.size.width;         unsigned int h = intersection.size.height;         // Total pixels whose values we will get using glReadPixels depends on the Height and Width of the intersection area         unsigned int numPixels = w * h;         // Setting the custom shader to be used         spr1->setShaderProgram(glProgram);         spr2->setShaderProgram(glProgram);         glProgram->use();         // Clearing the Secondary Draw buffer of all previous values         _rt->beginWithClear( 0, 0, 0, 0);         // The below two values are being used in the custom shaders to set the value of RED and BLUE colors to be used         glUniform1i(uniformColorRed, 255);         glUniform1i(uniformColorBlue, 0);         // The blend function is important we don't want the pixel value of the RED color being over-written by the BLUE color.        // We want both the colors at a single pixel and hence get a PINK color (so that we have both the RED and BLUE pixels)         spr1->setBlendFunc((ccBlendFunc){GL_SRC_ALPHA, GL_ONE});         // The visit() function draws the sprite in the _rt draw buffer its a Cocos2d-x function         spr1->visit();         // Setting the shader program back to the default shader being used by our game         spr1->setShaderProgram(CCShaderCache::sharedShaderCache()->programForKey(kCCShader_PositionTextureColor));         // Setting the default blender function being used by the game         spr1->setBlendFunc((ccBlendFunc){CC_BLEND_SRC, CC_BLEND_DST});         // Setting new values for the same shader but for our second sprite as this time we want to have an all BLUE sprite         glUniform1i(uniformColorRed, 0);         glUniform1i(uniformColorBlue, 255);         spr2->setBlendFunc((ccBlendFunc){GL_SRC_ALPHA, GL_ONE});         spr2->visit();         spr2->setShaderProgram(CCShaderCache::sharedShaderCache()->programForKey(kCCShader_PositionTextureColor));         spr2->setBlendFunc((ccBlendFunc){CC_BLEND_SRC, CC_BLEND_DST});         // Get color values of intersection area         glReadPixels(x, y, w, h, GL_RGBA, GL_UNSIGNED_BYTE, buffer);         _rt->end();         // Read buffer         unsigned int step = 1;         for(unsigned int i=0; i<numPixels; i+=step) {             ccColor4B color = buffer[i];             // Here we check if a single pixel has both RED and BLUE pixels             if (color.r > 0 && color.b > 0) {                 isColliding = true;                 break;             }         }     }     return isColliding; }

 SolidColorShader.fsh

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

#ifdef GL_ES precision lowp float; #endif varying vec2 v_texCoord; uniform sampler2D u_texture; uniform int u_color_red; uniform int u_color_blue; void main() {     vec4 color = texture2D(u_texture, v_texCoord);     gl_FragColor = vec4(u_color_red, 0, u_color_blue, color.a); }

 SolidVertexShader.vsh

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

attribute vec4 a_position;                             attribute vec2 a_texCoord;                             attribute vec4 a_color;                                 #ifdef GL_ES                                         varying lowp vec4 v_fragmentColor;                     varying mediump vec2 v_texCoord;                     #else                                                 varying vec4 v_fragmentColor;                         varying vec2 v_texCoord;                             #endif                                                 void main()                                             {                                                         gl_Position = CC_MVPMatrix * a_position;             v_fragmentColor = a_color;                             v_texCoord = a_texCoord;                         }

For using the Collision Detection Class:

1. Initialize the CCRenderTexture object

1 2 3 4

_rt = CCRenderTexture::create(visibleSize.width * 2, visibleSize.height * 2);     _rt->setPosition(ccp(visibleSize.width, visibleSize.height));     _rt->retain();     _rt->setVisible(false);

2. Call the Singleton function whenever collision detection required

1 2 3

if (CollisionDetection::GetInstance()->areTheSpritesColliding(pSprite, pCurrentSpriteToDrag, true, _rt)) {      //Code here }