เซ็นเซอร์แสง

การแนะนำ

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

คอนสตรัคเตอร์คลาส

light(
  triport::port &port );

ตัวทำลายคลาส

ทำลายวัตถุ light และปล่อยทรัพยากรที่เกี่ยวข้อง

virtual ~light();

พารามิเตอร์

พารามิเตอร์	พิมพ์	คำอธิบาย
port	triport::port &	พอร์ต 3 สายที่เชื่อมต่อกับเซ็นเซอร์วัดแสง เขียนเป็น Brain.ThreeWirePort.X หรือ ExpanderName.Xโดยที่ X คือตัวอักษรของพอร์ต (ตัวอย่างเช่น Brain.ThreeWirePort.A หรือ Expander1.A)

ตัวอย่าง

// Create a light instance in Port A
light LightA = light(Brain.ThreeWirePort.A);

ฟังก์ชันสมาชิก

คลาส light ประกอบด้วยฟังก์ชันสมาชิกต่อไปนี้:

• brightness — ส่งคืนปริมาณแสงที่ตรวจจับโดยเซ็นเซอร์แสง

ก่อนเรียกใช้ฟังก์ชันสมาชิก light ใดๆ จะต้องสร้างอินสแตนซ์ light ก่อน ดังแสดงด้านล่าง:

/* This constructor is required when using VS Code.
Light Sensor configuration is generated automatically
in VEXcode using the Device Menu. Replace the values
as needed. */

// Create a light instance in Port A
light LightA = light(Brain.ThreeWirePort.A);

brightness

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

Available Functions

int32_t brightness(
  percentUnits units = percentUnits::pct );

Parameters

พารามิเตอร์	พิมพ์	คำอธิบาย
units	percentUnits	หน่วยที่ใช้แสดงความสว่าง: percent pct (ค่าเริ่มต้น) — เปอร์เซ็นต์

Return Values

ส่งคืนค่า int32_t ซึ่งแสดงถึงความสว่างที่วัดได้จากเซ็นเซอร์วัดแสงเป็นเปอร์เซ็นต์ในช่วง 0 - 100%

Examples

// Get Light Sensor brightness in range of 0% - 100%.
int32_t value = LightA.brightness();

// Print the brightness of the Light Sensor to the
// Brain's screen.
Brain.Screen.print(value);