pxt-calliope/docs/reference/game/touching.md

42 lines
906 B
Markdown
Raw Normal View History

2016-03-26 00:47:20 +01:00
# Touching
2016-07-13 22:10:06 +02:00
Find whether the sprite is touching another sprite you say.
Sprites are touching if they share the same LED.
```sig
let item: game.LedSprite = null;
item.isTouching(null);
```
### Parameters
2016-07-14 00:04:10 +02:00
* a **sprite** you are checking
2016-07-13 22:10:06 +02:00
* another **sprite** that might be touching the one you are checking
### Returns
`true` if the two sprites are touching.
### Example
This program creates two sprites called ``matter`` and ``antimatter``,
and then checks whether they are touching. If they are, there is an
explosion.
2016-03-26 00:47:20 +01:00
```blocks
let matter = game.createSprite(2, 2);
let antimatter = game.createSprite(2, 2);
if (matter.isTouching(antimatter)) {
basic.pause(500);
basic.clearScreen();
basic.showString("BOOM!");
}
2016-03-26 00:47:20 +01:00
```
2016-07-13 22:10:06 +02:00
### See also
2016-07-14 00:04:10 +02:00
[create sprite](/reference/game/create-sprite),
2016-07-13 22:10:06 +02:00
[touching edge](/reference/game/touching-edge),
[if on edge, bounce](/reference/game/if-on-edge-bounce)