目次 - SDL 3.0 API(機能別) - 2Dレンダリング - SDL_RenderDebugText

SDL_RenderDebugText

SDL_Rendererにデバッグ用テキストを描く

ヘッダ

SDL3/SDL_render.h

構文

bool SDL_RenderDebugText(SDL_Renderer *renderer, float x, float y, const char *str);

引数

SDL_Renderer *rendererテキストを1行描くレンダラ
floatxテキストの左上のX座標
floatyテキストの左上のY座標
const char *strレンダリングするテキスト

戻り値

(bool) 成功のとき真, 失敗のとき偽を戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

この関数はSDL_Rendererに1行の文字列をレンダリングする. これはデバッグを目的とした関数で, 強い制限があり, アプリケーションやゲームでの使用には適さない.

これらの制限がある:

本当にテキストのレンダリングが必要な場合は, SDL_ttf, stb_truetypeなどの複数の外部ライブラリが存在する.

初めに, この関数はグリフのレンダリングのためのテクスチャを内部に生成する. このテクスチャはレンダラを破棄するまで存在する.

色を付けてテキストを描きたい場合はSDL_SetRenderDrawColor()で指定すること.

スレッドセーフ

この関数を呼べるのはメインスレッドのみである.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_RenderDebugText - SDL Wiki