Python#

VEX CTE Python API Reference selittää, mitä kukin komento, metodi ja funktio tekee, mitä syötteitä ne käyttävät, mitä ne palauttavat ja miten niitä voidaan käyttää projektissa.

Käytä tätä viitettä, kun haluat ymmärtää komennon ennen sen lisäämistä projektiin, tarkistaa sen hyväksymät tai palauttamat arvot tai vertailla toisiinsa liittyviä komentoja kategoriassa.

Python-komentoja käytetään VEXcode Python -projekteissa. Blocks-projektit käyttävät sen sijaan Blocks API -osiota.

Metodimerkinnän lukeminen#

Useimmat Python-merkinnät sisältävät seuraavat osat:

Komennon nimi - Komennon, metodin tai funktion virallinen nimi.
Kuvaus - Selittää, mitä komento tekee ja milloin siitä on hyötyä.
Käyttö - Näyttää komennon kirjoittamiseen käytetyn syntaksin koodissa.
Parametrit - Listaa komennon hyväksymät syötteet ja selittää, mitä kukin niistä tekee.
Paluuarvo - Selittää, mitä komento raportoi, jos se palauttaa arvon.
Esimerkkikoodi - Näyttää yhden tavan, jolla komentoa voidaan käyttää projektissa.

Yleisiä Python API -elementtejä#

Elementti	Mitä se tarkoittaa
Menetelmä	Komento, jota kutsutaan objektille, kuten `arm.move_inc(…)`.
Toiminto	Suoraan kutsuttu komento, kuten `wait(…)` tai `print(…)`.
Parametri	Metodille tai funktiolle välitetty arvo, joka ohjaa sen toimintaa.
Valinnainen parametri	Parametri, joka voidaan jättää pois, jolloin käytetään oletustoimintoa.
Palautusarvo	Komennon raportoima arvo, kuten numero, teksti tai totuusarvo.

Pythonin perussanasto#

Termi	Mitä se tarkoittaa
Muuttuja	Nimi, joka tallentaa arvon, kuten `x_target = 120`.
Merkkijono	Teksti lainausmerkkien sisällä, kuten `“Hello”`.
Kokonaisluku	Positiivinen tai negatiivinen luku, kuten `90`.
Kellua	Desimaaliluku, kuten `25.5`.
Totuusarvo	Arvo, joka on joko `True` tai `False`.
Argumentti	Metodiin tai funktiokutsuun välitetty arvo, kuten `100` in `arm.move_inc(0, 100, 0)`.

Esimerkki menetelmän syötteestä#

move_inc#

move_inc siirtää 6-akselista vartta määritetyn matkan x-, y- ja z-akseleiden suuntaisesti.

Tämä metodi palauttaa totuusarvon, joka ilmaisee, onko 6-akselinen varsi saavuttanut pyydetyn asennon:

True - 6-akselinen varsi on saavuttanut pyydetyn asennon.
False - 6-akselinen varsi ei saavuta pyydettyä asentoa.

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

Parametri	Kuvaus
x	X-akselin suuntainen liikematka millimetreinä.
y	Y-akselin suuntainen liikkumamatka millimetreinä.
z	Z-akselin suuntainen liikematka millimetreinä.
`wait`	Valinnainen. `wait=True` (oletus) - Projekti odottaa, kunnes `move_inc` on valmis, ennen seuraavan koodirivin suorittamista. `wait=False` - Projekti aloittaa toiminnon ja siirtyy seuraavalle koodiriville heti odottamatta `move_inc` valmistumista.

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