Python#

Referensi API Python VEX IQ (generasi ke-2) menjelaskan apa yang dilakukan oleh setiap perintah, metode, dan fungsi, input apa yang digunakan, apa yang dikembalikan, dan bagaimana cara menggunakannya dalam sebuah proyek.

Gunakan referensi ini ketika Anda ingin memahami suatu perintah sebelum menambahkannya ke proyek, memeriksa nilai apa yang diterima atau dikembalikan, atau membandingkan perintah terkait dalam suatu kategori.

Perintah Python digunakan dalam proyek Python VEXcode IQ (generasi ke-2). Proyek Blocks dan C++ menggunakan bagian API lainnya.

Catatan: IQ (generasi ke-2) Brain menjalankan Python melalui mesin virtual dengan memori terbatas. Meskipun ada ukuran kode sumber maksimum, apakah suatu program akan berjalan juga bergantung pada kompleksitasnya (seperti jumlah fungsi, variabel, dan logika yang digunakan). Akibatnya, program yang besar atau kompleks mungkin gagal dikompilasi atau dijalankan meskipun ukurannya di bawah batas. Program C/C++ umumnya kurang terpengaruh oleh batasan ini pada IQ (generasi ke-2).

Cara Membaca Entri Metode#

Sebagian besar entri Python mencakup bagian-bagian berikut:

Nama perintah - Nama resmi dari perintah, metode, atau fungsi.
Deskripsi - Menjelaskan fungsi perintah dan kapan perintah tersebut berguna.
Penggunaan - Menunjukkan sintaks yang digunakan untuk menulis perintah dalam kode.
Parameter - Mencantumkan input yang diterima oleh perintah dan menjelaskan fungsi masing-masing input.
Nilai kembalian - Menjelaskan apa yang dilaporkan oleh perintah, jika perintah tersebut mengembalikan nilai.
Contoh kode - Menunjukkan salah satu cara perintah ini dapat digunakan dalam sebuah proyek.

Elemen API Python Umum#

Elemen	Apa artinya
Metode	Perintah yang dipanggil pada suatu objek seperti `drivetrain.drive(…)`.
Fungsi	Perintah yang dipanggil secara langsung, seperti `wait(…)` atau `print(…)`.
Parameter	Nilai yang diteruskan ke suatu metode atau fungsi untuk mengontrol apa yang dilakukannya.
Parameter opsional	Parameter yang dapat diabaikan sehingga perilaku default yang digunakan.
Nilai kembalian	Nilai yang dilaporkan kembali oleh suatu perintah, seperti angka, teks, atau Boolean.

Kosakata Dasar Python#

Ketentuan	Apa artinya
Variabel	Nama yang menyimpan nilai, seperti `speed = 50`.
Rangkaian	Teks di dalam tanda kutip, seperti `“Hello”`.
Bilangan bulat	Angka positif atau negatif, seperti `90`.
Mengambang	Angka dengan desimal, seperti `25.5`.
Boolean	Nilai yang berupa `True` atau `False`.
Argumen	Nilai yang diteruskan ke panggilan metode atau fungsi, seperti `REVERSE` in `drivetrain.drive(REVERSE, 20, PERCENT)`.

Contoh Entri Metode#

menyetir#

Perintah drive menggerakkan robot maju atau mundur tanpa henti. Robot akan terus bergerak hingga diberi perintah lain, seperti berbelok atau berhenti.

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

Parameter	Keterangan
`direction`	Arah pergerakan robot: `FORWARD` atau `REVERSE`.
`velocity`	Opsional. Kecepatan penggerak dari 0% hingga 100% saat menggunakan `PERCENT`, dari 0 hingga 120 rpm saat menggunakan `RPM`, atau dari 0 hingga 720 derajat per detik saat menggunakan `VelocityUnits.DPS`Ini dapat berupa bilangan bulat `integer` (bilangan pecahan`float`). Jika tidak ada kecepatan yang diberikan, robot akan bergerak dengan kecepatan penggerak saat ini.
`units`	Opsional. Satuan kecepatan: `PERCENT` (standar), `RPM` (putaran per menit), atau `VelocityUnits.DPS` (derajat per detik).

# Drive forward then stop
drivetrain.drive(FORWARD)
wait(2, SECONDS)
drivetrain.stop()

# Drive slowly in reverse then stop
drivetrain.drive(REVERSE, 20, PERCENT)
wait(2, SECONDS)
drivetrain.stop()