LED Sentuh#

Perkenalan#

VEX IQ Touch LED berfungsi sebagai lampu dan tombol. LED ini dapat menyala dalam berbagai warna untuk memberikan umpan balik, seperti menandakan bahwa robot siap, menunjukkan mode yang dipilih, atau mencocokkan warna yang terdeteksi oleh sensor lain, dan dapat mendeteksi saat disentuh, memungkinkan Anda untuk memulai atau mengubah perilaku robot hanya dengan satu sentuhan.

Halaman ini menggunakan touchled_1 sebagai contoh nama LED Sentuh. Ganti dengan nama yang Anda konfigurasi sendiri sesuai kebutuhan.

Berikut adalah daftar semua metode:

Aksi — Berinteraksi dengan LED Sentuh.

  • pressed — Mendaftarkan fungsi yang akan dipanggil ketika LED Sentuh ditekan.

  • released — Mendaftarkan fungsi yang akan dipanggil ketika LED Sentuh dilepaskan.

  • on — Menyalakan LED Sentuh.

  • off — Mematikan LED Sentuh.

  • toggle — Menyalakan atau mematikan LED Sentuh.

Mutator — Mengubah warna, kecerahan, dan pengaturan LED Sentuh.

  • set_color — Mengatur warna LED Sentuh.

  • set_fade — Mengatur seberapa cepat warna akan memudar satu sama lain.

  • set_brightness — Mengatur kecerahan LED Sentuh.

  • set_blink — Menghidupkan dan mematikan LED Sentuh secara bergantian tanpa batas.

Getter — Mengembalikan data dari LED Sentuh.

  • pressing — Mengembalikan apakah LED Sentuh sedang ditekan.

  • installed — Mengembalikan apakah LED Sentuh terhubung ke Otak.

Konstruktor — Inisialisasi dan konfigurasikan LED Sentuh secara manual.

Tindakan#

pressed#

pressed mendaftarkan fungsi yang akan dipanggil saat LED Sentuh ditekan.

Usage:
touchled_1.pressed(callback, arg)

Parameter

Keterangan

callback

Sebuah fungsi yang telah didefinisikan sebelumnya untuk dieksekusi ketika LED Sentuh ditekan.

arg

Opsional. Sebuah tuple yang berisi argumen untuk diteruskan ke fungsi callback. Lihat Fungsi dengan Parameter untuk informasi lebih lanjut.

# Turn blue while the Touch LED is pressed
def light_blue():
    touchled_1.set_color(Color.BLUE)

touchled_1.pressed(light_blue)

released#

released mendaftarkan fungsi yang akan dipanggil saat LED Sentuh dilepas.

Usage:
touchled_1.released(callback, arg)

Parameter

Keterangan

callback

Sebuah fungsi yang telah didefinisikan sebelumnya untuk dieksekusi ketika LED Sentuh dilepas.

arg

Opsional. Sebuah tuple yang berisi argumen untuk diteruskan ke fungsi callback. Lihat Fungsi dengan Parameter untuk informasi lebih lanjut.

# Turn red when the Touch LED is released
def light_red():
    touchled_1.set_color(Color.RED)

touchled_1.released(light_red)

on#

on akan menyalakan LED Sentuh dengan mengatur kecerahannya menjadi 100%.

Usage:
touchled_1.on(value)

Parameter

Keterangan

value

Opsional. Mengatur warna LED menjadi:

  • Color.RED
  • Color.GREEN
  • Color.BLUE
  • Color.WHITE (default)
  • Color.YELLOW
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED_VIOLET
  • Color.VIOLET
  • Color.BLUE_VIOLET
  • Color.BLUE_GREEN
  • Color.YELLOW_GREEN
  • Color.YELLOW_ORANGE
  • Color.RED_ORANGE
Anda juga dapat menentukan warna khusus.

# Turn green when the robot is moving
touchled_1.on(Color.GREEN)
drivetrain.drive_for(FORWARD, 5)
touchled_1.off()

off#

off mematikan LED Sentuh dengan mengatur kecerahannya menjadi 0%.

Usage:
touchled_1.off()

Parameter

Keterangan

Metode ini tidak memiliki parameter.

# Turn off Touch LED when movement is over
touchled_1.on(Color.GREEN)
drivetrain.drive_for(FORWARD, 5)
touchled_1.off()

toggle#

Tombol toggle menghidupkan atau mematikan LED Sentuh. Jika LED sedang menyala, tombol toggle mengatur kecerahannya menjadi 0%, sehingga LED mati. Jika LED mati, tombol toggle mengatur kecerahannya menjadi 100%, sehingga LED menyala.

Usage:
touchled_1.toggle()

Parameter

Keterangan

Metode ini tidak memiliki parameter.

# Turn the Touch LED off and on
touchled_1.set_color(Color.RED)
while True:
    touchled_1.toggle()
    wait(0.5,SECONDS)

Mutator#

set_color#

set_color mengatur warna LED Sentuh. Jika LED Sentuh belum menyala saat metode ini digunakan, maka kecerahan akan diatur ke 100% untuk menyalakan LED Sentuh.

Usage:
touchled_1.set_color(color)

Parameter

Keterangan

color

Opsional. Mengatur warna LED menjadi:

  • Color.RED
  • Color.GREEN
  • Color.BLUE
  • Color.WHITE (default)
  • Color.YELLOW
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED_VIOLET
  • Color.VIOLET
  • Color.BLUE_VIOLET
  • Color.BLUE_GREEN
  • Color.YELLOW_GREEN
  • Color.YELLOW_ORANGE
  • Color.RED_ORANGE
Jika tidak ditentukan, set_color akan menyalakan LED Sentuh dengan warna yang telah diatur sebelumnya.
Anda juga dapat menentukan warna kustom.

# Change colors between blue and green
while True:
    touchled_1.set_color(Color.BLUE)
    wait(0.5, SECONDS)
    touchled_1.set_color(Color.GREEN)
    wait(0.5, SECONDS)

set_fade#

set_fade mengubah cara LED Sentuh beralih ke warna baru.

Usage:
touchled_1.set_fade(type)

Parameter

Keterangan

type

Seberapa cepat warna akan memudar dari satu ke yang lain:

  • FadeType.FAST — Warna akan bertransisi dengan cepat.
  • FadeType.OFF — Warna akan bertransisi secara instan.
  • FadeType.SLOW — Warna akan bertransisi secara perlahan.

# No fade to red, then slow fade to purple
touchled_1.set_fade(FadeType.OFF)
touchled_1.set_color(Color.RED)
wait(2, SECONDS)
touchled_1.set_fade(FadeType.SLOW)
touchled_1.set_color(Color.PURPLE)

set_brightness#

set_brightness mengatur kecerahan LED Sentuh.

Usage:
touchled_1.set_brightness(brightness)

Parameter

Keterangan

brightness

Kecerahan LED Sentuh dapat diatur sebagai bilangan bulat dari 0% hingga 100%.

# Show green at different brightness levels
touchled_1.set_color(Color.GREEN)
wait(1, SECONDS)
touchled_1.set_brightness(10)
wait(1, SECONDS)
touchled_1.set_brightness(100)

Pencari#

pressing#

Menekan pressing akan mengembalikan bilangan bulat yang menunjukkan apakah LED Sentuh sedang ditekan atau tidak.

  • 1 — TouchLED sedang ditekan.

  • 0 — TouchLED tidak ditekan.

Usage:
touchled_1.pressing()

Parameter

Keterangan

Metode ini tidak memiliki parameter.

# Turn TouchLED green when touched
while True:
    if touchled_1.pressing():
        touchled_1.set_color(Color.GREEN)
    else:
        touchled_1.set_color(Color.RED)
    wait(50, MSEC)

installed#

installed mengembalikan nilai Boolean yang menunjukkan apakah LED Sentuh terhubung ke Brain.

  • True — LED Sentuh terhubung ke Otak.

  • False — LED Sentuh tidak terhubung ke Otak.

Usage:
touchled_1.installed()

Parameter

Keterangan

Metode ini tidak memiliki parameter.

Konstruktor#

Konstruktor digunakan untuk membuat objek Touchled secara manual, yang diperlukan untuk mengkonfigurasi LED Sentuh di luar VEXcode.

Touchled#

Touchled menciptakan LED Sentuh.

Usage:
touchled_1 = Touchled(smartport)

Parameter

Keterangan

smartport

Port Pintar yang terhubung dengan LED Sentuh, ditulis sebagai PORTx di mana x adalah nomor port.

# Create a Touchled in Port 1
touchled_1 = Touchled(Ports.PORT1)