Cảm biến ánh sáng#

Giới thiệu#

Lớp light được sử dụng với Cảm biến ánh sáng, đo độ sáng của ánh sáng phản xạ từ hoặc chiếu vào một vật thể. Nó xuất ra một giá trị tương tự biểu thị lượng ánh sáng được phát hiện.

Cảm biến ánh sáng VEX EXP.

Hàm tạo lớp#

light(
  triport::port &port );

Lớp Destructor#

Phá hủy đối tượng light và giải phóng các tài nguyên liên quan.

virtual ~light();

Thông số#

Tham số

Kiểu

Sự miêu tả

port

triport::port &

Cổng 3 dây mà cảm biến ánh sáng được kết nối, được viết là Brain.ThreeWirePort.X hoặc ExpanderName.X, trong đó X là ký tự của cổng (ví dụ: Brain.ThreeWirePort.A hoặc Expander1.A).

Ví dụ#

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

Chức năng thành viên#

Lớp light bao gồm các hàm thành viên sau:

  • brightness — Trả về lượng ánh sáng được phát hiện bởi Cảm biến ánh sáng.

Trước khi gọi bất kỳ hàm thành viên nào của lớp light , cần phải tạo một thể hiện của light , như được hiển thị bên dưới:

/* 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#

Trả về lượng ánh sáng được cảm biến ánh sáng phát hiện. Điều này có thể được sử dụng để kiểm tra xem một vật thể có đủ sáng để báo cáo chính xác các dữ liệu hình ảnh khác hay không.

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

Parameters

Tham số

Kiểu

Sự miêu tả

units

percentUnits

Đơn vị biểu thị độ sáng: percent phần pct (mặc định) — phần trăm

Return Values

Trả về một giá trị int32_t biểu thị độ sáng được đo bởi Cảm biến ánh sáng dưới dạng phần trăm trong phạm vi 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);