链接:http://blog.muditjaju.infiniteeurekas.in/?p=1
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
}
|