Warna

Perkenalan

Sensor Warna adalah sensor optik yang memungkinkan robot Anda mendeteksi keberadaan suatu objek, mengenali warna tertentu, dan mengembalikan data visual seperti kecerahan dan corak warna.

Anda juga dapat mengkonfigurasi kecerahan lampu internal sensor. Alat-alat ini ideal untuk program yang perlu bereaksi terhadap objek berwarna, kondisi pencahayaan, atau umpan balik sensor secara real-time.

Halaman ini menggunakan color_1 sebagai contoh nama Sensor Warna. Ganti dengan nama yang Anda konfigurasi sendiri sesuai kebutuhan.

Berikut adalah daftar semua metode:

Aksi — Mendeteksi objek dengan Sensor Warna.

• object_detected — Mendaftarkan fungsi yang akan dipanggil ketika sebuah objek terdeteksi.

Mutator — Memodifikasi lampu pada Sensor Warna.

• set_light — Mengatur LED Sensor Warna menjadi menyala, mati, atau tingkat kecerahan tertentu.

• set_light_power — Mengatur kecerahan LED Sensor Warna.

Getter — Mengembalikan data objek dengan Sensor Warna.

• is_near_object — Mengembalikan nilai boolean yang menunjukkan apakah suatu objek berada dalam jangkauan sensor.

• color — Mengembalikan kode heksadesimal dari warna yang terdeteksi.

• brightness — Mengembalikan kecerahan yang terdeteksi.

• hue — Mengembalikan nilai hue yang terdeteksi.

• installed — Mengembalikan apakah Sensor Warna terhubung ke Otak.

Konstruktor — Menginisialisasi dan mengkonfigurasi Sensor Warna secara manual.

• ColorSensor — Membuat Sensor Warna.

Tindakan

object_detected

object_detected mendaftarkan fungsi yang akan dipanggil ketika Sensor Warna mendeteksi suatu objek.

Usage:
color_1.object_detected(callback, args)

Parameter	Keterangan
callback	Sebuah fungsi yang telah didefinisikan sebelumnya untuk dieksekusi ketika Sensor Warna mendeteksi suatu objek.
args	Opsional. Sebuah tuple yang berisi argumen untuk diteruskan ke fungsi callback. Lihat Fungsi dengan Parameter untuk informasi selengkapnya.

Mutator

set_light

set_light mengatur LED Sensor Warna menjadi menyala, mati, atau pada tingkat kecerahan tertentu.

Usage:
color_1.set_light(value, units)

Parameter	Keterangan
value	Menentukan apakah LED akan dinyalakan atau dimatikan menggunakan salah satu dari berikut ini: LedStateType.ON — Mengatur kecerahan LED menjadi 100%. LedStateType.OFF — Mengatur kecerahan LED menjadi 0%. Atau, persentase dari 0 hingga 100 dapat digunakan untuk mengatur kecerahan LED. Nilai 0 mematikan LED; nilai apa pun di atas 0 akan menyalakannya pada kecerahan tersebut.
units	Opsional. Satuan yang mewakili nilai kecerahan: PERCENT.

# Turn the LED on and off forever
while True:
    color_1.set_light(LedStateType.ON)
    wait(0.5, SECONDS)
    color_1.set_light(LedStateType.OFF)
    wait(0.5, SECONDS)

# Turn the LED on and off forever
while True:
    color_1.set_light(LedStateType.ON, 75)
    wait(0.5, SECONDS)
    color_1.set_light(0)
    wait(0.5, SECONDS)

set_light_power

Perintah set_light_power mengatur kecerahan LED Sensor Warna. Jika LED belum menyala, metode ini juga akan menyalakan LED.

Usage:
color_1.set_light_power(value)

Parameter	Keterangan
value	Tingkat kecerahan LED dalam persentase dari 0 hingga 100. Nilai 0 mematikan LED.

# Turn the LED light on at different intensities
color_1.set_light_power(10)
wait(2, SECONDS)
color_1.set_light_power(100)

Pencari

is_near_object

is_near_object mengembalikan nilai Boolean yang menunjukkan apakah Sensor Warna berada dalam jarak sekitar 57 milimeter (2,25 inci) dari suatu objek. Deteksi bergantung pada cahaya pantulan, sehingga permukaan yang gelap atau tidak memantulkan cahaya mungkin tidak terdeteksi dengan andal.

• True — Objek yang terdeteksi berada dalam jarak sekitar 57 milimeter.

• False — Objek yang terdeteksi tidak berada dalam jarak sekitar 57 milimeter.

Usage:
color_1.is_near_object()

Parameter	Keterangan
	Metode ini tidak memiliki parameter.

color

color mengembalikan kode heksadesimal dari warna yang terdeteksi sebagai string dalam format “Color” diikuti oleh dua angka nol dan nilai heksadesimal warna tersebut.

Sebagai contoh, mendeteksi warna merah (#FF0000) akan menghasilkan “Color 00FF0000”.

Usage:
color_1.color()

Parameter	Keterangan
	Metode ini tidak memiliki parameter.

# Display the currently detected hex value
while True:
    brain.screen.clear_screen()
    brain.screen.set_cursor(1, 1)
    brain.screen.print(color_1.color())
    wait(0.5,SECONDS)

brightness

brightness mengembalikan tingkat kecerahan warna yang terdeteksi, sebagai bilangan bulat dari 0% hingga 100%.

Persentase yang lebih tinggi berarti Sensor Warna mendeteksi lebih banyak cahaya. Persentase yang lebih rendah berarti Sensor Warna mendeteksi lebih sedikit cahaya.

Usage:
color_1.brightness()

Parameter	Keterangan
	Metode ini tidak memiliki parameter.

# Display the currently detected brightness
while True:
    brain.screen.clear_screen()
    brain.screen.set_cursor(1, 1)
    brain.screen.print("Brightness:")
    brain.screen.next_row()
    brain.screen.print(color_1.brightness())
    wait(0.5,SECONDS)

hue

hue mengembalikan nilai hue yang terdeteksi sebagai angka desimal dalam rentang 0 hingga 359,99 derajat.

Hue adalah cara untuk mendeskripsikan warna menggunakan angka-angka di sekitar roda warna, seperti yang ditunjukkan di bawah ini.

Usage:
color_1.hue()

Parameter	Keterangan
	Metode ini tidak memiliki parameter.

# Display the currently detected hue 
while True:
    brain.screen.clear_screen()
    brain.screen.set_cursor(1, 1)
    brain.screen.print("Hue: ")
    brain.screen.print(color_1.hue())
    wait(0.5,SECONDS)

installed

installed mengembalikan nilai Boolean yang menunjukkan apakah Sensor Warna terhubung ke Otak.

• True — Sensor Warna terhubung ke Otak.

• False — Sensor Warna tidak terhubung ke Otak.

Usage:
color_1.installed()

Parameter	Keterangan
	Metode ini tidak memiliki parameter.

Konstruktor

Konstruktor digunakan untuk membuat ColorSensor secara manual, yang diperlukan untuk mengkonfigurasi Sensor Warna di luar VEXcode.

ColorSensor

ColorSensor menciptakan Sensor Warna.

Usage:
color_1 = ColorSensor(smartport)

Parameter	Keterangan
smartport	Port Pintar tempat Sensor Warna terhubung, ditulis sebagai PORTx di mana x adalah nomor port.

# Create a Color Sensor object in Port 3
color_1 = ColorSensor(Ports.PORT3)