Python#

„VEX V5 Python API“ nuorodoje paaiškinama, ką daro kiekviena komanda, metodas ir funkcija, kokias įvestis jie naudoja, ką grąžina ir kaip juos galima naudoti projekte.

Šią nuorodą naudokite, kai norite suprasti komandą prieš ją įtraukdami į projektą, patikrinti, kokias reikšmes ji priima arba grąžina, arba palyginti susijusias komandas kategorijoje.

„Python“ komandos naudojamos „VEXcode V5 Python“ projektuose. Blokų ir C++ projektuose vietoj jų naudojamos kitos API dalys.

Kaip skaityti metodo įrašą#

Daugumą „Python“ įrašų sudaro šios dalys:

Komandos pavadinimas – oficialus komandos, metodo arba funkcijos pavadinimas.
Aprašymas – Paaiškina, ką komanda daro ir kada ji naudinga.
Naudojimas – rodo sintaksę, naudojamą komandai rašyti kode.
Parametrai – Pateikia komandos priimamų įvesčių sąrašą ir paaiškina kiekvienos iš jų funkciją.
Grąžina reikšmę – Paaiškina, ką komanda praneša, jei grąžina reikšmę.
Pavyzdinis kodas – parodo vieną iš būdų, kaip komanda gali būti naudojama projekte.

Įprasti Python API elementai#

Elementas	Ką tai reiškia
Metodas	Komanda, iškviesta objektui, pvz., `drivetrain.drive(…)`.
Funkcija	Tiesiogiai iškviečiama komanda, pvz. `wait(…)` arba `print(…)`.
Parametras	Reikšmė, perduodama metodui arba funkcijai, siekiant valdyti jo veiksmus.
Pasirinktinis parametras	Parametras, kurio galima praleisti, kad būtų naudojamas numatytasis veikimas.
Grąžinimo vertė	Komandos pateikiama reikšmė, pvz., skaičius, tekstas arba loginė reikšmė.

Pagrindinis Python žodynas#

Terminas	Ką tai reiškia
Kintamasis	Pavadinimas, kuriame saugoma reikšmė, pvz., `speed = 50`.
Eilutė	Tekstas kabutėse, pvz., `“Hello”`.
Sveikasis skaičius	Teigiamas arba neigiamas skaičius, pvz. `90`.
Plūduriuojantis	Skaičius su dešimtainiu tikslumu, pvz., `25.5`.
Būlio	Reikšmė, kuri yra `True` arba `False`.
Argumentas	Reikšmė, perduota metodo arba funkcijos iškvietimui, pvz. `360.0` in `drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)`.

Metodo įvedimo pavyzdys#

vairuoti#

drive robotą judina pirmyn arba atgal amžinai. Robotas judės tol, kol jam bus duotas kitas veiksmas, pvz., pasisukti arba sustoti. Aps./min. arba laipsnių per sekundę riba keičiama pagal pavaros perdavimo skaičių.

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

Parametrai	Aprašymas
`direction`	Roboto judėjimo kryptis: `FORWARD` arba `REVERSE`.
`velocity`	Pasirinktinai. Važiavimo greitis nuo 0 % iki 100 %, kai naudojama `PERCENT`, nuo 0 iki 600 aps./min., kai naudojama `RPM`, arba nuo 0 iki 3600 laipsnių per sekundę, kai naudojama `VelocityUnits.DPS`Tai gali būti sveikasis skaičius `integer` arba dešimtainis skaičius (`float`). Jei greitis nenurodytas, robotas važiuoja dabartiniu važiavimo greičiu.
`units`	Pasirinktinai. Greičio vienetas: `RPM` (apsisukimai per minutę, numatytoji reikšmė), `PERCENT`arba `VelocityUnits.DPS` (laipsniai per sekundę).

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