색상

소개

컬러 센서는 로봇이 물체의 존재를 감지하고 특정 색상을 인식하며 밝기 및 색조와 같은 시각적 데이터를 반환할 수 있도록 하는 광학 센서입니다.

센서 내부 조명의 밝기도 조절할 수 있습니다. 이러한 기능은 색상이 있는 물체, 조명 조건 또는 센서 피드백에 실시간으로 반응해야 하는 프로그램에 이상적입니다.

이 페이지에서는 예시 색상 센서 이름으로 color_1 사용합니다. 필요에 따라 구성한 이름으로 변경하십시오.

다음은 모든 방법 목록입니다.

동작 — 컬러 센서로 물체를 감지합니다.

• object_detected — 객체가 감지될 때 호출될 함수를 등록합니다.

뮤테이터 — 컬러 센서의 조명을 변경합니다.

• set_light — 컬러 센서의 LED를 켜짐, 꺼짐 또는 설정된 밝기 수준으로 설정합니다.

• set_light_power — 컬러 센서 LED의 밝기를 설정합니다.

게터 — 컬러 센서를 사용하여 객체 데이터를 반환합니다.

• is_near_object — 객체가 센서의 범위 내에 있는지 여부를 반환합니다.

• color — 감지된 색상의 16진수 코드를 반환합니다.

• brightness — 감지된 밝기를 반환합니다.

• hue — 감지된 색조 값을 반환합니다.

• installed — 컬러 센서가 브레인에 연결되어 있는지 여부를 반환합니다.

생성자 — 색상 센서를 수동으로 초기화하고 구성합니다.

• ColorSensor — 컬러 센서를 생성합니다.

행위

object_detected

object_detected 은 컬러 센서가 물체를 감지했을 때 호출될 함수를 등록합니다.

Usage:
color_1.object_detected(callback, args)

매개변수	설명
callback	컬러 센서가 객체를 감지할 때 실행되도록 미리 정의된 함수입니다.
args	선택 사항입니다. 콜백 함수에 전달할 인수를 포함하는 튜플입니다. 자세한 내용은 매개변수가 있는 함수를 참조하세요.

돌연변이체

set_light

set_light 컬러 센서의 LED를 켜거나 끄거나 또는 설정된 밝기 수준으로 설정합니다.

Usage:
color_1.set_light(value, units)

매개변수	설명
value	Specifies whether to turn the LED on or off using one of the following: LedStateType.ON — Sets the LED’s brightness to 100%. LedStateType.OFF — Sets the LED’s brightness to 0%. Alternatively, a percent from 0 to 100 can be used to set the LED brightness. A value of 0 turns the LED off; any value above 0 turns it on at that brightness.
units	선택 사항입니다. 밝기 값을 나타내는 단위: 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 컬러 센서 LED의 밝기를 설정합니다. LED가 켜져 있지 않은 경우, 이 메서드는 LED를 켜기도 합니다.

Usage:
color_1.set_light_power(value)

매개변수	설명
value	LED의 밝기를 0%에서 100%까지의 백분율로 나타낸 값입니다. 값이 0이면 LED가 꺼집니다.

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

게터스

is_near_object

is_near_object 은 컬러 센서가 물체로부터 약 57mm(2.25인치) 이내에 있는지 여부를 나타내는 부울 값을 반환합니다. 감지는 반사광에 따라 달라지므로 어둡거나 반사되지 않는 표면은 안정적으로 감지되지 않을 수 있습니다.

• True — 감지된 물체가 약 57밀리미터 이내에 있습니다.

• False — 감지된 물체가 약 57밀리미터 이내에 없습니다.

Usage:
color_1.is_near_object()

매개변수	설명
	이 메서드에는 매개변수가 없습니다.

color

color 감지된 색상의 16진수 코드를 “Color” 뒤에 두 개의 0과 해당 색상의 16진수 값이 오는 형식의 문자열로 반환합니다.

예를 들어 빨간색(#FF0000)을 감지하면 “Color 00FF0000”이 반환됩니다.

Usage:
color_1.color()

매개변수	설명
	이 메서드에는 매개변수가 없습니다.

# 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 감지된 색상의 밝기를 0%에서 100% 사이의 정수로 반환합니다.

백분율이 높을수록 컬러 센서가 더 많은 빛을 감지한다는 의미이고, 백분율이 낮을수록 컬러 센서가 더 적은 빛을 감지한다는 의미입니다.

Usage:
color_1.brightness()

매개변수	설명
	이 메서드에는 매개변수가 없습니다.

# 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 감지된 색조 값을 0에서 359.99도 범위의 부동 소수점 값으로 반환합니다.

색조는 아래 그림과 같이 색상환을 따라 숫자를 사용하여 색을 설명하는 방법입니다.

Usage:
color_1.hue()

매개변수	설명
	이 메서드에는 매개변수가 없습니다.

# 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 컬러 센서가 브레인에 연결되었는지 여부를 나타내는 부울 값을 반환합니다.

• True — 색상 센서가 뇌에 연결되어 있습니다.

• False — 색상 센서는 뇌에 연결되어 있지 않습니다.

Usage:
color_1.installed()

매개변수	설명
	이 메서드에는 매개변수가 없습니다.

건설업자

생성자는 VEXcode 외부에서 컬러 센서를 구성하는 데 필요한 ColorSensor 를 수동으로 생성하는 데 사용됩니다.

ColorSensor

ColorSensor 컬러 센서를 생성합니다.

Usage:
color_1 = ColorSensor(smartport)

매개변수	설명
smartport	컬러 센서가 연결된 스마트 포트는 PORTx 형식으로 표기하며, 여기서 x는 포트 번호입니다.

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