LCD スクリーン

Core2 屏幕像素为 320x240,以屏幕左上角为原点 (0,0)

カラーコードです:

定義します	16 進値です	R	G	B
BLACK	0x0000	0	0	0
NAVY	0x000F	0	0	128
DARKGREEN	0x03E0	0	128	0
MAROON	0x7800	128	0	0
PURPLE	0x780F	128	0	128
OLIVE	0x7BE0	128	128	0
LIGHTGREY	0xC618	192	192	192
DARKGREY	0x7BEF	128	128	128
BLUE	0x001F	0	0	255
GREENYELLOW	0xB7E0	180	255	0
GREEN	0x07E0	0	255	0
YELLOW	0xFFE0	255	255	0
ORANGE	0xFDA0	255	180	0
PINK	0xFC9F	255	255	16
CYAN	0x07FF	0	255	255
DARKCYAN	0x03EF	0	128	128
RED	0xF800	255	0	0
MAGENTA	0xF81F	255	0	255
WHITE	0xFFFF	255	255	255

クラス名: Lcd

begin()

機能です:

初期化して使用

原型関数です:

void begin()

注意:
M5.begin()を使わないで LCD を初期化したい場合は、ディスプレイを使う前にこの関数を呼び出してください 使用例です:

#include <M5Core2.h>

void setup() {
  M5.Lcd.begin();  //初始化 M5Stack
}

void loop() {
}

sleep()

機能です:

ディスプレイを省エネモードに切り替え

原型関数です:

void sleep()

使用例です:

#include <M5Core2.h>

void setup() {
  M5.Lcd.begin();  //初始化 M5Core2
  M5.Lcd.sleep();    //切换至休眠模式
}

void loop() {
}

clear()

機能です:

ディスプレイ上の内容をクリア

原型関数です:

void clear()

使用例です:

#include <M5Core2.h>

void setup() {
  M5.Lcd.begin();  //初始化 M5Core2
  M5.Lcd.fillScreen(RED);
  delay(1000);
  M5.Lcd.clear();    //清空显示屏所显示的内容
}

void loop() {
}

wakeup()

機能です:

省エネモードからディスプレイを復元

原型関数です:

void wakeup()

使用例です:

#include <M5Core2.h>

void setup() {
  M5.Lcd.begin();  //初始化 M5Core2
  M5.Lcd.wakeup();    //从节能模式恢复显示
}

void loop() {
}

hight()

機能です:

画面の高さを返す

原型関数です:

void hight()

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();   //初始化 M5Core2
  M5.Lcd.print(M5.Lcd.height());    //在屏幕上显示屏幕的高度
}

void loop() {
}

width()

機能です:

画面の幅を返す

原型関数です:

void width()

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();   //初始化 M5Core2
  M5.Lcd.print(M5.Lcd.width());    //在屏幕上显示屏幕的宽度
}

void loop() {
}

getCursorX()

機能です:

文字列の末尾の x 座標を取得

原型関数です:

int16_t getCursorX()

注意:
drawNumber()は適用できません

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.print("Hello");
  int X = M5.Lcd.getCursorX();
  M5.Lcd.print(X);
}

void loop(){
}

getCursorY()

機能です:

文字列の末尾の y 座標を取得

原型関数です:

int16_t getCursorY()

注意:
drawNumber()は適用できません

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.print("Hello");
  int X = M5.Lcd.getCursorY();
  M5.Lcd.print(Y);
}

void loop(){
}

getRotation()

機能です:

画面の回転方向ですを返す

原型関数です:

uint8_t getRotation()

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.print(M5.Lcd.getRotation());    //在屏幕上输出屏幕的旋转方向です
}

void loop(){
}

getTextDatum()

機能です:

文字のアライメント方式を返す(上のリスト中のアライメント番号)

原型関数です:

textdatum_t getRotation()

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.setTextDatum(MC_DATUM);    //设置文字的对齐方式
  M5.Lcd.drawString("hello", 160, 120, 2);    //在(160,120)处以2号字体打印字符串hello
  M5.Lcd.print(M5.Lcd.getTextDatum());    //屏幕打印获取到的文字对齐方式
}

void loop(){
}

setCursor()

機能です:

文字のカーソルを(x,y)にセット

原型関数です:

void setCursor(int16_t x, int16_t y)

パラメータです	タイプです	タイプです
x	int16_t	x 座標(ピクセル)です
y	int16_t	y 座標(ピクセル)です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();             //初始化 M5Core2
  M5.Lcd.setCursor(0, 30);
  M5.Lcd.printf("Hello M5");
}

void loop() {}

setRotation()

機能です:

画面を回転

原型関数です:

void setRotation(uint8_t m)

パラメータです	タイプです	記述します
m	uint8_t	回転角度です ( * 90°)

注意:
1. 回転角度は 90° の倍数
0-3 は時計回り、4-7 は反時計回り(デフォルトは 1)
3. 表示前にセットする必要がある

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();             //初始化 M5Core2
  M5.Lcd.setRotation(2);  //将屏幕顺时针旋转180度(2*90)
  M5.Lcd.fillEllipse(160, 100, 60, 100, YELLOW);    //在(160,100)处创建一个长轴,短轴分别为60,100黄色椭圆
  delay(1000);
  M5.Lcd.setRotation(1);  //将屏幕恢复为默认显示状态
  M5.Lcd.fillEllipse(160, 100, 60, 100, GREEN);
}

void loop() {}

SetLcdVoltage()

機能です:

画面の明るさをセット

原型関数です:

void SetLcdVoltage(uint16_t voltage)

パラメータです	タイプです	記述します
voltage	uint16_t	電圧値です

注意:
電圧値の範囲は(2500~3300)

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();
  M5.Lcd.fillScreen(RED);
}
void loop() {
  M5.update();
  for(int i=2500; i<3300;i++){
    M5.Axp.SetLcdVoltage(i);  //每隔10ms设置一次電圧値です
    delay(10);
  }
  for(int i=3300; i>2500;i--){
    M5.Axp.SetLcdVoltage(i);
    delay(10);
  }
}

alphaBlend()

機能です:

透明度をセット、前景と背景色を混ぜ

原型関数です:

uint16_t alphaBlend(uint8_t alpha, uint16_t fgc, uint16_t bgc)

パラメータです	記述します	タイプです
alpha	uint8_t	透明性です
fgc	uint16_t	前の景色です
bgc	uint16_t	背景色です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.Lcd.begin();  //初始化 M5Core2
  M5.Lcd.fillScreen(M5.Lcd.alphaBlend(128, 0X00FF00, 0XFF0000));
  //设置前景、背景色分别为0X00FF00,0XFF0000 透明度为128,并填充至整个屏幕
}

void loop() {
}

setFreeFont()

機能です:

使用する GFX フォントをセット

原型関数です:

void setFreeFont(const GFXfont *f)

パラメータです	タイプです	説明します
GFXfont *f	const	フォント名です

使用例です:

loadFont()

機能です:

VLW ファイルからフォントをロード

原型関数です:

void loadFont(String fontName, bool flash)

パラメータです	タイプです	説明します
fontName	String	フォント名です
flash	bool	文書の出所です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.loadFont("filename", SD);
}

void loop() {
}

unloadFont()

機能です:

フォントをアンロード

原型関数です:

void unloadFont()

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.unloadFont();
}

void loop() {
}

fontsLoaded()

機能です:

独自のフォントをロードしたかどうかを返す

原型関数です:

uint16_t fontsLoaded(void)

戻り値です:

表示フォントのエンコードの 16 進数値を返す

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.print(M5.Lcd.fontsLoaded());
}

void loop() {
}

fillScreen()

機能です:

指定の色で画面全体を塗りつくす

原型関数です:

void fillScreen(uint32_t color)

パラメータです	タイプです	記述します
color	uint32_t	カラー値です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.fillScreen(RED);    //在屏幕上填充红色
}

void loop(){
}

invertDisplay()

機能です:

正/負方式で画面色を反転

原型関数です:

void invertDisplay(boolean i)

パラメータです	タイプです	説明します
i	boolean	反转时为 true

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.fillScreen(RED);    //在屏幕上填充红色
}

void loop() {
  M5.Lcd.invertDisplay(1);    //开启反转
  delay(1000);
  M5.Lcd.invertDisplay(0);    //关闭反转
}

color565()

機能です:

関数中で使用する色コード（rgb 565）を変更

原型関数です:

color565(uint8_t red, uint8_t green, uint8_t blue)

パラメータです	タイプです	記述します
red	uint8_t	赤です
green	uint8_t	緑です
blue	uint8_t	ブルーです

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  uint16_t colorvalue = 0;
  colorvalue = color565(255, 255, 255);
  M5.Lcd.fillEllipse(160, 100, 60, 100, colorvalue);
}

void loop() {}

Text

print()

機能です:

画面の当前位置に文字列を印刷

原型関数です:

size_t print()

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.print("this is a print text function");
}

void loop() {
}

textWidth()

機能です:

文字が占めるピクセル幅を返す

原型関数です:

int16_t textWidth(const String& string)

パラメータです	タイプです	記述します
string	const String&	文字列です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();   //初始化 M5Core2
  String text = "hello  ";
  M5.Lcd.print(text);
  M5.Lcd.print(M5.Lcd.textWidth(text));    //在屏幕上打印字符串数组text所占像素宽度
}

void loop() {}

setTextSize()

機能です:

表示文字のサイズをセット

原型関数です:

void setTextSize(uint8_t s)

パラメータです	タイプです	記述します
s	uint8_t	文字の大きさです (1~7)

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.setTextSize(4);    //设置字体大小为4
  M5.Lcd.print("Hello M5Core2");
}

void loop() {
}

setTextColor()

機能です:

表示テキストの前の景色ですをセット / 表示テキストの前の景色ですと背景色をセット

原型関数です:

void setTextColor(uint16_t color)

void setTextColor(uint16_t color, uint16_t backgroundcolor)

パラメータです	タイプです	記述します
color	uint16_t	テキストの前景の色です
backgroundcolor	uint16_t	テキストの背景色です

注意:
1.関数の backgroundcolor の値が指定されていない場合は、現在の背景色を使用
2.文字色をセットしなければ、デフォルトは白色

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin(); //初始化 M5Core2
  M5.Lcd.setTextColor(RED,BLACK);    //设置文本的前、背景色分别为红色和黑色
  //M5.Lcd.setTextColor(RED);
}

void loop(){
}

setTextWrap()

機能です:

自動改行機能をセット

原型関数です:

void setTextWrap(boolean wrapX, boolean wrapY)

パラメータです	タイプです	記述します
wrapX	boolean	X 方向です(デフォルトで開いています)
wrapY	boolean	Y 方向です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();   //初始化 M5Core2
  M5.Lcd.setTextWrap(true, true);    //开启x、y轴自动换行
    M5.Lcd.print("hello M5Core2 hello M5Core2 hello M5Core2 hello M5Core2 hello M5Core2 hello M5Core2 hello M5Core2 hello M5Core2");
}

void loop() {}

setTextPadding()

機能です:

指定の空白幅を埋める(古いテキストと数字を消去に役立つ)

原型関数です:

void setTextPadding(uint16_t x_width)

パラメータです	タイプです	記述します
x_width	uint16_t	空白領域幅です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();
}

void loop() {
  M5.Lcd.drawString("Orbitron 32", 160, 60, 2);
  delay(2000);
  M5.Lcd.setTextPadding(M5.Lcd.width() - 20);
  M5.Lcd.drawString("Orbitron 32 with padding", 160, 60, 2);
  delay(2000);
}

setTextDatum()

機能です:

テキストのアライメント方式をセット

原型関数です:

void setTextDatum(uint8_t datum)

パラメータです	タイプです	記述します
TL_DATUM (0)	uint8_t	左上角のアライメント (既定)
TC_DATUM (1)	uint8_t	中央上部のアライメント
TR_DATUM (2)	uint8_t	右上角のアライメント
ML_DATUM (3)	uint8_t	中央左のアライメント
MC_DATUM (4)	uint8_t	中央のアライメント
MR_DATUM (5)	uint8_t	中央右のアライメント
BL_DATUM (6)	uint8_t	左下角のアライメント
BC_DATUM (7)	uint8_t	中央下部のアライメント
BR_DATUM (8)	uint8_t	右下角のアライメント
L_BASELINE (9)	uint8_t	左文字のベースライン
C_BASELINE (10)	uint8_t	中央文字のベースライン
R_BASELINE (11)	uint8_t	右文字のベースライン

注意:
1.print()には適用されません

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.setTextDatum(MC_DATUM);    //设置文本对齐方式为中心对齐
  M5.Lcd.drawString("hello", 160, 120, 2);    //在(160,120)处以2号字体打印字符串hello
}

void loop(){
}

Draw

drawFastHLine()

機能です:

(X,Y)位置に長さ w の color 色の水平線を描く

原型関数です:

void drawFastHLine(int32_t x, int32_t y, int32_t w, uint32_t color)

パラメータです	タイプです	機能です
x	int32_t	座標 X です
y	int32_t	座標 Y です
w	int32_t	幅(ピクセル)です
color	uint32_t	ラインカラー(オプション)です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.drawFastHLine(3, 100, 255, GREEN);    //在(3,100)处划一条长度为255的绿色水平线条
}

void loop() {
}

drawFastVLine()

機能です:

(X,Y)位置に長さ w の color 色の垂直線を描く

原型関数です:

void drawFastVLine(int32_t x, int32_t y, int32_t w, uint32_t color)

パラメータです	タイプです	機能です
x	int32_t	座標 X です
y	int32_t	座標 Y です
w	int32_t	幅(ピクセル)です
color	uint32_t	ラインカラー(オプション)です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.drawFastVLine(100, 0, 255, TFT_GREEN);    //在(100,0)处划一条长度为255的绿色垂直线条
}

void loop(){
}

drawString()

機能です:

(x,y)位置に文字列を表示

原型関数です:

int16_t drawString(const char *string, int32_t poX, int32_t poY, uint8_t font)

パラメータです	タイプです	記述します
string	const char *	文字列です
poX	int32_t	X 座標です
poY	int32_t	Y 座標です
font	uint8_t	フォントです

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.drawString("Hello M5", 160, 100, 2);    //在(160,100)处以2号字体显示字符串Hello M5
}

void loop(){
}

drawNumber()

機能です:

(x,y)位置に整数を表示

原型関数です:

void drawNumber(long long_num, int32_t poX, int32_t poY)

パラメータです	タイプです	記述します
long_num	long	数字です
poX	int32_t	X 座標です
poY	int32_t	Y 座標です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.drawNumber(99, 55, 100);    //在(99,55)处显示整数100
}

void loop(){
}

drawChar()

機能です:

(X,Y)位置に font フォントで文字を表示

原型関数です:

int16_t drawChar(int16_t uniCode, int32_t x, uint16_t y, uint8_t font)

パラメータです	タイプです	記述します
uniCode	int16_t	文字です
x	int32_t	X 座標です
y	uint16_t	Y 座標です
font	uint8_t	フォントです

使用例です:

#include <M5Core2.h>
void setup() {
  M5.begin(); //初始化 M5Core2
  M5.Lcd.drawChar('A', 160, 120, 2);    //在(160,120)处以字体2显示字符A
}
void loop(){
}

drawFloat()

機能です:

(X,Y)位置に小数点以下 dp 位の浮動小数点数 floatNumber を表示

原型関数です:

int16_t drawFloat(float floatNumber, uint8_t dp, int32_t poX, int32_t poY)

パラメータです	タイプです	記述します
floatNumber	float	表示する小数
dp	uint8_t	小数点の桁数
poX	int32_t	x 位置で表示
poY	int32_t	Y 位置で表示

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();   //初始化 M5Core2
  M5.Lcd.drawFloat(3.1415928,7,100,100);    //在(100,100)处显示小数点后7位的浮点数3.1415928
}

void loop() {}

drawPixel()

機能です:

(X,Y)位置に点を描く

原型関数です:

void drawPixel(int32_t x, int32_t y, uint32_t color)

参数:

パラメータです	タイプです	記述します
x	int32_t	X 座標です
y	int32_t	Y 座標です
color	uint32_t	色です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.drawPixel(22,22,RED);    //在(22,22)处画一个红色的像素点
}

void loop() {}

drawLine()

機能です:

点(x0,y0)から点(x1,y1)まで指定色(color)で直線を描く

原型関数です:

void drawLine(int32_t x0, int32_t y0, int32_t x1, int32_t y1, uint32_t color)

パラメータです	タイプです	記述します
x	int32_t	X 座標です
y	int32_t	Y 座標です
color	uint32_t	色です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.drawLine(200, 0, 200,2000,GREEN);    //从点(200,0)到点(200,200)以绿色绘制直线
}

void loop(){
}

drawRect()

機能です:

(x,y)位置に指定色で幅 width と高さ height の矩形の線枠を描く

原型関数です:

void drawRect(int32_t x, int32_t y, int32_t w, int32_t h, uint32_t color)

パラメータです	タイプです	記述します
x	int32_t	X 座標です
y	int32_t	Y 座標です
w	int32_t	矩形枠の幅（単位：ピクセル）
h	int32_t	矩形枠の高さ（単位：ピクセル）
color	uint32_t	カラー値です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.drawRect(180, 12, 122, 10, BLUE);    //在(180,12)处以蓝色绘制宽高分别为122和10的矩形线框
}

void loop(){
}

fillRect()

機能です:

(x,y)位置に指定色で幅 width と高さ height の矩形を塗りつくす

原型関数です:

void fillRect(int32_t x, int32_t y, int32_t w, int32_t h, uint32_t color)

パラメータです	タイプです	記述します
x	int32_t	X 座標です
y	int32_t	Y 座標です
w	int32_t	矩形枠の幅（単位：ピクセル）
h	int32_t	矩形枠の高さ（単位：ピクセル）
color	uint32_t	カラー値です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.fillRect(150, 120, 122, 10, BLUE);    //在(150,120)处绘制一个长122、宽为10的蓝色填充矩形
}

void loop(){
}

drawRoundRect()

機能です:

(x,y)位置に幅 width、高さ height の角丸矩形の線枠を描く、角丸の半径は radius、色は color

原型関数です:

void drawRoundRect(int32_t x, int32_t y, int32_t w, int32_t h, int32_t r, uint32_t color)

パラメータです	タイプです	記述します
x	int32_t	左上の X 座標です
y	int32_t	左上の Y 座標です
w	int32_t	長方形(ピクセル)です
h	int32_t	長方形の高さです
r	int32_t	角半径 f です
color	uint32_t	四角の色です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();   //初始化 M5Core2
  M5.Lcd.drawRoundRect(55,55,30,50,10,GREEN);    //在(55,55)处绘制宽高分别为30、50的圆角半径为10,颜色为绿色的圆角矩形线框

void loop() {}

fillRoundRect()

機能です:

(x,y)位置に幅 width、高さ height の角丸矩形の線枠を描く、角丸の半径は radius、色は color

原型関数です:

void fillRoundRect(int32_t x, int32_t y, int32_t w, int32_t h, int32_t r, uint32_t color)

パラメータです	タイプです	記述します
x	int32_t	左上の X 座標です
y	int32_t	左上の Y 座標です
w	int32_t	長方形(ピクセル)です
h	int32_t	長方形の高さです
r	int32_t	角半径 f です
color	uint32_t	四角の色です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();   //初始化 M5Core2
  M5.Lcd.fillRoundRect(55, 55, 30, 50, 10, GREEN);//在(55,55)处绘制宽高分别为30、50的圆角半径为10,颜色为绿色的圆角矩形
}

void loop() {}

drawCircle()

機能です:

(x,y)位置に半径 r の color 色の円の線枠を描く

原型関数です:

void drawCircle(int32_t x0, int32_t y0, int32_t r, uint32_t color)

参数:

パラメータです	タイプです	記述します
x0	int32_t	圆中心 X 座標です
y0	int32_t	円の中心の Y 座標です
r	int32_t	円の半径です
color	uint32_t	円の色です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();   //初始化 M5Core2
  M5.Lcd.drawCircle(100, 100, 50, RED);   //在(x,y)处绘制半径为50的红色圆线圈
}

void loop() {}

fillCircle()

機能です:

(x,y)位置に半径 r の color 色の円を塗りつくす

原型関数です:

void drawCircle(int32_t x0, int32_t y0, int32_t r, uint32_t color)

参数:

パラメータです	タイプです	記述します
x0	int32_t	圆中心 X 座標です
y0	int32_t	円の中心の Y 座標です
r	int32_t	円の半径です
color	uint32_t	円の色です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();   //初始化 M5Core2
  M5.Lcd.fillCircle(100, 100, 50, RED); //在(x,y)处绘制半径为50的填充红色圆
}

void loop() {}

drawEllipse()

機能です:

(x,y)位置に幅、高さそれぞれ rx,ry の楕円の線枠を描く

原型関数です:

void fillEllipse(int16_t x0, int16_t y0, int32_t rx, int32_t ry, uint16_t color)

参数:

パラメータです	タイプです	記述します
x0	int16_t	楕円の中心 X 座標です
y0	int16_t	楕円の中心の Y 座標です
rx	int32_t	楕円の幅(画素)です
ry	int32_t	楕円の高さ(画素)です
color	uint16_t	楕円の色です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();   //初始化 M5Core2
  M5.Lcd.drawEllipse(160, 100, 60, 100, YELLOW);//在（160,100）处绘制颜色为黄色的宽度、高度分别为60,100的椭圆轮廓线
}

void loop() {}

fillEllipse()

機能です:

(x,y)位置に幅、高さそれぞれ rx,ry の楕円を塗りつくす

原型関数です:

void fillEllipse(int16_t x0, int16_t y0, int32_t rx, int32_t ry, uint16_t color)

参数:

パラメータです	タイプです	記述します
x0	int16_t	楕円の中心 X 座標です
y0	int16_t	楕円の中心の Y 座標です
rx	int32_t	楕円の幅(画素)です
ry	int32_t	楕円の高さ(画素)です
color	uint16_t	楕円の色です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.fillEllipse(160, 100, 60, 100, YELLOW);    //在（160,100）处绘制颜色为黄色的宽度、高度分别为60,100的填充黄色椭圆
}

void loop() {}

drawTriangle()

機能です:

(x1, y1) (x2, y2) (x3, y3)を頂点に三角形の線枠を描く

原型関数です:

void drawTriangle(int32_t x0, int32_t y0, int32_t x1, int32_t y1, int32_t x2, int32_t y2, uint32_t color)

パラメータです	タイプです	記述します
x*	int32_t	頂点 X*の X 座標です
y*	int32_t	頂点 Y*の X 座標です
color	uint32_t	三角形の色です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();   //初始化 M5Core2
  M5.Lcd.drawTriangle(30, 30, 180, 100, 80, 150, YELLOW); //以 (30,30) (180,100) (80,150)为顶点绘制黄色三角形线框
}

void loop() {}

drawTriangle()

機能です:

(x1, y1) (x2, y2) (x3, y3)を頂点に三角形を塗りつくす

原型関数です:

void drawTriangle(int32_t x0, int32_t y0, int32_t x1, int32_t y1, int32_t x2, int32_t y2, uint32_t color)

パラメータです	タイプです	記述します
x*	int32_t	頂点 X*の X 座標です
y*	int32_t	頂点 Y*の X 座標です
color	uint32_t	三角形の色です

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();   //初始化 M5Core2
  M5.Lcd.drawTriangle(30, 30, 180, 100, 80, 150, YELLOW); //以 (30,30) (180,100) (80,150)为顶点绘制填充黄色三角形
}

void loop() {}

drawXBitmap()

機能です:

ビットマップを描く

原型関数です:

void drawXBitmap(int16_t x, int16_t y, const uint8_t *bitmap, int16_t w, int16_t h, uint16_t color)

パラメータです	タイプです	記述します
x	int16_t	座標 X です
y	int16_t	座標 Y です
bitmap	const uint8_t	画像を示します
w	int16_t	幅(ピクセル)です
h	int16_t	高さ(ピクセル)です
color	uint16_t	色です

使用例です:

使用例 sketch:->->->を参照:M5Stack->Advanced->Display->drawXBitmap

drawBitmap()

機能です:

ビットマップを描く

原型関数です:

drawBitmap(int16_t x0, int16_t y0, int16_t w, int16_t h, const uint16_t *data)

drawBitmap(int16_t x0, int16_t y0, int16_t w, int16_t h, uint16_t *data)

drawBitmap(int16_t x0, int16_t y0, int16_t w, int16_t h, const uint16_t *data, uint16_t transparent)

drawBitmap(int16_t x0, int16_t y0, int16_t w, int16_t h, const uint8_t *data)

drawBitmap(int16_t x0, int16_t y0, int16_t w, int16_t h, uint8_t *data)

パラメータです	タイプです	記述します
x0	uint16_t	座標 X です
y0	uint16_t	座標 Y です
w	int16_t	幅(ピクセル)です
h	int16_t	高さ(ピクセル)です
data	uint16_t* / uint8_t*	画像のデータ
transparent	uint16_t	透明色のコード

注意:
色コードは合計 16 ビットで表示:赤は 5 ビット、緑は 6 ビット、上の青は 5 ビット

使用例です:

使用例 sketch:->->を参照:M5Stack->games->Tetris

drawBmpFile()

機能です:

ファイルからビットマップを読み込み描画

原型関数です:

drawBmpFile(fs::FS &fs, const char *path, uint16_t x, uint16_t y)

パラメータです	タイプです	記述します
fs	fs::FS	ファイルストリーム
path	const char*	ファイルのパス(SD、SPIFFS)
x	int16_t	座標 X です
y	int16_t	座標 Y です

注意:
1.サイズとビット数の問題で拡張できない可能性あり
2. Arduino ESP32 filesystem uploader を事前にインストールする必要がある

使用例です:

#include "FS.h"
//#include "SPIFFS.h"
#include <M5Core2.h>
void setup(){
    M5.begin(true, false, false, false);
  M5.Lcd.drawBmpFile(SD, "/p2.bmp",0,0);
  //M5.Lcd.drawBmpFile(SPIFFS, "/p2.bmp", 0, 0);
}

画像->ファイルの変換に使用できるスクリプトを提供、一部の画像を変換し、上記の API を使って画面に描画できる bin2code.py

drawJpg()

機能です:

メモリから JPEG 形式の画像データを読み込み描画

原型関数です:

void drawJpg(const uint8_t *jpg_data, size_t jpg_len, uint16_t x,uint16_t y, uint16_t maxWidth, uint16_t maxHeight,uint16_t offX, uint16_t offY, jpeg_div_t scale) {

パラメータです	タイプです	記述します
jpg_data	uint8_t*	データの先頭
jpg_len	size_t	データの長さ
x	uint16_t	座標 X です
y	uint16_t	座標 Y です
maxWidth	uint16_t	最大幅（ピクセル）です
maxHeight	uint16_t	最大高さ（ピクセル）です
offX	uint16_t	オフセット X（ピクセル）
offY	uint16_t	オフセット Y（ピクセル）
scale	jpeg_div_t	縮尺

仕様 (jpeg_div_t):

定義します	機能です
JPEG_DIV_NONE	无
JPEG_DIV_2	1/2
JPEG_DIV_4	1/4
JPEG_DIV_8	1/8
JPEG_DIV_MAX	MAX

注意:
1.サイズ、ビット数、形式（漸進等）の問題で拡張できない可能性あり
2. tetris_img をダウンロード

使用例です:

#include <M5Core2.h>
extern uint8_t tetris_img[];    //引用存储图像的数组,需要提前和 xxx.ino放在同一文件夹中

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.drawJpg(tetris_img, 34215);    //从内存中读取名为tetris_img的jpeg文件
}
void loop(){
}

drawJpgFile()

機能です:

从ファイルストリームから JPEG データを読み込み描画

原型関数です:

void drawJpgFiledrawJpgFile(fs::FS &fs, const char *path, uint16_t x,uint16_t y,uint16_t maxWidth, uint16_t maxHeight, uint16_t offX,uint16_t offY, jpeg_div_t scale)

パラメータです	タイプです	記述します
fs	fs::FS	ファイルストリーム
path	const char *	ファイルパス
x	uint16_t	座標 X
y	uint16_t	座標 Y
maxWidth	uint16_t	最大幅（ピクセル）
maxHeight	uint16_t	最大高さ（ピクセル）
offX	uint16_t	オフセット X（ピクセル）
offY	uint16_t	オフセット Y（ピクセル）
scale	jpeg_div_t	規模

规模(jpeg_div_t):

定義します	機能です
JPEG_DIV_NONE	no care.
JPEG_DIV_2	1/2
JPEG_DIV_4	1/4
JPEG_DIV_8	1/8
JPEG_DIV_MAX	MAX

注意:
サイズと形式（漸進等）の問題で拡張できない可能性あり

progressBar()

機能です:

進捗を示す欄が表示されます

原型関数です:

void progressBar(int x, int y, int w, int h, uint8_t val)

パラメータです	タイプです	記述します
x	int	座標 X です
y	int	座標 Y です
w	int	幅(ピクセル)です
h	int	高さ(ピクセル)です
val	uint8_t	进度(0-100%)

注意:
プログレスバーが青で表示されます

使用例です:

#include <M5Core2.h>

void setup() {
  M5.begin();  //初始化 M5Core2
  M5.Lcd.progressBar(0, 0, 240, 20, 20);    //在(0,0)处显示宽高分别为240,20进度为20%的进度条
}

void loop() {
}

qrcode()

機能です:

qr コードを作ります

原型関数です:

void qrcode(const char *string, uint16_t x, uint16_t y, uint8_t width, uint8_t version)

void qrcode(const String &string, uint16_t x, uint16_t y, uint8_t width, uint8_t version)

パラメータです	タイプです	記述します
val	string / String&	QR の文字列を埋め込みます
x	uint16_t	座標 X です
y	uint16_t	座標 Y です
width	uint8_t	幅(ピクセル)です
version	uint8_t	qr コード版です

注意:
QR コードのバージョンを文字数に基づいて適切に選択してください

使用例です:

#include <M5Core2.h>

void setup() {
  M5.Lcd.begin();   //初始化 M5Core2
  M5.Lcd.qrcode("http://www.m5stack.com", 50, 10, 220, 6);
}

void loop() {
}

Sprite

setColorDepth()

機能です:

色深を設定

原型関数です:

void* TFT_eSprite::setColorDepth(int8_t b)

使用例です:

#include <M5Core2.h>
TFT_eSprite img = TFT_eSprite(&M5.Lcd);

void setup() {
    img.setColorDepth(8); // Set color depth.  设置色深
    img.setTextSize(2);
    img.createSprite(320, 240);  //Create a 320x240 canvas. 创建一块320x240的画布
}

void loop() {}

キャンバスを作成する前に適切な色深を設定してください

createSprite()

機能です:

指定の幅と高さを持つキャンバスを作成

原型関数です:

void createSprite(int16_t w, int16_t h, uint8_t frames)

パラメータです	タイプです	記述します
x	int16_t	X 座標です
y	int16_t	Y 座標です
frames	uint8_t	色深度[1~2,お選びいただけます]

使用例です:

#include <M5Core2.h>
TFT_eSprite img = TFT_eSprite(&M5.Lcd);

void setup() {
  M5.begin();  //初始化 M5Core2
  img.createSprite(320, 240);    //创建一块320x240的画布
  img.fillSprite(RED);    //在画布上全部填充红色
  img.pushSprite(0, 0, WHITE);    //把画布推送到屏幕(0,0)处并设置白色为穿透色
  M5.Lcd.print(img.height());    //屏幕打印画布的高度
}

void loop() {}

fillSprite()

機能です:

Sprite を指定色で塗りつくす

原型関数です:

void fillSprite(uint32_t color)

パラメータです	タイプです	記述します
color	int32_t	filled color

使用例です:

#include <M5Core2.h>
TFT_eSprite img = TFT_eSprite(&M5.Lcd);

void setup() {
  M5.begin();  //初始化 M5Core2
  img.createSprite(320, 240);    //创建一块320x240的画布
  img.fillSprite(RED);    //在画布上全部填充红色
  img.pushSprite(0, 0);    //把画布推送到屏幕(0,0)处
}

void loop() {}

pushSprite()

機能です:

キャンバスを指定の座標にプッシュし、透過色を設定

原型関数です:

void pushSprite(int32_t x, int32_t y, uint16_t transparent)

パラメータです	タイプです	記述します
x	int32_t	X 座標です
y	int32_t	Y 座標です
transparent	int16_t	透過色(オプション)です

使用例です:

#include <M5Core2.h>
TFT_eSprite img = TFT_eSprite(&M5.Lcd);

void setup() {
  M5.begin();  //初始化 M5Core2
  img.createSprite(320, 240);    //创建一块320x240的画布
  img.fillSprite(RED);    //在画布上全部填充红色
  img.fillCircle(100,100,20,GREEN);
  img.pushSprite(0, 0, GREEN);    //把画布推送到屏幕(0,0)处并设置绿色为穿透色
}

void loop() {}

height()

機能です:

Sprite の高さを返す

原型関数です:

int16_t height()

使用例です:

#include <M5Core2.h>
TFT_eSprite img = TFT_eSprite(&M5.Lcd);

void setup() {
  M5.begin();  //初始化 M5Core2
  img.createSprite(320, 240);    //创建一块320x240的画布
  img.fillSprite(RED);    //在画布上全部填充红色
  img.pushSprite(0, 0, WHITE);    //把画布推送到屏幕(0,0)处并设置白色为穿透色
  M5.Lcd.print(img.height());    //屏幕打印画布的高度
}

void loop() {}

deleteSprite()

機能です:

キャンバスをメモリから削除

原型関数です:

void deleteSprite(void)

使用例です:

#include <M5Core2.h>
TFT_eSprite img = TFT_eSprite(&M5.Lcd);

void setup() {
  M5.begin();  //初始化 M5Core2
  img.deleteSprite();    //从内存中删除画布
}

void loop() {}

注意:
LCD.img は均一に此ファイルを継承し、使用法は類似 In_eSPI.h , 使い方も似ています

1. Arduino Setup

4. Program & Upload

2. API & Examples

M5Core

M5Core2

M5CoreS3

M5Tough

M5Atom

M5AtomS3

M5Capsule

M5Cardputer

M5Paper

M5CoreInk

M5StickC

M5StickCPlus2

M5TimerCAM

M5NanoC6

3. M5Unified & M5GFX

M5Unified

M5GFX

LCD スクリーン

begin()

sleep()

clear()

wakeup()

hight()

width()

getCursorX()

getCursorY()

getRotation()

getTextDatum()

setCursor()

setRotation()

SetLcdVoltage()

alphaBlend()

setFreeFont()

loadFont()

unloadFont()

fontsLoaded()

fillScreen()

invertDisplay()

color565()

Text

print()

textWidth()

setTextSize()

setTextColor()

setTextWrap()

setTextPadding()

setTextDatum()

Draw

drawFastHLine()

drawFastVLine()

drawString()

drawNumber()

drawChar()

drawFloat()

drawPixel()

drawLine()

drawRect()

fillRect()

drawRoundRect()

fillRoundRect()

drawCircle()

fillCircle()

drawEllipse()

fillEllipse()

drawTriangle()

drawTriangle()

drawXBitmap()

drawBitmap()

drawBmpFile()

drawJpg()

drawJpgFile()

progressBar()

qrcode()

Sprite

setColorDepth()

createSprite()

fillSprite()