مستشعر الضوء

مقدمة

تُستخدم فئة light مع مستشعر الضوء، الذي يقيس سطوع الضوء المنعكس من جسم ما أو الساقط عليه. ويُخرج قيمة تناظرية تمثل كمية الضوء التي تم اكتشافها.

مُنشئ الفئة

light(
  triport::port &port );

مُدمِّر الفئة

يدمر الكائن ذو الإضاءة light ويحرر الموارد المرتبطة به.

virtual ~light();

حدود

المعلمة	يكتب	وصف
port	triport::port &	المنفذ ثلاثي الأسلاك الذي يتصل به مستشعر الضوء، مكتوبًا على النحو التالي: 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);