Finally! The next tutorial. This is the 2nd part to the SDL Collision tutorial. We’ll be looking at collision events, the part we left unfinished in the last tutorial. To refresh your memory, a collision event is an event that is stored in queue after a collision has taken place. Take our recent shooter contest for an example. When the player fires a bullet, the bullet flies through the air, and then hits the enemy. The moment the bullet and the enemy collide, an event is triggered and stored in the queue. After all movement has taken place, the queue is iterated through, and events can appropriately respond.
So lets get started. Open up your project from the last tutorial. We’re first going to make a few prelimary changes. Make a new file called CEntityCol.cpp. Inside that file, put the following:
std::vector<CEntityCol> CEntityCol::EntityColList;
CEntityCol::CEntityCol() {
this->EntityA = NULL;
this->EntityB = NULL;
}
Now, get rid of that code from CEntity.cpp. I am basically moving the code to its own file so that everything is much neater. The second thing. Open up CEntity.h and change:
To this:
Also, change the void to bool in CEntity.cpp, CPlayer.h, and CPlayer.cpp. Why the change? Well, you’ll see in a minute. 
We’re already storing the collision events in a queue, now we need to do something with them. Open up CApp_OnLoop.cpp. You’ll notice we already have a loop going for entities and we’re calling OnLoop. We’re basically going to do the same thing again, but after our first loop:
if(!CEntity::EntityList[i]) continue;
CEntity::EntityList[i]->OnLoop();
}
//Collision Events
for(int i = 0;i < CEntityCol::EntityColList.size();i++) {
CEntity* EntityA = CEntityCol::EntityColList[i].EntityA;
CEntity* EntityB = CEntityCol::EntityColList[i].EntityB;
if(EntityA == NULL || EntityB == NULL) continue;
if(EntityA->OnCollision(EntityB)) {
EntityB->OnCollision(EntityA);
}
}
CEntityCol::EntityColList.clear();
Not much going on here. We’re first iterating through every event in the queue. We then grab the two entities involved (EntityA, and EntityB), and we make sure they are valid pointers. If so, we first tell EntityA that it has collided with EntityB by calling OnCollision. Now, this is where that void to bool change comes in. EntityA can choose to prevent EntityB from knowing it has collided with him. If you remember, only Entities that are moving check for collision. This would mean EntityA is definitly a moving entity, and EntityB may or may not be moving.
Here’s an example to explain why you wouldn’t want to waste time calling EntityB’s OnCollision. Say you fire a bullet, and it hits a rock entity. Now, lets say the rock has a flag stating it’s indestructable. Our rock doesn’t care its been hit. So, when the OnCollision is called for the bullet, the bullet can see the entity it has hit is indestructable. And because of that, it can create a little “bullet being destroyed” animation, and then we can ignore telling the rock about it.
This is about the extent of entity collisions. So, now that we have this base, lets do something semi-useful with it.
Open up CEntity.h and add this new function, and variable:
bool CanJump;
public:
bool Jump();
Then, open up CEntity.cpp, and add the Jump function. Also make CanJump = false in the constructor:
CanJump = false;
// … Other code …
}
bool CEntity::Jump() {
if(CanJump == false) return false;
SpeedY = -MaxSpeedY;
return true;
}
Finally, go to the OnMove function. We’re going to figure out when our entity is allowed to jump. An entity is allowed to jump whenever it is touching the ground – or, in other words, whenever the entity is no longer moving on the positive Y-axis. So, at the top, we are first always going to reset CanJump to false:
Now, go down a bit, and modify the PosValid for the Y-axis to the following:
Y += NewY;
}else{
if(MoveY > 0) {
CanJump = true;
}
SpeedY = 0;
}
Now, to run through everything we did. First, we have a flag that states if an entity can jump. When set to true, we are allowed to call the Jump function. This CanJump variable is always false, unless our feet are on the ground. Whenever we actually do want to jump, we simply set our SpeedY in the negative Y-axis direction (up). Remember, gravity is always pushing us down, but at a slow speed. So, if we have a SpeedY of -5, and a AccelY of 0.75, we’ll move up for a time, gravity will kick in, and then we will eventually be pushed back down. Thus, giving the effect of a real jump. The trick here is to get the Speed and Acceleration variables just right.
Also, as a side note, the reason we made Jump return true/false is simply for informational purposes. Meaning, when a key is pressed by the player to jump, they won’t always be allowed to jump. And, if you wanted, you could do something based upon what Jump() returns.
So a few more tweaks before we try this out. In the constructor of CEntity, change the MaxSpeedX and MaxSpeedY to 10. Then, open up CApp_OnEvent.cpp and add the following to OnKeyDown:
Player.Jump();
break;
}
And one last thing. Open up CPlayer.cpp, and change the OnCollision function to this:
Jump();
return true;
}
That’s it! Compile, run, and have fun with Yoshi jumping all over the place. You’ll notice the simple collision event we added is that when Yoshi 1 collides with Yoshi 2, it causes Yoshi 1 to jump. Kind of lame, but you should get the idea.
SDL Collision Events – Tutorial Files:
Win32: Zip, Rar
Did you like this tutorial/blog post? Feel free to donate to keep more comin', and have more contests.
Hello. I have a question. I followed these tutorials and in the end I tried to change the Yoshi image used in tutorial to mine. It works perfectly, but I can`t set transparency on its background. I see in “Collision” chapter you changed the Yoshi image with a background to one without. Is it a problem to set transparency there?
Thanks ever so much for these tutorials. This has given me a good structured foundation of some simple games programming techniques. I have tried numerous times to start games programming and always got distracted by other things, but your tutorials (combined with SDL’s ease of use) have helped me get some real results. I plan to make a simple “Breakout” clone using a lot of the techniques I’ve learned here.
A quick question: In the first code block, is it supposed to be “std::vector CEntityCol::EntityColList;”
instead of “std::vector CEntityCol::EntityColList;”
because im getting an error saying “Argument list for class template std::vector is missing”
Also, what is the CEntity::OnCollision inside CEntity.cpp supposed to do, mine is just empty and it’s giving me an error saying it must return a value(it is declared as virtual)
Thank you for the compliments everyone!