ColorSensor クラス
class legoeducation.ColorSensor()
カラーセンサーが検知して自動配信してくる色彩データのプロパティ構造です。
初期状態(未接続・未受信時)の注意点
デバイスとの接続が確立され、最初の通知を受信するまでの間、colorsensor.sensor の各プロパティには初期値として float('nan') (非数)が格納されています。最初のデバイス通知を処理した段階で、表に記載されたそれぞれの整数型(int)のデータに更新されます。
colorsensor.sensor プロパティ (ColorSensorNotification)
| プロパティ名 | 内部データ型 | 有効数値レンジ | 内容説明 |
|---|---|---|---|
| color | int8 (符号付き1バイト) | 0 〜 10 | 識別カラーインデックス番号(LegoColor定数に対応)。 ※定数の定義幅は0〜10ですが、実際のカラーセンサーが検出可能な色は SENSOR_DETECTABLE_COLORS で定義されている 7色(1:RED, 2:YELLOW, 3:BLUE, 4:TEAL, 5:GREEN, 6:PURPLE, 7:WHITE)および未検出時の 0 (NOCOLOR) のみとなります。 マゼンタ(8)、オレンジ(9)、アジュール(10)はセンサーの検出対象外です。 |
| reflection | uint8 (符号なし1バイト) | 0 〜 100 (%) | 光の反射の相対強度 |
| rawRed | uint16 (符号なし2バイト) | 0 〜 65535 | 赤色チャネルの未加工受光輝度 |
| rawGreen | uint16 (符号なし2バイト) | 0 〜 65535 | 緑色チャネルの未加工受光輝度 |
| rawBlue | uint16 (符号なし2バイト) | 0 〜 65535 | 青色チャネルの未加工受光輝度 |
| hue | uint16 (符号なし2バイト) | 0 〜 360 | HSV変換後の色相値 |
| saturation | uint8 (符号なし1バイト) | 0 〜 255 | HSV変換後の彩度値 |
| value | uint8 (符号なし1バイト) | 0 〜 255 | HSV変換後の明度値 |