สี

การแนะนำ

เซ็นเซอร์สีเป็นเซ็นเซอร์แบบออปติคอลที่ช่วยให้หุ่นยนต์ของคุณตรวจจับได้ว่ามีวัตถุอยู่หรือไม่ จดจำสีเฉพาะ และส่งข้อมูลภาพ เช่น ความสว่างและเฉดสีกลับมา

นอกจากนี้ คุณยังสามารถปรับความสว่างของไฟภายในเซ็นเซอร์ได้อีกด้วย เครื่องมือเหล่านี้เหมาะสำหรับโปรแกรมที่ต้องการตอบสนองต่อวัตถุที่มีสี สภาพแสง หรือข้อมูลจากเซ็นเซอร์แบบเรียลไทม์

หน้านี้ใช้ color_1 เป็นตัวอย่างชื่อเซ็นเซอร์สี โปรดแทนที่ด้วยชื่อที่คุณกำหนดเองตามต้องการ

ด้านล่างนี้คือรายการวิธีการทั้งหมด:

การทำงาน — ตรวจจับวัตถุด้วยเซ็นเซอร์สี

• object_detected — ลงทะเบียนฟังก์ชันที่จะถูกเรียกเมื่อตรวจพบวัตถุ

ตัวปรับแต่ง — ปรับเปลี่ยนแสงบนเซ็นเซอร์สี

• set_light — ตั้งค่า LED ของเซ็นเซอร์สีเป็นเปิด ปิด หรือระดับความสว่างที่กำหนดไว้

• set_light_power — ตั้งค่าความสว่างของ LED ของเซ็นเซอร์สี

เมธอด Getter — ส่งคืนข้อมูลวัตถุด้วยเซ็นเซอร์สี

• is_near_object — ส่งคืนว่าวัตถุอยู่ในระยะของเซ็นเซอร์หรือไม่

• color — ส่งคืนรหัสเลขฐานสิบหกของสีที่ตรวจพบ

• brightness — ส่งคืนค่าความสว่างที่ตรวจพบ

• hue — ส่งคืนค่า hue ที่ตรวจพบ

• installed — ส่งคืนว่าเซ็นเซอร์สีเชื่อมต่อกับสมองหรือไม่

ตัวสร้าง — กำหนดค่าและตั้งค่าเซ็นเซอร์สีด้วยตนเอง

• ColorSensor — สร้างเซ็นเซอร์สี

การกระทำ

object_detected

object_detected ลงทะเบียนฟังก์ชันที่จะถูกเรียกเมื่อเซ็นเซอร์สีตรวจพบวัตถุ

Usage:
color_1.object_detected(callback, args)

พารามิเตอร์	คำอธิบาย
callback	A function that is previously defined to execute when the Color Sensor detects an object.
args	ตัวเลือกเสริม ทูเปิลที่มีอาร์กิวเมนต์ที่จะส่งไปยังฟังก์ชันเรียกกลับ ดู ฟังก์ชันที่มีพารามิเตอร์ สำหรับข้อมูลเพิ่มเติม

ตัวกลายพันธุ์

set_light

set_light ตั้งค่าไฟ LED ของเซ็นเซอร์สีให้เปิด ปิด หรือปรับความสว่างตามที่กำหนด

Usage:
color_1.set_light(value, units)

พารามิเตอร์	คำอธิบาย
value	ระบุว่าจะเปิดหรือปิดไฟ LED โดยใช้ค่าใดค่าหนึ่งต่อไปนี้: LedStateType.ON — ตั้งค่าความสว่างของไฟ LED เป็น 100% LedStateType.OFF — ตั้งค่าความสว่างของไฟ LED เป็น 0% หรืออีกทางหนึ่ง สามารถใช้ค่าเปอร์เซ็นต์ตั้งแต่ 0 ถึง 100 เพื่อตั้งค่าความสว่างของไฟ LED ค่า 0 จะปิดไฟ LED ค่าใดๆ ที่มากกว่า 0 จะเปิดไฟ LED ที่ระดับความสว่างนั้น
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 ส่งคืนค่าบูลีนที่ระบุว่าเซ็นเซอร์สีอยู่ห่างจากวัตถุประมาณ 57 มิลลิเมตร (2.25 นิ้ว) หรือไม่ การตรวจจับขึ้นอยู่กับแสงสะท้อน ดังนั้นพื้นผิวที่มืดหรือไม่สะท้อนแสงอาจตรวจจับได้ไม่น่าเชื่อถือ

• True — วัตถุที่ตรวจพบอยู่ภายในระยะประมาณ 57 มิลลิเมตร

• False — วัตถุที่ตรวจพบไม่ได้อยู่ภายในระยะประมาณ 57 มิลลิเมตร

Usage:
color_1.is_near_object()

พารามิเตอร์	คำอธิบาย
	เมธอดนี้ไม่มีพารามิเตอร์

color

color จะส่งคืนรหัสเลขฐานสิบหกของสีที่ตรวจพบในรูปแบบสตริง โดยมีรูปแบบเป็น “Color” ตามด้วยเลขศูนย์สองตัวและค่าเลขฐานสิบหกของสีนั้น

ตัวอย่างเช่น การตรวจจับสีแดง (#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 returns a Boolean indicating whether the Color Sensor is connected to the Brain.

• True — เซ็นเซอร์สีเชื่อมต่อกับสมอง

• False — เซ็นเซอร์สีไม่ได้เชื่อมต่อกับสมอง

Usage:
color_1.installed()

พารามิเตอร์	คำอธิบาย
	เมธอดนี้ไม่มีพารามิเตอร์

ผู้สร้าง

ตัวสร้าง (Constructor) ใช้สำหรับสร้างอ็อบเจ็กต์ ColorSensor จำนวน ตัวด้วยตนเอง ซึ่งจำเป็นสำหรับการกำหนดค่า Color Sensor นอก VEXcode

ColorSensor

ColorSensor สร้างเซ็นเซอร์สี

Usage:
color_1 = ColorSensor(smartport)

พารามิเตอร์	คำอธิบาย
smartport	พอร์ตอัจฉริยะที่เชื่อมต่อกับเซ็นเซอร์สี จะเขียนแทนด้วย PORTx โดยที่ x คือหมายเลขของพอร์ต

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