Python#

A VEX V5 Python API referencia elmagyarázza az egyes parancsok, metódusok és függvények működését, a bemeneteket, a visszaadott értékeket és a projektben való felhasználásuk módját.

Ezt a referenciát akkor használd, ha egy parancsot meg szeretnél érteni, mielőtt hozzáadnád egy projekthez, ellenőrizni szeretnéd, hogy milyen értékeket fogad el vagy ad vissza, vagy összehasonlítani szeretnéd a kapcsolódó parancsokat egy kategóriában.

A VEXcode V5 Python projektekben Python parancsokat használnak. A blokkok és a C++ projektek helyett a többi API szakaszt használják.

Hogyan olvassunk el egy metódusbejegyzést#

A legtöbb Python bejegyzés a következő részeket tartalmazza:

Parancs neve – A parancs, metódus vagy függvény hivatalos neve.
Leírás – Elmagyarázza, hogy mit csinál a parancs, és mikor hasznos.
Használat – Megjeleníti a parancs kódban való írásához használt szintaxist.
Paraméterek – Felsorolja a parancs által elfogadott bemeneteket, és elmagyarázza, hogy mit csinálnak.
Visszatérési érték – Elmagyarázza, hogy mit jelent vissza a parancs, ha értéket ad vissza.
Példakód – Bemutat egy módot, ahogyan a parancs használható egy projektben.

Gyakori Python API elemek#

Elem	Mit jelent
Módszer	Egy parancs meghívása egy objektumon, például `drivetrain.drive(…)`.
Funkció	Egy közvetlenül meghívott parancs, például `wait(…)` vagy `print(…)`.
Paraméter	Egy metódusnak vagy függvénynek átadott érték, amely a műveletét szabályozza.
Választható paraméter	Egy paraméter, amelyet ki lehet hagyni, így az alapértelmezett viselkedés lesz érvényben.
Visszatérési érték	Egy parancs által visszaadott érték, például szám, szöveg vagy logikai érték.

Alapvető Python szókincs#

Kifejezés	Mit jelent
Változó	Egy olyan név, amely értéket tárol, például `speed = 50`.
Húr	Idézőjelek között lévő szöveg, például `“Hello”`.
Egész szám	Pozitív vagy negatív szám, például `90`.
Úszó	Tizedesjegyet tartalmazó szám, például `25.5`.
Logikai	Egy olyan érték, amely vagy `True` , vagy `False`.
Érv	Egy metódus- vagy függvényhívásnak átadott érték, például `360.0` in `drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)`.

Példa metódusbevitelre#

hajtás#

drive örökre előre vagy hátra mozgatja a robotot. A robot addig mozog, amíg egy másik műveletet nem kap, például fordulást vagy megállást. A fordulatszám vagy a másodpercenkénti fokszám határértékét a hajtáslánc áttétele változtatja.

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

Paraméterek	Leírás
`direction`	A robot mozgásiránya: `FORWARD` vagy `REVERSE`.
`velocity`	Opcionális. A robot által vezérelt sebesség 0%-tól 100%-ig `PERCENT`használata esetén, 0-tól 600 rpm-ig `RPM`használata esetén, vagy 0-tól 3600 fok/másodpercig `VelocityUnits.DPS`használata esetén. Ez lehet egy `integer` vagy decimális szám (`float`). Ha nincs megadva sebesség, a robot az aktuális sebességgel halad.
`units`	Opcionális. A sebesség mértékegysége: `RPM` (percenkénti fordulatszám, alapértelmezett), `PERCENT`vagy `VelocityUnits.DPS` (fok másodpercenként).

# 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)