Python#

Referenční příručka VEX CTE 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 Python. Projekty Blocks místo toho používají sekci Blocks 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 `arm.move_inc(…)`.
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 `x_target = 120`.
Ř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 `100` v `arm.move_inc(0, 100, 0)`.

Příklad zadání metody#

move_inc#

move_inc posune 6osé rameno o zadanou vzdálenost podél os x, y a z.

Tato metoda vrátí booleovskou hodnotu označující, zda 6osé rameno dosáhlo požadované polohy:

True - 6osé rameno dosáhlo požadované polohy.
False - 6osé rameno nemůže dosáhnout požadované polohy.

Usage:
arm.move_inc(x, y, z, wait)

Parametr	Popis
x	Vzdálenost, o kterou se má posunout podél osy x v milimetrech.
y	Vzdálenost, o kterou se má posunout podél osy y v milimetrech.
z	Vzdálenost, o kterou se má posunout podél osy z v milimetrech.
`wait`	Volitelné. `wait=True` (výchozí) - Projekt čeká na dokončení `move_inc` před provedením dalšího řádku kódu. `wait=False` - Projekt spustí akci a ihned přejde na další řádek kódu, aniž by čekal na dokončení `move_inc`

# Move the Arm +100 millimeters on the y-axis
arm.move_inc(0, 100, 0)