Python#

Referenční příručka k Python API pro VEX IQ (2. generace) 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 Pythonu VEXcode IQ (2. generace). Projekty Blocks a C++ místo toho používají jiné sekce API.

Poznámka: IQ Brain (2. generace) spouští Python na virtuálním počítači s omezenou pamětí. I když existuje maximální velikost zdrojového kódu, běh programu závisí také na jeho složitosti (například na počtu použitých funkcí, proměnných a logiky). V důsledku toho se může stát, že velké nebo složité programy selžou při kompilaci nebo spuštění, i když nedosahují limitu velikosti. Programy v jazyce C/C++ jsou těmito omezeními na IQ (2. generace) obecně méně ovlivněny.

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á volání metody nebo funkce, například `REVERSE` z `drivetrain.drive(REVERSE, 20, PERCENT)`.

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í.

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 120 ot/min při použití `RPM`nebo od 0 do 720 stupňů za sekundu při použití `VelocityUnits.DPS`. Může to být celé číslo `integer` nebo desetinné číslo (`float`). Pokud není zadána žádná rychlost, robot se pohybuje aktuální rychlostí pohonu.
`units`	Volitelné. Jednotka rychlosti: `PERCENT` (výchozí), `RPM` (otáčky za minutu) nebo `VelocityUnits.DPS` (stupně za sekundu).

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

# Drive slowly in reverse then stop
drivetrain.drive(REVERSE, 20, PERCENT)
wait(2, SECONDS)
drivetrain.stop()