pxt-ev3/docs/tutorials/what-animal-am-i.md
Galen Nickel 67153fccc5
Reduce the use of @boardname@ (#527)
* Reduce the use of @boardname@

* Use literal 'EV3 Brick' string instead

* Use the new 'nickname' form
2018-04-16 16:15:58 -07:00

166 lines
5.4 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# What Animal Am I?
## Introduction @fullscreen
Create different animal effects with your @boardname@.
![Guess the what the animal is](/static/tutorials/what-animal-am-i/guess-animal.gif)
## Step 1
Open the ``||brick:Brick||`` Toolbox drawer. Drag out a ``||brick:show string||`` block from the **Screen** section onto the Workspace, and drop it into the ``||loops:on start||`` block. You should hear and see the block click into place.
```block
brick.showString("Hello world", 1)
```
## Step 2
In the ``||brick:show string||`` block, type the text ``"Guess what animal?"`` to replace ``"Hello world"``.
```blocks
brick.showString("Guess what animal?", 1)
```
## Step 3
Open the ``||brick:Brick||`` Toolbox drawer. From the **Buttons** section, drag out an ``||brick:on button||`` block and put it anywhere in the Workspace.
```blocks
brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
})
brick.showString("Guess what animal?", 1)
```
## Step 4
In the ``||brick:on button||`` block, use the drop-down menu to select the ``left`` button.
![Dropdown with button choices](/static/tutorials/what-animal-am-i/on-button-dropdown.png)
```blocks
brick.buttonLeft.onEvent(ButtonEvent.Pressed, function () {
})
brick.showString("Guess what animal?", 1)
```
## Step 5
Open the ``||brick:Brick||`` Toolbox drawer. In the **Buttons** section, drag out **3** more ``||brick:on button||`` blocks. Using the drop-down menu, select the ``right``, ``up``, and ``down`` buttons for these 3 blocks.
```blocks
brick.buttonLeft.onEvent(ButtonEvent.Pressed, function () {
})
brick.buttonRight.onEvent(ButtonEvent.Pressed, function () {
})
brick.buttonUp.onEvent(ButtonEvent.Pressed, function () {
})
brick.buttonDown.onEvent(ButtonEvent.Pressed, function () {
})
brick.showString("Guess what animal?", 1)
```
## Step 6
Open the ``||brick:Brick||`` Toolbox drawer. Drag out **4** ``||brick:show image||`` blocks onto the Workspace, and drop one of them into each of the ``||brick:on button||`` blocks.
```blocks
brick.buttonLeft.onEvent(ButtonEvent.Pressed, function () {
brick.showImage(images.expressionsBigSmile)
})
brick.buttonRight.onEvent(ButtonEvent.Pressed, function () {
brick.showImage(images.expressionsBigSmile)
})
brick.buttonUp.onEvent(ButtonEvent.Pressed, function () {
brick.showImage(images.expressionsBigSmile)
})
brick.buttonDown.onEvent(ButtonEvent.Pressed, function () {
brick.showImage(images.expressionsBigSmile)
})
brick.showString("Guess what animal?", 0)
```
## Step 7
In the ``||brick:show image||`` blocks, use the drop-down menu to select a different image to show for each block.
![Dropdown with image selection](/static/tutorials/what-animal-am-i/show-image-dropdown.png)
```blocks
brick.buttonLeft.onEvent(ButtonEvent.Pressed, function () {
brick.showImage(images.expressionsMouth2shut)
})
brick.buttonRight.onEvent(ButtonEvent.Pressed, function () {
brick.showImage(images.expressionsMouth1open)
})
brick.buttonUp.onEvent(ButtonEvent.Pressed, function () {
brick.showImage(images.objectsBoom)
})
brick.buttonDown.onEvent(ButtonEvent.Pressed, function () {
brick.showImage(images.objectsPirate)
})
brick.showString("Guess what animal?", 0)
```
## Step 8
Open the ``||music:Music||`` Toolbox drawer. Drag out **4** ``||music:play sound effect||`` block and drop one of them into each of the ``||brick:on button||`` blocks, just after the ``||brick:show image||`` block.
```blocks
brick.buttonLeft.onEvent(ButtonEvent.Pressed, function () {
brick.showImage(images.expressionsMouth2shut)
music.playSoundEffect(sounds.animalsCatPurr)
})
brick.buttonRight.onEvent(ButtonEvent.Pressed, function () {
brick.showImage(images.expressionsMouth1open)
music.playSoundEffect(sounds.animalsCatPurr)
})
brick.buttonUp.onEvent(ButtonEvent.Pressed, function () {
brick.showImage(images.objectsBoom)
music.playSoundEffect(sounds.animalsCatPurr)
})
brick.buttonDown.onEvent(ButtonEvent.Pressed, function () {
brick.showImage(images.objectsPirate)
music.playSoundEffect(sounds.animalsCatPurr)
})
brick.showString("Guess what animal?", 0)
```
## Step 9
In each ``||music:play sound effect||`` block, use the drop-down menu to select a different animal sound to play.
![Dropdown with sound effect selection](/static/tutorials/what-animal-am-i/play-sound-effect-dropdown.png)
```blocks
brick.buttonLeft.onEvent(ButtonEvent.Pressed, function () {
brick.showImage(images.expressionsMouth2shut)
music.playSoundEffect(sounds.animalsCatPurr)
})
brick.buttonRight.onEvent(ButtonEvent.Pressed, function () {
brick.showImage(images.expressionsMouth1open)
music.playSoundEffect(sounds.animalsDogBark1)
})
brick.buttonUp.onEvent(ButtonEvent.Pressed, function () {
brick.showImage(images.objectsBoom)
music.playSoundEffect(sounds.animalsElephantCall)
})
brick.buttonDown.onEvent(ButtonEvent.Pressed, function () {
brick.showImage(images.objectsPirate)
music.playSoundEffect(sounds.animalsSnakeHiss)
})
brick.showString("Guess what animal?", 0)
```
## Step 10
Now, plug your EV3 Brick into the computer with the USB cable, and click the **Download** button at the bottom of your screen. Follow the directions to save your program to the brick.
Test your program with a friend by pressing the right, left, up, and down buttons on your brick. Have your friend guess what animal it is!