pxt-calliope/docs/reference/music/beat.md
Sam El-Husseini e3975e65e5 pxt-microbit Accessibility PR (#529)
* Accessibility changes
2017-09-07 13:42:08 -07:00

30 lines
702 B
Markdown

# Beat
Returns the duration of a beat in milli-seconds
## Simulator
This function only works on the @boardname@ and in some browsers.
```sig
music.beat(BeatFraction.Whole)
```
## Parameters
* ``BeatFraction`` means fraction of a beat (BeatFraction.Whole, BeatFraction.Sixteenth etc)
## Returns
* a [number](/types/number) that means the amount of milli-seconds a beat fraction represents.
## Example
```blocks
music.playTone(Note.C, music.beat(BeatFraction.Quarter))
```
## See also
[play tone](/reference/music/play-tone), [ring tone](/reference/music/ring-tone), [rest](/reference/music/rest), [set tempo](/reference/music/set-tempo), [change tempo by](/reference/music/change-tempo-by)