Python#

VEX V5 Python API Referansı, her komutun, metodun ve fonksiyonun ne yaptığını, hangi girdileri kullandığını, ne döndürdüğünü ve bir projede nasıl kullanılabileceğini açıklar.

Bir komutu projeye eklemeden önce anlamak, kabul ettiği veya döndürdüğü değerleri kontrol etmek veya bir kategorideki ilgili komutları karşılaştırmak istediğinizde bu referansı kullanın.

VEXcode V5 Python projelerinde Python komutları kullanılır. Bloklar ve C++ projeleri ise bunun yerine diğer API bölümlerini kullanır.

Bir Metot Girişini Nasıl Okuyabilirsiniz?#

Python kod girdilerinin çoğu aşağıdaki bölümleri içerir:

  • Komut adı - Komutun, metodun veya fonksiyonun resmi adı.

  • Açıklama - Komutun ne işe yaradığını ve ne zaman kullanışlı olduğunu açıklar.

  • Kullanım - Komutu kodda yazmak için kullanılan sözdizimini gösterir.

  • Parametreler - Komutun kabul ettiği girdileri listeler ve her birinin ne işe yaradığını açıklar.

  • Dönüş değeri - Komutun bir değer döndürmesi durumunda, ne bildirdiğini açıklar.

  • Örnek kod - Komutun bir projede nasıl kullanılabileceğini gösterir.

Python API’sinin Ortak Öğeleri#

Element

Anlamı

Yöntem

drivetrain.drive(…) gibi bir nesne üzerinde çağrılan bir komut.

İşlev

Doğrudan çağrılan bir komut, örneğin wait(…) veya print(…).

Parametre

Bir metodun veya fonksiyonun ne yapacağını kontrol etmek için ona iletilen değer.

İsteğe bağlı parametre

Varsayılan davranışın kullanılmasını sağlamak için atlanabilen bir parametre.

Dönüş değeri

Bir komutun döndürdüğü değer; örneğin sayı, metin veya Boolean değer.

Temel Python Sözlüğü#

Terim

Anlamı

Değişken

Bir değeri saklayan bir isim, örneğin speed = 50.

Sicim

Tırnak içindeki metin, örneğin “Hello”.

Tamsayı

90 gibi pozitif veya negatif bir sayı.

Batmadan yüzmek

25.5 gibi ondalıklı bir sayı.

Mantıksal (Boolean)

True veya False değerlerinden birini alan bir değer.

Argüman

Bir metoda veya fonksiyon çağrısına geçirilen değer, örneğin 360.0 in drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS).

Örnek Yöntem Girişi#

sürmek#

drive robotu sonsuza dek ileri veya geri hareket ettirir. Robot, dönme veya durma gibi başka bir işlem verilene kadar hareket etmeye devam edecektir. Devir sayısı (RPM) veya saniyedeki derece sayısı için limit, tahrik sisteminin dişli oranına göre değişir.

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

Parametreler

Tanım

direction

Robotun hareket yönü: FORWARD veya REVERSE.

velocity

Optional. The velocity to drive with from 0% to 100% when using PERCENT, from 0 to 600 rpm when using RPM, or from 0 to 3600 degrees per second when using VelocityUnits.DPS. This can be an integer or decimal (float). If no velocity is provided, the robot drives at the current drive velocity.

units

İsteğe bağlı. Hız birimi: RPM (dakikadaki dönüş sayısı, varsayılan), PERCENTveya VelocityUnits.DPS (saniyede derece).

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