mirror of
https://github.com/pybricks/pybricks-api.git
synced 2026-09-12 01:24:17 +00:00
182 lines
6.7 KiB
SQL
182 lines
6.7 KiB
SQL
.. autoclass:: pybricks.hubs.EV3Brick
|
|
:no-members:
|
|
|
|
.. rubric:: Using the buttons
|
|
|
|
.. automethod:: pybricks.hubs::EV3Brick.buttons.pressed
|
|
|
|
.. rubric:: Using the brick status light
|
|
|
|
.. automethod:: pybricks.hubs::EV3Brick.light.on
|
|
|
|
.. toggle-header::
|
|
:header: **Show/hide example**
|
|
|
|
**Example: Turn the light on and change the color.**
|
|
|
|
.. literalinclude:: ../../pybricks-projects/snippets/ev3/light_color/main.py
|
|
|
|
.. automethod:: pybricks.hubs::EV3Brick.light.off
|
|
|
|
.. rubric:: Using the speaker
|
|
|
|
.. automethod:: pybricks.hubs::EV3Brick.speaker.beep
|
|
|
|
.. automethod:: pybricks.hubs::EV3Brick.speaker.play_notes
|
|
|
|
.. toggle-header::
|
|
:header: **Show/hide musical note format**
|
|
|
|
Each note is a string with the following format:
|
|
|
|
- The first character is the name of the note, ``A`` to ``G`` or ``R``
|
|
for a rest.
|
|
- Note names can also include an accidental ``#`` (sharp) or ``b``
|
|
(flat). ``B#``/``Cb`` and ``E#``/``Fb`` are not allowed.
|
|
- The note name is followed by the octave number ``2`` to ``8``. For
|
|
example ``C4`` is middle C. The octave changes to the next number at
|
|
the note C, for example, ``B3`` is the note below middle C (``C4``).
|
|
- The octave is followed by ``/`` and a number that indicates the size
|
|
of the note. For example ``/4`` is a quarter note, ``/8`` is an
|
|
eight note and so on.
|
|
- This can optionally followed by a ``.`` to make a dotted note.
|
|
Dotted notes are 1-1/2 times as long as notes without a dot.
|
|
- The note can optionally end with a ``_`` which is a tie or a slur.
|
|
This causes there to be no pause between this note and the next note.
|
|
|
|
|
|
.. automethod:: pybricks.hubs::EV3Brick.speaker.play_file
|
|
|
|
.. automethod:: pybricks.hubs::EV3Brick.speaker.say
|
|
|
|
.. automethod:: pybricks.hubs::EV3Brick.speaker.set_speech_options
|
|
|
|
.. toggle-header::
|
|
:header: **Show/hide available languages and voices**
|
|
|
|
You can choose the following languages:
|
|
|
|
- ``'af'``: Afrikaans
|
|
- ``'an'``: Aragonese
|
|
- ``'bg'``: Bulgarian
|
|
- ``'bs'``: Bosnian
|
|
- ``'ca'``: Catalan
|
|
- ``'cs'``: Czech
|
|
- ``'cy'``: Welsh
|
|
- ``'da'``: Danish
|
|
- ``'de'``: German
|
|
- ``'el'``: Greek
|
|
- ``'en'``: English (default)
|
|
- ``'en-gb'``: English (United Kingdom)
|
|
- ``'en-sc'``: English (Scotland)
|
|
- ``'en-uk-north'``: English (United Kingdom, Northern)
|
|
- ``'en-uk-rp'``: English (United Kingdom, Received Pronunciation)
|
|
- ``'en-uk-wmids'``: English (United Kingdom, West Midlands)
|
|
- ``'en-us'``: English (United States)
|
|
- ``'en-wi'``: English (West Indies)
|
|
- ``'eo'``: Esperanto
|
|
- ``'es'``: Spanish
|
|
- ``'es-la'``: Spanish (Latin America)
|
|
- ``'et'``: Estonian
|
|
- ``'fa'``: Persian
|
|
- ``'fa-pin'``: Persian
|
|
- ``'fi'``: Finnish
|
|
- ``'fr-be'``: French (Belgium)
|
|
- ``'fr-fr'``: French (France)
|
|
- ``'ga'``: Irish
|
|
- ``'grc'``: Greek
|
|
- ``'hi'``: Hindi
|
|
- ``'hr'``: Croatian
|
|
- ``'hu'``: Hungarian
|
|
- ``'hy'``: Armenian
|
|
- ``'hy-west'``: Armenian (Western)
|
|
- ``'id'``: Indonesian
|
|
- ``'is'``: Icelandic
|
|
- ``'it'``: Italian
|
|
- ``'jbo'``: Lojban
|
|
- ``'ka'``: Georgian
|
|
- ``'kn'``: Kannada
|
|
- ``'ku'``: Kurdish
|
|
- ``'la'``: Latin
|
|
- ``'lfn'``: Lingua Franca Nova
|
|
- ``'lt'``: Lithuanian
|
|
- ``'lv'``: Latvian
|
|
- ``'mk'``: Macedonian
|
|
- ``'ml'``: Malayalam
|
|
- ``'ms'``: Malay
|
|
- ``'ne'``: Nepali
|
|
- ``'nl'``: Dutch
|
|
- ``'no'``: Norwegian
|
|
- ``'pa'``: Punjabi
|
|
- ``'pl'``: Polish
|
|
- ``'pt-br'``: Portuguese (Brazil)
|
|
- ``'pt-pt'``: Portuguese (Portugal)
|
|
- ``'ro'``: Romanian
|
|
- ``'ru'``: Russian
|
|
- ``'sk'``: Slovak
|
|
- ``'sq'``: Albanian
|
|
- ``'sr'``: Serbian
|
|
- ``'sv'``: Swedish
|
|
- ``'sw'``: Swahili
|
|
- ``'ta'``: Tamil
|
|
- ``'tr'``: Turkish
|
|
- ``'vi'``: Vietnamese
|
|
- ``'vi-hue'``: Vietnamese (Hue)
|
|
- ``'vi-sgn'``: Vietnamese (Saigon)
|
|
- ``'zh'``: Mandarin Chinese
|
|
- ``'zh-yue'``: Cantonese Chinese
|
|
|
|
You can choose the following voices:
|
|
|
|
- ``'f1'``: female variant 1
|
|
- ``'f2'``: female variant 2
|
|
- ``'f3'``: female variant 3
|
|
- ``'f4'``: female variant 4
|
|
- ``'f5'``: female variant 5
|
|
- ``'m1'``: male variant 1
|
|
- ``'m2'``: male variant 2
|
|
- ``'m3'``: male variant 3
|
|
- ``'m4'``: male variant 4
|
|
- ``'m5'``: male variant 5
|
|
- ``'m6'``: male variant 6
|
|
- ``'m7'``: male variant 7
|
|
- ``'croak'``: croak
|
|
- ``'whisper'``: whisper
|
|
- ``'whisperf'``: female whisper
|
|
|
|
|
|
.. automethod:: pybricks.hubs::EV3Brick.speaker.set_volume
|
|
|
|
|
|
.. rubric:: Using the screen
|
|
|
|
.. automethod:: pybricks.hubs::EV3Brick.screen.clear
|
|
|
|
.. automethod:: pybricks.hubs::EV3Brick.screen.draw_text
|
|
|
|
.. automethod:: pybricks.hubs::EV3Brick.screen.print
|
|
|
|
.. automethod:: pybricks.hubs::EV3Brick.screen.set_font
|
|
|
|
.. automethod:: pybricks.hubs::EV3Brick.screen.show_image
|
|
|
|
.. automethod:: pybricks.hubs::EV3Brick.screen.draw_image
|
|
|
|
.. automethod:: pybricks.hubs::EV3Brick.screen.draw_pixel
|
|
|
|
.. automethod:: pybricks.hubs::EV3Brick.screen.draw_line
|
|
|
|
.. automethod:: pybricks.hubs::EV3Brick.screen.draw_box
|
|
|
|
.. automethod:: pybricks.hubs::EV3Brick.screen.draw_circle
|
|
|
|
.. autoattribute:: pybricks.hubs::EV3Brick.screen.width
|
|
|
|
.. autoattribute:: pybricks.hubs::EV3Brick.screen.height
|
|
|
|
.. rubric:: Using the battery
|
|
|
|
.. automethod:: pybricks.hubs::EV3Brick.battery.voltage
|
|
|
|
.. automethod:: pybricks.hubs::EV3Brick.battery.current
|