目次 - SDL 3.0 API(機能別) - ビデオキャプチャ - SDL_CameraID

SDL_GetCameraFormat

カメラが画像を生成するとき使用するスペックを得る

ヘッダ

SDL3/SDL_camera.h

構文

bool SDL_GetCameraFormat(SDL_Camera *camera, SDL_CameraSpec *spec);

引数

SDL_Camera *cameraオープンしたカメラデバイス
SDL_CameraSpec *specカメラのオープン時のスペック

戻り値

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

詳細

これはハードウェアの直接の形式ではない可能性があるので注意すること. SDLが背後でこの形式に変換している場合がある.

システムがユーザにカメラへのアクセス許可を待っている場合, この関数は偽を戻すが, 致命的なエラーとは限らない. アプリケーションはSDL_EVENT_CAMERA_DEVICE_APPROVED(またはSDL_EVENT_CAMERA_DEVICE_DENIED)イベントを待つか, SDL_GetCameraPermissionState()が0以外を戻すまでポーリングする必要がある.

スレッドセーフ

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

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_GetCameraFormat - SDL Wiki