Python#

De VEXcode VR Python API-referentie legt uit wat elk commando, elke methode en elke functie doet, welke invoer 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 VR Python-projecten worden Python-commando’s gebruikt. Blocks-projecten gebruiken in plaats daarvan de Blocks API-sectie.

De Python-commando’s in VEXcode VR kunnen afhangen van de Playground en de robot die je gebruikt. Sommige robots bevatten unieke methoden die niet in elke Playground voorkomen.

Speeltuinen en robots in VR#

Gebruik de sectie Playgrounds om te zien welke robot in elke Playground wordt gebruikt en om Playground-specifieke configuratiegegevens, veldinformatie en de context van de uitdaging te vinden.

Gebruik de sectie Robots om robotspecifieke Python-pagina’s te vinden voor robots met unieke methoden. De Robots-pagina’s tonen ook in welke Playgrounds elke robot wordt gebruikt, zodat je kunt zien wanneer een robotspecifieke methode beschikbaar is in je project.

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 drivetrain.rotation(…).

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 angle = 90.

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 DEGREES in drivetrain.rotation(DEGREES).

Voorbeeld van methode-invoer#

rotatie#

Rotatie geeft aan hoeveel de robot is gedraaid, gemeten in graden. Aan het begin van een project wordt de rotatiewaarde ingesteld op 0 graden. rotation geeft de huidige rotatie van de robot weer.

Naar rechts draaien vergroot de rotatie, en naar links draaien verkleint de rotatie. Twee volledige draaien naar rechts resulteren bijvoorbeeld in een rotatie van 720 graden.

Usage:
drivetrain.rotation(units)

Parameters

Beschrijving

units

Optioneel. De rotatie-eenheid: DEGREES (standaard).

def main():
    # Display the rotation after turning
    drivetrain.turn_for(RIGHT, 450, DEGREES)
    brain.print("Rotation: ")
    brain.print(drivetrain.rotation(DEGREES))

# VR threads - Do not delete
vr_thread(main)