Python#

Referenční příručka VEX V5 Python API vysvětluje, co každý příkaz, metoda a funkce dělá, jaké vstupy používá, co vrací a jak ji lze použít v projektu.

Tuto referenci použijte, pokud chcete porozumět příkazu před jeho přidáním do projektu, zkontrolovat, jaké hodnoty přijímá nebo vrací, nebo porovnat související příkazy v kategorii.

Příkazy Pythonu se používají v projektech VEXcode V5 v Pythonu. Bloky a projekty C++ místo toho používají jiné sekce API.

Jak číst záznam metody#

Většina položek v Pythonu obsahuje následující části:

Název příkazu – Oficiální název příkazu, metody nebo funkce.
Popis – Vysvětluje, co příkaz dělá a kdy je užitečný.
Použití – Zobrazuje syntaxi použitou k zápisu příkazu v kódu.
Parametry – Vypíše vstupy, které příkaz akceptuje, a vysvětlí, co každý z nich dělá.
Návratová hodnota – Vysvětluje, co příkaz hlásí zpět, pokud vrací hodnotu.
Příklad kódu – Ukazuje jeden způsob použití příkazu v projektu.

Běžné prvky Python API#

Živel	Co to znamená
Metoda	Příkaz volaný na objektu, například `drivetrain.drive(…)`.
Funkce	Příkaz volaný přímo, například `wait(…)` nebo `print(…)`.
Parametr	Hodnota předávaná metodě nebo funkci za účelem řízení její činnosti.
Volitelný parametr	Parametr, který lze vynechat, aby se použilo výchozí chování.
Návratová hodnota	Hodnota, kterou příkaz hlásí zpět, například číslo, text nebo booleovská hodnota.

Základní slovní zásoba Pythonu#

Období	Co to znamená
Proměnná	Název, který ukládá hodnotu, například `speed = 50`.
Řetězec	Text v uvozovkách, například `“Hello”`.
Celé číslo	Kladné nebo záporné číslo, například `90`.
Plovák	Číslo s desetinnou čárkou, například `25.5`.
Boolean	Hodnota, která je buď `True` nebo `False`.
Argument	Hodnota předaná do volání metody nebo funkce, například `360.0` z `drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)`.

Příklad zadání metody#

řídit#

drive pohybuje robotem vpřed nebo vzad navždy. Robot se bude pohybovat, dokud nedostane další akci, například otočení nebo zastavení. Pro otáčky za minutu nebo stupně za sekundu se limit mění převodovým poměrem hnacího ústrojí.

Usage:
drivetrain.drive(direction, velocity, units)

Parametry	Popis
`direction`	Směr pohybu robota: `FORWARD` nebo `REVERSE`.
`velocity`	Volitelné. Rychlost, s níž se má robot pohybovat, od 0 % do 100 % při použití `PERCENT`, od 0 do 600 ot/min při použití `RPM`nebo od 0 do 3600 stupňů za sekundu při použití `VelocityUnits.DPS`. Může se jednat o celé číslo `integer` nebo desetinné číslo (`float`). Pokud není zadána žádná rychlost, robot se pohybuje aktuální rychlostí pohonu.
`units`	Volitelné. Jednotka rychlosti: `RPM` (otáčky za minutu, výchozí), `PERCENT`nebo `VelocityUnits.DPS` (stupně za sekundu).

# Drive forward, then stop
drivetrain.drive(FORWARD)
wait(2, SECONDS)
drivetrain.stop()

# Drive forward at 360 degrees per second
drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)