EV3RT C API Reference  Beta 7
An RTOS-based development platform for LEGO Mindstorms EV3.
LCD

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_imagedata はNULLにクリアする.

引数
p_image解放する画像のオブジェクトのポインタ
戻り値
E_OK正常終了
E_PARp_image はNULL
ER ev3_image_load ( const memfile_t p_memfile,
image_t p_image 
)

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

指定したメモリファイルから画像のオブジェクトを生成する.現時点では,BMP形式のモノクロ画像ファイルしかサポートしない. エラーが発生する場合,p_imagedata は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番号