Python#

Referensi API Python VEX CTE menjelaskan apa yang dilakukan oleh setiap perintah, metode, dan fungsi, input apa yang digunakannya, apa yang dikembalikannya, 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. Proyek Blocks menggunakan bagian API Blocks sebagai gantinya.

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 arm.move_inc(…).

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 x_target = 120.

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 100 in arm.move_inc(0, 100, 0).

Contoh Entri Metode#

pindah_inc#

move_inc menggerakkan Lengan 6-Axis sejauh jarak tertentu di sepanjang sumbu x, y, dan z.

Metode ini akan mengembalikan nilai Boolean yang menunjukkan apakah Lengan 6-Axis telah mencapai posisi yang diminta:

  • True - Lengan 6-Axis telah mencapai posisi yang diminta.

  • False - Lengan 6-Axis tidak dapat mencapai posisi yang diminta.

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

Parameter

Keterangan

X

Jarak yang ditempuh sepanjang sumbu x dalam milimeter.

y

Jarak yang ditempuh sepanjang sumbu y dalam milimeter.

z

Jarak yang ditempuh sepanjang sumbu z dalam milimeter.

wait

Opsional.

  • wait=True (default) - Proyek menunggu hingga move_inc selesai sebelum mengeksekusi baris kode berikutnya.
  • wait=False - Proyek memulai aksi dan langsung melanjutkan ke baris kode berikutnya, tanpa menunggu move_inc selesai.

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