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

42 lines
908 B
Markdown
Raw Normal View History

2016-03-25 16:47:20 -07:00
# Touching
2016-07-13 13:10:06 -07: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-13 13:10:06 -07:00
2016-07-13 15:04:10 -07:00
* a **sprite** you are checking
2016-07-13 13:10:06 -07:00
* another **sprite** that might be touching the one you are checking
## Returns
2016-07-13 13:10:06 -07:00
`true` if the two sprites are touching.
## Example
2016-07-13 13:10:06 -07:00
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-25 16:47:20 -07: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-25 16:47:20 -07:00
```
2016-07-13 13:10:06 -07:00
## See also
2016-07-13 13:10:06 -07:00
2016-07-13 15:04:10 -07:00
[create sprite](/reference/game/create-sprite),
[is touching edge](/reference/game/is-touching-edge),
2016-07-13 13:10:06 -07:00
[if on edge, bounce](/reference/game/if-on-edge-bounce)