光センサー

導入

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

光センサーによって測定された明るさを、0～100%の範囲のパーセントで表した、 int32_t のint32_t値を返します。

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);