Python#

De VEX AIM Python API-referentie legt uit wat elk commando, elke methode en elke functie doet, welke invoerwaarden het gebruikt, wat het retourneert en hoe het in een project kan worden gebruikt.

Gebruik deze referentie wanneer u een commando wilt begrijpen voordat u het aan een project toevoegt, wilt controleren welke waarden het accepteert of retourneert, of verwante commando’s in een categorie wilt vergelijken.

In VEXcode AIM Python-projecten worden Python-opdrachten gebruikt. Blocks-projecten gebruiken in plaats daarvan de Blocks API-sectie.

Hoe lees je een methode-invoer?#

De meeste Python-inzendingen bevatten de volgende onderdelen:

Opdrachtnaam - De officiële naam van de opdracht, methode of functie.
Beschrijving - Legt uit wat het commando doet en wanneer het nuttig is.
Gebruik - Toont de syntaxis die gebruikt wordt om de opdracht in code te schrijven.
Parameters - Hier worden de invoerwaarden van het commando weergegeven en wordt uitgelegd wat elke waarde doet.
Retourwaarde - Legt uit wat de opdracht teruggeeft, indien deze een waarde retourneert.
Voorbeeldcode - Laat zien hoe de opdracht in een project gebruikt kan worden.

Veelgebruikte Python API-elementen#

Element	Wat het betekent
Methode	Een commando dat wordt aangeroepen op een object, zoals `robot.move_at(…)`.
Functie	Een direct aangeroepen commando, zoals `wait(…)` of `print(…)`.
Parameter	Een waarde die aan een methode of functie wordt doorgegeven om te bepalen wat deze doet.
Optionele parameter	Een parameter die weggelaten kan worden, zodat het standaardgedrag gebruikt wordt.
Retourwaarde	Een waarde die een commando teruggeeft, zoals een getal, tekst of Booleaanse waarde.

Basiswoordenschat van Python#

Termijn	Wat het betekent
Variabele	Een naam die een waarde opslaat, zoals `speed = 50`.
Snaar	Tekst tussen aanhalingstekens, zoals `“Hello”`.
Geheel getal	Een positief of negatief getal, zoals `90`.
Vlot	Een getal met een decimaal, zoals `25.5`.
Booleaanse waarde	Een waarde die ofwel `True` of `False` is.
Argument	Een waarde die wordt doorgegeven aan een methode- of functieaanroep, zoals `0` in `robot.move_at(0)`.

Voorbeeld van methode-invoer#

bewegen_op#

move_at verplaatst de robot oneindig onder een specifieke hoek. De robot blijft bewegen totdat er een andere actie wordt uitgevoerd, zoals bewegen onder een andere hoek, draaien of stoppen.

Usage:
robot.move_at(angle, velocity, units)

Parameters	Beschrijving
`angle`	De hoek, in graden, waaronder de robot beweegt. Dit kan een geheel getal of een decimaal getal zijn tussen -360 en 360.
`velocity`	Optioneel. De snelheid waarmee de robot beweegt, van 0% tot 100% bij gebruik van `PERCENT`, of van 0 tot 200 millimeter per seconde bij gebruik van `MMPS`Dit kan een geheel getal of een decimaal getal zijn. Als er geen snelheid wordt opgegeven, beweegt de robot met de huidige bewegingssnelheid.
`units`	Optioneel. De snelheidseenheid: `PERCENT` (standaard) of `MMPS` (millimeter per seconde).

# Move forward
robot.move_at(0)