Renk

giriiş

Renk Sensörü, robotunuzun bir nesnenin varlığını algılamasına, belirli renkleri tanımasına ve parlaklık ve ton gibi görsel veriler döndürmesine olanak tanıyan optik bir sensördür.

Sensörün dahili ışığının parlaklığını da yapılandırabilirsiniz. Bu araçlar, renkli nesnelere, aydınlatma koşullarına veya sensör geri bildirimine gerçek zamanlı olarak tepki vermesi gereken programlar için idealdir.

Bu sayfada örnek Renk Sensörü adı olarak color_1 kullanılmıştır. Gerektiğinde kendi yapılandırdığınız adla değiştirin.

Aşağıda tüm yöntemlerin listesi bulunmaktadır:

İşlemler — Renk Sensörü ile nesneleri algıla.

• object_detected — Bir nesne algılandığında çağrılacak bir fonksiyonu kaydeder.

Değiştiriciler — Renk Sensöründeki ışıkları değiştirir.

• set_light — Renk Sensörünün LED’ini açar, kapatır veya belirli bir parlaklık seviyesine ayarlar.

• set_light_power — Renk Sensörünün LED’inin parlaklığını ayarlar.

Getter’lar — Renk Sensörü ile nesne verilerini döndürür.

• is_near_object — Bir nesnenin sensörün menzilinde olup olmadığını döndürür.

• color — Tespit edilen rengin onaltılık kodunu döndürür.

• brightness — Algılanan parlaklığı döndürür.

• hue — Tespit edilen ton değerini döndürür.

• installed — Renk Sensörünün Beyne bağlı olup olmadığını döndürür.

Yapıcılar — Renk Sensörünü manuel olarak başlatın ve yapılandırın.

• ColorSensor — Bir Renk Sensörü oluşturur.

Eylemler

object_detected

object_detected , Renk Sensörü bir nesne algıladığında çağrılacak bir fonksiyonu kaydeder.

Usage:
color_1.object_detected(callback, args)

Parametreler	Tanım
callback	Renk Sensörü bir nesneyi algıladığında yürütülecek şekilde önceden tanımlanmış bir fonksiyon.
args	İsteğe bağlı. Geri çağrı fonksiyonuna iletilecek argümanları içeren bir demet. Daha fazla bilgi için Parametreli Fonksiyonlar bölümüne bakın.

Mutatörler

set_light

set_light komutu, Renk Sensörünün LED’ini açar, kapatır veya belirli bir parlaklık seviyesine ayarlar.

Usage:
color_1.set_light(value, units)

Parametreler	Tanım
value	Aşağıdakilerden birini kullanarak LED’in açılıp kapatılacağını belirtir: LedStateType.ON — LED’in parlaklığını %100’e ayarlar. LedStateType.OFF — LED’in parlaklığını %0’a ayarlar. Alternatif olarak, LED parlaklığını ayarlamak için 0 ile 100 arasında bir yüzde kullanılabilir. 0 değeri LED’i kapatır; 0’ın üzerindeki herhangi bir değer, o parlaklıkta LED’i açar.
units	İsteğe bağlı. Parlaklık değerini temsil eden birim: 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

set_light_power komutu, Renk Sensörünün LED’inin parlaklığını ayarlar. LED zaten yanmıyorsa, bu yöntem LED’i de açar.

Usage:
color_1.set_light_power(value)

Parametreler	Tanım
value	LED’in parlaklığı, 0 ile 100 arasında yüzde olarak ifade edilir. 0 değeri LED’i kapatır.

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

Getters

is_near_object

is_near_object , Renk Sensörünün bir nesneye yaklaşık 57 milimetre (2,25 inç) mesafede olup olmadığını gösteren bir Boolean değeri döndürür. Algılama yansıyan ışığa bağlıdır, bu nedenle koyu veya yansıtıcı olmayan yüzeyler güvenilir bir şekilde algılanamayabilir.

• True — Tespit edilen nesne yaklaşık 57 milimetre içindedir.

• False — Tespit edilen nesne yaklaşık 57 milimetre içinde değil.

Usage:
color_1.is_near_object()

Parametreler	Tanım
	Bu yöntemin parametresi yoktur.

color

color komutu, algılanan rengin onaltılık kodunu “Renk” kelimesinin ardından iki sıfır ve rengin onaltılık değeri şeklinde bir dize olarak döndürür.

Örneğin, kırmızı rengi (#FF0000) tespit etmek “Renk 00FF0000” sonucunu döndürür.

Usage:
color_1.color()

Parametreler	Tanım
	Bu yöntemin parametresi yoktur.

# 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 algılanan rengin ne kadar parlak olduğunu %0 ile %100 arasında bir tamsayı olarak döndürür.

Daha yüksek bir yüzde, renk sensörünün daha fazla ışık algıladığı anlamına gelir. Daha düşük bir yüzde ise renk sensörünün daha az ışık algıladığı anlamına gelir.

Usage:
color_1.brightness()

Parametreler	Tanım
	Bu yöntemin parametresi yoktur.

# 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 komutu, algılanan renk tonu değerini 0 ile 359,99 derece aralığında ondalık sayı olarak döndürür.

Renk tonu, aşağıda gösterildiği gibi, renk çemberi üzerindeki sayılar kullanılarak rengi tanımlamanın bir yoludur.

Usage:
color_1.hue()

Parametreler	Tanım
	Bu yöntemin parametresi yoktur.

# 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 kurulum yapıldıysa Renk Sensörünün Beyne bağlı olup olmadığını gösteren bir Boolean değeri döndürür.

• True — Renk Sensörü Beyne bağlıdır.

• False — Renk Sensörü Beyne bağlı değil.

Usage:
color_1.installed()

Parametreler	Tanım
	Bu yöntemin parametresi yoktur.

İnşaatçılar

Yapıcılar, VEXcode dışında bir Renk Sensörünü yapılandırmak için gerekli olan ColorSensor nesnesini manuel olarak oluşturmak için kullanılır.

ColorSensor

ColorSensor bir Renk Sensörü oluşturur.

Usage:
color_1 = ColorSensor(smartport)

Parametre	Tanım
smartport	Renk sensörünün bağlı olduğu akıllı port, PORTx şeklinde yazılır; burada x port numarasını temsil eder.

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