LCDに関するAPI． [詳解]

データ構造
struct	image_t
	画像のオブジェクトの構造体． [詳解]

マクロ定義
#define	EV3_LCD_WIDTH (178)
	LCD画面の幅

#define	EV3_LCD_HEIGHT (128)
	LCD画面の高さ

列挙型
enum	lcdfont_t { EV3_FONT_SMALL, EV3_FONT_MEDIUM }
	フォントを表す番号 [詳解]

enum	lcdcolor_t { EV3_LCD_WHITE = 0, EV3_LCD_BLACK = 1 }
	LCDカラーを表す番号 [詳解]

関数
ER	ev3_lcd_set_font (lcdfont_t font)
	デフォルトのフォントを設定する． [詳解]

ER	ev3_font_get_size (lcdfont_t font, int32_t p_width, int32_t p_height)
	フォントのサイズを取得する． [詳解]

ER	ev3_image_load (const memfile_t p_memfile, image_t p_image)
	メモリファイルから画像をロードする． [詳解]

ER	ev3_image_free (image_t *p_image)
	画像のオブジェクトを解放する． [詳解]

ER	ev3_lcd_draw_string (const char *str, int32_t x, int32_t y)
	指定位置で文字列を描く． [詳解]

ER	ev3_lcd_draw_line (int32_t x0, int32_t y0, int32_t x1, int32_t y1)
	指定座標で線を引く． [詳解]

ER	ev3_lcd_fill_rect (int32_t x, int32_t y, int32_t w, int32_t h, lcdcolor_t color)
	矩形を描いて色を塗る． [詳解]

ER	ev3_lcd_draw_image (const image_t *p_image, int32_t x, int32_t y)
	指定座標で画像を表示する． [詳解]

詳解

LCDに関するAPI．

列挙型詳解

enum lcdcolor_t

LCDカラーを表す番号

列挙値
EV3_LCD_WHITE	白
EV3_LCD_BLACK	黒

enum lcdfont_t

フォントを表す番号

列挙値
EV3_FONT_SMALL	小さいサイズのフォント
EV3_FONT_MEDIUM	普通サイズのフォント

関数詳解

ER ev3_font_get_size	(	lcdfont_t	font,
		int32_t *	p_width,
		int32_t *	p_height
	)

フォントのサイズを取得する．

引数

font	フォントの番号
p_width	取得したフォントの幅を格納する場所へのポインタ．NULLの場合は格納しない．
p_height	取得したフォントの高さを格納する場所へのポインタ．NULLの場合は格納しない．

戻り値

E_OK	正常終了
E_ID	不正ID番号

ER ev3_image_free ( image_t * p_image )

画像のオブジェクトを解放する．

画像のオブジェクトにより確保されたリソース（メモリ領域）を解放する．正常終了の場合，p_image の data はNULLにクリアする．

引数

p_image 解放する画像のオブジェクトのポインタ

戻り値

E_OK	正常終了
E_PAR	p_image はNULL

ER ev3_image_load	(	const memfile_t *	p_memfile,
		image_t *	p_image
	)

メモリファイルから画像をロードする．

指定したメモリファイルから画像のオブジェクトを生成する．現時点では，BMP形式のモノクロ画像ファイルしかサポートしない．エラーが発生する場合，p_image の data はNULLにクリアする.

引数

p_memfile	画像ファイルが格納されるメモリファイルのオブジェクト
p_image	生成した画像のオブジェクトを格納する場所へのポインタ

戻り値

E_OK	正常終了
E_NOMEM	メモリ不足
E_NOSPT	画像ファイルの形式は未対応
E_OBJ	画像ファイルは破損
E_PAR	メモリファイルは無効

ER ev3_lcd_draw_image	(	const image_t *	p_image,
		int32_t	x,
		int32_t	y
	)

指定座標で画像を表示する．

引数

p_image	画像のオブジェクト
x	左上隅の水平方向の位置
y	左上隅の垂直方向の位置

戻り値

E_OK	正常終了
E_PAR	画像のオブジェクトは無効

ER ev3_lcd_draw_line	(	int32_t	x0,
		int32_t	y0,
		int32_t	x1,
		int32_t	y1
	)

指定座標で線を引く．

引数

x0	始点の水平方向の位置
y0	始点の垂直方向の位置
x1	終点の水平方向の位置
y1	終点の垂直方向の位置

戻り値

E_OK 正常終了

ER ev3_lcd_draw_string	(	const char *	str,
		int32_t	x,
		int32_t	y
	)

指定位置で文字列を描く．

引数

x	左上隅の水平方向の位置
y	左上隅の垂直方向の位置
str	文字列

戻り値

E_OK 正常終了

ER ev3_lcd_fill_rect	(	int32_t	x,
		int32_t	y,
		int32_t	w,
		int32_t	h,
		lcdcolor_t	color
	)

矩形を描いて色を塗る．

引数

x	左上隅の水平方向の位置
y	左上隅の垂直方向の位置
w	矩形の幅
h	矩形の高さ
color	カラー

戻り値

E_OK 正常終了

ER ev3_lcd_set_font ( lcdfont_t font )

デフォルトのフォントを設定する．

引数

font フォントの番号

戻り値

E_OK	正常終了
E_ID	不正ID番号

データ構造

マクロ定義

列挙型

関数

詳解

列挙型詳解

関数詳解