Python#

„VEX CTE 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“ „Python“ projektuose. „Blocks“ projektuose vietoj jų naudojama „Blocks“ API skiltis.

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., `arm.move_inc(…)`.
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., `x_target = 120`.
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. `100` in `arm.move_inc(0, 100, 0)`.

Metodo įvedimo pavyzdys#

move_inc#

move_inc perkelia 6 ašių svirtį nurodytu atstumu išilgai x, y ir z ašių.

Šis metodas grąžins loginę reikšmę, rodančią, ar 6 ašių svirtis pasiekė pageidaujamą padėtį:

True – 6 ašių svirtis pasiekė pageidaujamą padėtį.
False – 6 ašių svirtis negali pasiekti pageidaujamos padėties.

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

Parametras	Aprašymas
x	Atstumas, kurį reikia judėti išilgai x ašies, milimetrais.
y	Atstumas, kurį reikia judėti išilgai y ašies, milimetrais.
z	Atstumas, kurį reikia judėti z ašimi, milimetrais.
`wait`	Pasirinktinai. `wait=True` (numatytasis) – projektas laukia, kol bus baigtas `move_inc` prieš vykdant kitą kodo eilutę. `wait=False` – projektas pradeda veiksmą ir iš karto pereina prie kitos kodo eilutės, nelaukdamas, kol `move_inc` bus baigtas.

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