M5Stackシリーズでファイルシステム（LittleFS，microSD）上にある画像を次々と表示するプログラムです。
以下の2種類の表示方法があります。
- 手動（Manul）モード
Aボタン（正順）・Cボタン（逆順）を押すたびに画像を切り替えて表示します。M5Dialの場合はダイヤルを左右（逆順・正順）に回すことで画像を切り替えます。 - 自動（Auto）モード
設定ファイルで指定した間隔（ミリ秒）で表示します。指定した表示間隔を最大値としたランダムの間隔で表示することもできます。
PlatformIO IDE環境でコンパイルします。機種に合わせて環境を選択してください。
-sdがついている環境ではLittleFSの代わりにmicroSDカードを使用します。
| 機種 | 環境 |
|---|---|
| M5Stack BASIC | env:m5stack-basic(-sd) |
| M5Stack Fire | env:m5stack-fire(-sd) |
| M5Go | env:m5stack-m5go(-sd) |
| M5Stack Core2 | env:m5stack-core2(-sd) |
| M5Stack Core3 | env:m5stack-core3(-sd) |
| M5Stick C | env:m5stick-c |
| M5Stick C Plus | env:m5stick-c-plus |
| M5Stick C Plus2 | env:m5stick-c-plus2 |
| M5ATOM S3 | env:m5stack-atoms3 |
| M5Dial | env:m5stack-dial |
| M5Cardputer | env:m5stack-cardputer(-sd) |
| M5DinMeter | env:m5stack-din-meter |
| CoreInk | env:m5stack-coreink |
| M5Paper | env:m5stack-paper(-sd) |
デフォルトの表示の向きは機種ごとに違います。
| 機種 | 環境 | デフォルトの表示の向き |
|---|---|---|
| M5Stack BASIC | env:m5stack-basic(-sd) | 1 |
| M5Stack Fire | env:m5stack-fire(-sd) | 1 |
| M5Go | env:m5stack-m5go(-sd) | 1 |
| M5Stack Core2 | env:m5stack-core2(-sd) | 1 |
| M5Stack Core3 | env:m5stack-core3(-sd) | 1 |
| M5Stick C | env:m5stick-c | 0 |
| M5Stick C Plus | env:m5stick-c-plus | 0 |
| M5Stick C Plus2 | env:m5stick-c-plus2 | 0 |
| M5ATOM S3 | env:m5stack-atoms3 | 0 |
| M5Dial | env:m5stack-dial | 0 |
| M5Cardputer | env:m5stack-cardputer(-sd) | 1 |
| M5DinMeter | env:m5stack-din-meter | 0 |
| CoreInk | env:m5stack-coreink | 0 |
| M5Paper | env:m5stack-paper(-sd) | 1 |
設定ファイルdata/image-viewer.jsonで以下を設定できます。
AutoMode
自動表示モードのオン（true）・オフ（false）AutoModeInterval
自動表示モードのときの画像の切り替え間隔（ミリ秒）AutoModeRandomized
ランダム切り替え間隔モードのオン（true）・オフ（false）AutoRotationIMUを内蔵している機種で表示を自動的に向きに追従させるか（true）・追従させないか（false）Orientation
表示の向き（M5GFX::setRotation()に渡す値）
設定ファイルがない場合は，自動モードはオフ（false），切り替え間隔は 3 秒（3000 ミリ秒），ランダム切り替え間隔モードはオフ（false），画面の向きに追従させる（true），表示の向きはデフォルトの表示の向きになります。
{
"AutoMode": false,
"AutoModeInterval": 3000,
"AutoModeRandomized": false,
"AutoRotation": false,
"Orientation": 1
}AutoRotationをfalseに設定し，Orientationの値を指定することで表示の向きを固定することができます。
{
"AutoMode": false,
"AutoModeInterval": 3000,
"AutoModeRandomized": false,
"AutoRotation": true
}ランダム切り替え間隔モードをオンにすると，0 ミリ秒からAutoModeIntervalで指定したミリ秒の間のランダムな間隔で画像を切り替えます。
この設定ファイルは次の「表示する画像のアップロード」の際に画像と一緒に実機のファイルシステムにアップロードされます。
設定ファイル（image-viewer.json）と表示する画像ファイル（PNG，JPEG，BMP）をmicroSDカードのルートディレクトリに置きます。使用するmicroSDカードの最大容量は16GBのものを用意し，FAT32でフォーマットしてください。
設定ファイル（image-viewer.json）と表示する画像ファイル（PNG，JPEG，BMP）をdataディレクトリに置き，以下のいずれかの方法で実機にアップロードします。
- PlatformIO メニューから「Upload Filesystem Image」を選択する。
- コマンドラインから
pio run --target uploadfsを実行する。
このとき，設定ファイルdata/image-viewer.jsonも含め，dataディレイクトリに置かれているファイルはすべて実機にアップロードされます。
プログラムを起動すると，ファイルシステムにある画像ファイル（PNG，JPEG，BMP）を順に表示します。通常は設定ファイルで指定したモードで起動します。Aボタンを押しながら起動すると，設定にかかわらず自動モードになります。
IMUが使える場合は，画面の向きに合わせて表示が自動的に切り替わります。
起動すると以下の画面が表示されます。設定ファイルがない場合Config:の情報は表示されません。
Image Viewer v1.0.6
Config:
/image-viewer.json
AutoMode: false
Interval: 3000ms
Randomized: false
AutoRotation: true
Orientation: CW_0, CW_90, CW_180, CW_270, CCW_0, CCW_90, CCW_180, or CCW_270
Mode:
Manual, Auto, or Auto(Forced)
Rotation:
Auto, No, or No(IMU disabled)
Image Files:
画像ファイル1
画像ファイル2
...
画像ファイルN
ファイルシステム上に画像ファイルがない場合は，以下のように表示されます。
Image Viewer v1.0.6
Config:
/image-viewer.json
AutoMode: false
Interval: 3000ms
Randomized: false
AutoRotation: true
Orientation: CW_0, CW_90, CW_180, CW_270, CCW_0, CCW_90, CCW_180, or CCW_270
Mode:
Manual, Auto, or Auto(Forced)
Rotation:
Auto, No, or No(IMU disabled)
No image files found
画面に画像一覧が表示されてから一定時間（デフォルトは 3 秒）が経過すると表示モードに応じて画面に画像が表示されます。
配布用ファームウェアファイルは以下のいずれかの方法で生成できます。
- PlatformIO メニューから「Custom/Generate User Custom」を選択する。
- コマンドラインから
pio run --target firmwareを実行する。
firmwareディレクトリに[機種名]_[名前]_firmware_[バージョン].binファイルが生成されます。
生成されるファームウェアの設定に関しては，platformio.iniファイルのimage-viewerセクションにある以下の項目を参照してください。
- 機種名
custom_firmware_target
各機種を表す文字列が各環境ごとに定義されています。
例：M5Stack Basic = m5basic - ファームウェアの名前
custom_firmware_name（初期値：image_viewer） - ファームウェアのバージョンが書かれているファイル名
custom_firmware_version_file（初期値：ImageViewer.cpp）
ソースコードの書かれている"vX.Y.Z"からX.Y.Zの値を抽出します。 - ファームウェアの拡張子（ドットは不要）
custom_firmware_suffix（初期値：bin） - 生成先ディレクトリ
custom_firmware_dir（初期値：firmware）