目次 - SDL 3.0 API(機能別) - ピクセル形式と変換 - SDL_GetPixelFormatDetails

SDL_GetPixelFormatDetails

ピクセル形式と一致するSDL_PixelFormatDetailsを生成する

ヘッダ

SDL3/SDL_pixels.h

構文

const SDL_PixelFormatDetails * SDL_GetPixelFormatDetails(SDL_PixelFormat format);

引数

SDL_PixelFormatformatピクセル形式SDL_PixelFormatの値の1つ

戻り値

(const SDL_PixelFormatDetails *) SDL_PixelFormatDetailsへのポインタを戻す. 失敗のときNULLを戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

戻された構造体は, (新しく確保された領域ではなく)共通のグローバルな領域なので, 変更してはならない. 特にパレットはそうである. "Blit combination not supported" のような不可解なエラーが発生するだろう.

スレッドセーフ

この関数はどのスレッドからも安全に呼べる.

バージョン

SDL 3.2.0以降

SDL Wikiへのリンク

SDL_GetPixelFormatDetails - SDL Wiki