カラーセンサ

カラーセンサのAPI． [詳解]

データ構造
struct	pup_color_rgb_t
	カラーセンサのRGB値を返す． [詳解]

型定義
typedef pbio_color_hsv_t	pup_color_hsv_t
	カラーセンサで色を測定する。 [詳解]

関数
pup_device_t *	pup_color_sensor_get_device (pbio_port_id_t port)
	ポートIDで指定されたカラーセンサへのPUPデバイスポインタを取得する。 [詳解]
pup_color_rgb_t	pup_color_sensor_rgb (pup_device_t *pdev)
pup_color_hsv_t	pup_color_sensor_color (pup_device_t *pdev, bool surface)
pup_color_hsv_t	pup_color_sensor_hsv (pup_device_t *pdev, bool surface)
	カラーセンサで色を測定する。 [詳解]
int32_t	pup_color_sensor_reflection (pup_device_t *pdev)
	センサーの発する光を表面がどの程度反射するかを測定する。 [詳解]
int32_t	pup_color_sensor_ambient (pup_device_t *pdev)
	周囲の光の強度を測定する。 [詳解]
pbio_error_t	pup_color_sensor_light_set (pup_device_t *pdev, int32_t bv1, int32_t bv2, int32_t bv3)
	カラーセンサのライトを設定する。 [詳解]
pbio_error_t	pup_color_sensor_light_on (pup_device_t *pdev)
	カラーセンサのライトを点灯する。 [詳解]
pbio_error_t	pup_color_sensor_light_off (pup_device_t *pdev)
	カラーセンサのライトを消灯する。 [詳解]
pup_color_hsv_t *	pup_color_sensor_detectable_colors (int32_t size, pup_color_hsv_t *colors)
	カラーセンサが検知する色を設定する。 [詳解]

詳解

カラーセンサのAPI．

型定義詳解

pup_color_hsv_t

typedef pbio_color_hsv_t pup_color_hsv_t

カラーセンサで色を測定する。

デフォルトでは、赤色、黄色、緑色、青色、白色、無しが検出される。

引数

PUPデバイスポインタ
trueならば表面の色から、falseならば他の光源の色を検出する。

戻り値

色（hsvによる表現）

関数詳解

pup_color_sensor_ambient()

int32_t pup_color_sensor_ambient

(

pup_device_t *

pdev

)

周囲の光の強度を測定する。

引数

PUPデバイスポインタ

戻り値

周囲の光の強度（％）

pup_color_sensor_detectable_colors()

pup_color_hsv_t * pup_color_sensor_detectable_colors	(	int32_t	size,
		pup_color_hsv_t *	colors
	)

カラーセンサが検知する色を設定する。

引数

カラーの配列とそのサイズ。

戻り値

err

色。

pup_color_sensor_get_device()

pup_device_t * pup_color_sensor_get_device

(

pbio_port_id_t

port

)

ポートIDで指定されたカラーセンサへのPUPデバイスポインタを取得する。

失敗した場合、エラーログを出力し、NULLを返す。

引数

port

PUPポートID。

戻り値

PUPデバイスポインタ。

pup_color_sensor_hsv()

pup_color_hsv_t pup_color_sensor_hsv	(	pup_device_t *	pdev,
		bool	surface
	)

カラーセンサで色を測定する。

pup_color_sensor_color()と異なり、最も近い色に近似されず検出したhsv値を返す。

引数

PUPデバイスポインタ
trueならば表面の色から、falseならば他の光源の色を検出する。

戻り値

色（hsvによる表現）

pup_color_sensor_light_off()

pbio_error_t pup_color_sensor_light_off

(

pup_device_t *

pdev

)

カラーセンサのライトを消灯する。

pup_color_sensor_light_set(pdev, 0, 0, 0) と同じ。

引数

pdev	PUP デバイスポインタ。

戻り値

err

エラー番号。

pup_color_sensor_light_on()

pbio_error_t pup_color_sensor_light_on

(

pup_device_t *

pdev

)

カラーセンサのライトを点灯する。

pup_color_sensor_light_set(pdev, 100, 100, 100) と同じ。

引数

pdev	PUP デバイスポインタ。

戻り値

err

エラー番号。

pup_color_sensor_light_set()

pbio_error_t pup_color_sensor_light_set	(	pup_device_t *	pdev,
		int32_t	bv1,
		int32_t	bv2,
		int32_t	bv3
	)

カラーセンサのライトを設定する。

引数

pdev	PUP デバイスポインタ。
bv1	輝度。

戻り値

err

エラー番号。

pup_color_sensor_reflection()

int32_t pup_color_sensor_reflection

(

pup_device_t *

pdev

)

センサーの発する光を表面がどの程度反射するかを測定する。

引数

PUPデバイスポインタ

戻り値

どの程度反射しているか。（％）