目次 - SDL 2.0 API(機能別) - 電源管理 - SDL_PowerState
(SDL3バージョンはSDL3/SDL_PowerStateを参照すること)
SDL_PowerState
システムの電源の基本的な状態の列挙体
値
| SDL_POWERSTATE_UNKNOWN | 電源を特定できない |
| SDL_POWERSTATE_ON_BATTERY | 接続されずバッテリーで動作している |
| SDL_POWERSTATE_NO_BATTERY | 接続されている. バッテリーなし |
| SDL_POWERSTATE_CHARGING | 接続されている. 充電中 |
| SDL_POWERSTATE_CHARGED | 接続されている. 充電完了 |
サンプルコード
if (SDL_GetPowerInfo(NULL, NULL) == SDL_POWERSTATE_ON_BATTERY) {
printf("アップデート前にノートPCを電源に接続してください¥n");
}
詳細
全てのマシンにバッテリーがあるのではなく, 全ての環境がバッテリー状態を得られるのでもない.
瞬間的にバッテリーの状態を得られないこともある.
よって, 常にSDL_GetPowerInfo()でSDL_POWERSTATE_UNKNOWNを得た場合の準備をする必要がある.
また, バッテリーは揺らぎのあるハードウェアである.
つまり, 得られた状態は2つの状態の間を明確な理由がなくても揺らいでいる可能性がある.
関連項目(関数)
SDL_GetPowerInfo
SDL Wikiへのリンク
SDL_PowerState - SDL Wiki