Pengontrol

Perkenalan

Kontroler V5 memiliki tombol, dua joystick, motor getar, dan layar. Blok kontroler dapat digunakan untuk memeriksa penekanan tombol, membaca pergerakan joystick, menggetarkan kontroler, mengaktifkan atau menonaktifkan tindakan kontroler yang telah dikonfigurasi, menjalankan blok saat terjadi peristiwa pada kontroler, atau menampilkan teks pada layar kontroler.

Aksi Controller yang dikonfigurasi adalah perilaku controller yang diatur di menu Perangkat. Gunakan blok Aktifkan/Nonaktifkan Controller untuk sementara mengaktifkan atau menonaktifkan aksi yang dikonfigurasi tersebut selama proyek berlangsung.

Berikut adalah daftar blok yang tersedia:

Nilai — Periksa status tombol kontroler atau baca posisi joystick.

• Apakah tombol Controller ditekan? — Mengembalikan nilai boolean yang menunjukkan apakah tombol Controller yang dipilih sedang ditekan.

• Posisi pengontrol — Mengembalikan posisi joystick di sepanjang sumbu yang dipilih.

Aksi — Getarkan Controller, aktifkan/nonaktifkan aksi Controller yang telah dikonfigurasi, atau jalankan blok saat input Controller berubah.

• putar getaran pada kontroler — Memainkan pola getaran pada Kontroler.

• Aktifkan/Nonaktifkan Pengontrol — Mengaktifkan atau menonaktifkan tindakan Pengontrol yang dikonfigurasi di menu Perangkat untuk semua pengontrol yang terhubung.

• ketika tombol Controller ditekan — Menjalankan tumpukan terlampir ketika tombol yang dipilih ditekan atau dilepaskan.

• ketika sumbu pengontrol diubah — Menjalankan tumpukan terlampir ketika posisi joystick berubah di sepanjang sumbu yang dipilih.

Layar — Menampilkan teks dan angka pada layar Pengontrol.

• print on controller — Menampilkan teks, angka, atau nilai variabel pada layar Controller.

• atur kursor ke baris kolom pada pengontrol — Memindahkan kursor ke baris dan kolom yang ditentukan pada layar Pengontrol.

• atur kursor ke baris berikutnya pada pengontrol — Memindahkan kursor ke baris berikutnya pada layar Pengontrol.

• atur presisi cetak pada pengontrol — Mengatur berapa banyak tempat desimal yang ditampilkan saat angka dicetak pada layar Pengontrol.

• clear controller — Menghapus semua baris pada layar Controller.

• bersihkan baris pada pengontrol — Membersihkan satu baris pada layar Pengontrol.

Nilai-nilai

Tombol kontrol ditekan?

Blok Boolean Controller pressed? mengembalikan nilai boolean yang menunjukkan apakah tombol Controller yang dipilih sedang ditekan.

Pengontrol ditekan? Blok Boolean

<[Controller1 v] [▲ v] ditekan?>

Parameter	Keterangan
perangkat	Pengontrol yang akan digunakan, dikonfigurasi di jendela Perangkat.
tombol	Tombol untuk memeriksa: ▲ ▼ ◀ ▶ X B Y A L1 L2 R1 R2

Contoh

Saat dinyalakan, kendaraan akan bergerak maju selama tombol X ditekan.

saat dimulai
[Drive forward while X is pressed.]
selamanya
jika <[Controller1 v] [X v] ditekan?> maka
kendarai [maju v]
lainnya
hentikan mengemudi
selesai
selesai

Posisi pengontrol

Blok pelapor Posisi pengontrol mengembalikan posisi joystick di sepanjang sumbu yang dipilih sebagai angka dari -100 hingga 100.

Blok pelapor posisi pengontrol

([Controller1 v] [1 v] position :: sensing)

Parameter	Keterangan
perangkat	Pengontrol yang akan digunakan, dikonfigurasi di jendela Perangkat.
sumbu	Sumbu joystick yang akan dilaporkan: 1 — sumbu horizontal joystick kanan 2 — sumbu vertikal joystick kanan 3 — sumbu vertikal joystick kiri 4 — sumbu horizontal joystick kiri

Contoh

Saat dinyalakan, kendaraan akan bergerak maju selama joystick kiri ditekan ke atas.

saat dimulai
[Drive forward while the left joystick is pushed up.]
selamanya
jika <([Controller1 v] [3 v] position :: sensing) [math_greater_than v] [0]> maka
kendarai [maju v]
lainnya
hentikan mengemudi
selesai
selesai

Tindakan

mainkan rumble pada controller

Blok tumpukan putar getaran pada pengontrol memainkan pola getaran pada pengontrol.

mainkan rumble di controller stack block

putar getar [Panjang v] pada [Controller1 v]

Parameter	Keterangan
pola	Pola getaran untuk dimainkan pada Controller: Panjang — satu getaran panjang Pendek — satu getaran pendek Pulsa — pola getaran hidup dan mati
perangkat	Pengontrol yang akan digunakan, dikonfigurasi di jendela Perangkat.

Contoh

Saat tombol R1 ditekan, akan terdengar getaran singkat pada kontroler.

saat tombol[Controller1 v] [R1 v] [ditekan v] :: hat events
putar getar [Pendek v] pada [Controller1 v]

Mengaktifkan/menonaktifkan pengontrol

Blok tumpukan Pengaktifan/Penonaktifan Pengontrol mengaktifkan atau menonaktifkan tindakan yang dikonfigurasi Pengontrol dari menu Perangkat untuk semua pengontrol yang terhubung.

Pengontrol mengaktifkan/menonaktifkan blok tumpukan

Controller [Nonaktifkan v]

Parameter	Keterangan
negara	Controller yang dikonfigurasi memiliki status aksi: Nonaktifkan atau Aktifkan.

Contoh

Saat diaktifkan, menonaktifkan tindakan Controller yang telah dikonfigurasi saat robot bergerak maju.

saat dimulai
[Disable Controller configured actions until the drive movement is done.]
Controller [Nonaktifkan v]
kendarai [maju v] sejauh (6) [inci v] ▶
Controller [Aktifkan v]

saat tombol Kontroler ditekan

Blok Hat when Controller button pressed menjalankan tumpukan yang terhubung ketika tombol Pengontrol yang dipilih ditekan atau dilepaskan.

Saat tombol pengontrol ditekan, blok topi

saat tombol[Controller1 v] [▲ v] [ditekan v] :: hat events

Parameter	Keterangan
perangkat	Pengontrol yang akan digunakan, dikonfigurasi di jendela Perangkat.
tombol	Tombol untuk memeriksa: ▲ ▼ ◀ ▶ X B Y A L1 L2 R1 R2
status tombol	Kejadian tombol yang memicu tumpukan terlampir: ditekan atau dilepas.

Contoh

Saat tombol R1 ditekan, akan bergerak maju sejauh 200 milimeter.

saat tombol[Controller1 v] [R1 v] [ditekan v] :: hat events
[Drive forward when R1 is pressed.]
kendarai [maju v] sejauh (200) [mm v] ▶

saat sumbu pengontrol diubah

Blok Hat when Controller axis is changed menjalankan tumpukan yang terhubung ketika posisi joystick berubah di sepanjang sumbu yang dipilih.

Saat sumbu pengontrol diubah, blok topi

when [Controller1 v] axis [1 v] is changed :: hat events

Parameter	Keterangan
perangkat	Pengontrol yang akan digunakan, dikonfigurasi di jendela Perangkat.
sumbu	Sumbu joystick yang perlu diperiksa: 1 — sumbu horizontal joystick kanan 2 — sumbu vertikal joystick kanan 3 — sumbu vertikal joystick kiri 4 — sumbu horizontal joystick kiri

Contoh

Saat posisi joystick berubah sepanjang sumbu Controller 3, kendaraan akan bergerak maju sejauh 200 milimeter.

when [Controller1 v] axis [3 v] is changed :: hat events
[Drive forward when the joystick's position changes along axis 3.]
kendarai [maju v] sejauh (200) [mm v] ▶

Layar

cetak pada pengontrol

Blok tumpukan print on controller menampilkan teks, angka, atau nilai variabel pada layar Controller di posisi kursor saat ini.

cetak pada blok tumpukan pengontrol

cetak [VEXcode] pada [Controller1 v] ▶ :: custom-controller-inertial-timer

Parameter	Keterangan
nilai	Teks, angka, atau nilai variabel yang akan ditampilkan pada layar Controller.
perangkat	Pengontrol yang akan digunakan, dikonfigurasi di jendela Perangkat.
panah yang melebar	Memperluas blok untuk menyertakan dan mengatur kursor ke baris berikutnya, yang memindahkan kursor ke baris berikutnya setelah nilai dicetak. Jika opsi ini tidak digunakan, nilai yang dicetak berikutnya akan muncul segera setelah nilai sebelumnya pada baris yang sama.

Contoh

Saat dinyalakan, akan menampilkan pesan di layar Controller.

saat dimulai
[Display a message on the Controller screen.]
cetak [Hello, robot!] pada [Controller1 v] ▶ :: custom-controller-inertial-timer

Atur kursor ke baris kolom pada controller.

Blok tumpukan set cursor to row column on controller memindahkan kursor ke baris dan kolom tertentu pada layar Controller. Nilai yang dicetak berikutnya akan muncul di posisi tersebut.

Atur kursor ke baris kolom pada blok tumpukan pengontrol.

atur kursor ke baris [1] kolom [1] pada [Controller1 v] :: custom-controller-inertial-timer

Parameter	Keterangan
baris	Baris tempat kursor akan dipindahkan pada layar Controller.
kolom	Kolom tempat kursor akan dipindahkan pada layar Controller.
perangkat	Pengontrol yang akan digunakan, dikonfigurasi di jendela Perangkat.

Contoh

Saat dijalankan, akan mencetak teks pada baris 2, kolom 1 di layar Controller.

saat dimulai
[Display a message on row 2.]
atur kursor ke baris [2] kolom [1] pada [Controller1 v] :: custom-controller-inertial-timer
cetak [Ready] pada [Controller1 v] ▶ :: custom-controller-inertial-timer

Atur kursor ke baris berikutnya pada controller.

Blok tumpukan atur kursor ke baris berikutnya pada pengontrol memindahkan kursor ke kolom 1 pada baris berikutnya di layar Pengontrol. Nilai yang dicetak berikutnya akan muncul pada baris tersebut.

Atur kursor ke baris berikutnya pada blok tumpukan pengontrol.

atur kursor ke baris berikutnya pada [Controller1 v] :: custom-controller-inertial-timer

Parameter	Keterangan
perangkat	Pengontrol yang akan digunakan, dikonfigurasi di jendela Perangkat.

Contoh

Saat dijalankan, akan mencetak dua baris pada layar Controller.

saat dimulai
[Display two rows of text.]
cetak [Row 1] pada [Controller1 v] ▶ :: custom-controller-inertial-timer
atur kursor ke baris berikutnya pada [Controller1 v] :: custom-controller-inertial-timer
cetak [Row 2] pada [Controller1 v] ▶ :: custom-controller-inertial-timer

Atur presisi pencetakan pada pengontrol.

Blok tumpukan set print precision on controller mengatur berapa banyak tempat desimal yang ditampilkan saat angka dicetak di layar Controller. Pengaturan ini berlaku untuk angka yang dicetak setelah blok ini digunakan.

Atur presisi pencetakan pada blok tumpukan pengontrol.

atur presisi cetak ke [0.1 v] pada [Controller1 v] :: custom-controller-inertial-timer

Parameter	Keterangan
presisi	Tingkat presisi cetak yang digunakan: 1 — tanpa angka desimal 0.1 — 1 angka desimal 0.01 — 2 angka desimal 0.001 — 3 angka desimal Semua Angka — semua angka desimal yang tersedia
perangkat	Pengontrol yang akan digunakan, dikonfigurasi di jendela Perangkat.

Contoh

Saat dinyalakan, akan menampilkan 1/3 dengan dua angka desimal pada layar Controller.

saat dimulai
[Display 1/3 with two decimals.]
atur presisi cetak ke [0.01 v] pada [Controller1 v] :: custom-controller-inertial-timer
cetak ([1] [math_division v] [3]) pada [Controller1 v] ▶ :: custom-controller-inertial-timer

pengontrol yang jelas

Blok tumpukan clear controller menghapus semua baris pada layar Controller dan memindahkan kursor kembali ke baris pertama.

bersihkan blok tumpukan pengontrol

hapus [Controller1 v] :: custom-controller-inertial-timer

Parameter	Keterangan
perangkat	Pengontrol yang akan digunakan, dikonfigurasi di jendela Perangkat.

Contoh

Saat dijalankan, akan mencetak teks, menunggu, lalu membersihkan layar Controller.

saat dimulai
[Clear the Controller screen after printing.]
cetak [This will disappear...] pada [Controller1 v] ▶ :: custom-controller-inertial-timer
tunggu [2] detik
hapus [Controller1 v] :: custom-controller-inertial-timer

hapus baris pada pengontrol

Blok tumpukan clear row on controller membersihkan satu baris pada layar Controller.

Hapus baris pada blok tumpukan pengontrol.

hapus baris [1] pada [Controller1 v] :: custom-controller-inertial-timer

Parameter	Keterangan
baris	Baris yang perlu dikosongkan pada layar Controller.
perangkat	Pengontrol yang akan digunakan, dikonfigurasi di jendela Perangkat.

Contoh

Saat dijalankan, akan menghapus baris 1 pada layar Controller.

saat dimulai
[Clear one row on the Controller screen.]
cetak [Row 1] pada [Controller1 v] ▶ :: custom-controller-inertial-timer
atur kursor ke baris berikutnya pada [Controller1 v] :: custom-controller-inertial-timer
cetak [Row 2] pada [Controller1 v] ▶ :: custom-controller-inertial-timer
tunggu [2] detik
hapus baris [1] pada [Controller1 v] :: custom-controller-inertial-timer