SetFullScreenResolutionMode

フルスクリーンモード時の解像度モードを設定する

SetFullScreenResolutionMode ResolutionMode

ResolutionMode : フルスクリーンモード時の解像度モード
DX_FSRESOLUTIONMODE_BORDERLESS_WINDOW
デスクトップ画面と同じ大きさのウィンドウを生成して擬似的にフルスクリーンにするモード
DX_FSRESOLUTIONMODE_NATIVE
モニターの解像度を SetGraphMode で指定した解像度に変更するモード
DX_FSRESOLUTIONMODE_DESKTOP
モニターの解像度をデスクトップ画面と同じにして
SetGraphMode で指定した解像度の画面を拡大して表示するモード(デフォルト)
DX_FSRESOLUTIONMODE_MAXIMUM
モニターの解像度を最大にして、SetGraphMode で指定した解像度の画面を
拡大して表示するモード

(プラグイン / モジュール : DxLibW)

解説

フルスクリーンモードで実行する場合の画面解像度の決定に関する動作モードを設定する関数です。

DX_FSRESOLUTIONMODE_BORDERLESS_WINDOW

モニターの解像度は変更せず、縁無しウィンドウのサイズをデスクトップ画面と同じにすることで画面を

ウィンドウで覆い、擬似的にフルスクリーンにするモードです。

厳密にはウィンドウモードなので、フォーカスが他のソフトに移っても画面モードの切り替えが発生しません。

そのため画面モード切り変えの待ち時間が無く、また、画面解像度変更などに伴うデスクトップ画面内の

アイコンの配置が変わってしまう等の現象も発生しないのが利点となります。

ただ、欠点としてデスクトップ画面のサイズが SetGraphMode で指定した解像度より小さい場合は

デスクトップ画面のサイズに縮小して表示されます。

デフォルトではこのモードになっています。

DX_FSRESOLUTIONMODE_NATIVE

モニターの解像度を SetGraphMode で指定した解像度に変更します。

モニターが SetGraphMode で指定した解像度に対応していない場合は、

DX_FSRESOLUTIONMODE_DESKTOP と同じ動作をします。

モニターが SetGraphMode で指定した解像度に対応している場合は、ScreenFlip が4種類の

モードの中で最も高速に動作します。

DX_FSRESOLUTIONMODE_DESKTOP

モニターの解像度をデスクトップ画面と同じにして、SetGraphMode で指定した解像度の画面を

縦横比を維持しながら拡大して表示します。( 余分な部分は黒で塗りつぶされます )

SetGraphMode で指定した解像度がデスクトップ画面の解像度よりも高い場合は

DX_FSRESOLUTIONMODE_MAXIMUM と同じ動作をします。

モニターの縦横比と異なる縦横比の解像度を指定しても、モニターの縦横比で表示してしまう

モニターも存在するので( 結果画像が横( 又は縦 )に伸びで表示されてしまう )、

デスクトップ画面の解像度を使用することで意図した通りの表示結果が得られる

確率が上がります。( デスクトップ画面を横や縦に伸びて表示される解像度に

設定している人は少ない為 )

ただ、SetGraphMode で指定した解像度の画面をデスクトップ画面の解像度に拡大する処理が

実行されるので、ScreenFlip の動作速度は DX_FSRESOLUTIONMODE_NATIVE よりも

遅くなります。

DX_FSRESOLUTIONMODE_MAXIMUM

モニターの解像度を最大にして、SetGraphMode で指定した解像度の画面を縦横比を維持しながら

拡大して表示します。( 余分な部分は黒で塗りつぶされます )

この設定と SetFullScreenScalingMode で拡大モードに

DX_FULLSCREENSCALINGMODE_NEAREST を指定すると、最もドットがくっきり

四角く表示されます。

ただ、SetGraphMode で指定した解像度の画面をモニターの最大解像度に拡大する処理が実行

されるので、ScreenFlip の動作速度は4種類のモードの中で最も遅くなります。


<注意>

この関数は DxLib_Init を呼び出す前にのみ実行することが出来ます。

DxLib_Init を呼び出した後にこの関数を実行しても何も効果はありませんのでご注意ください。

戻り値:
  0:成功

関連項目

GetFullScreenResolutionModeフルスクリーン解像度モードを取得する( UseResolutionMode は実際に使用されている解像度モード( 例えば DX_FSRESOLUTIONMODE_NATIVE を指定していてもモニタが指定の解像度に対応していない場合は UseResolutionMode が DX_FSRESOLUTIONMODE_DESKTOP や DX_FSRESOLUTIONMODE_MAXIMUM になります ) )(DxLibW)

情報

プラグイン / モジュールDxLibW
バージョン3.24f
作成日2026/04/12
著作者DxLib: Takumi Yamada / HSP binding: IronHSP Project
URLhttps://dxlib.xsrv.jp/
備考hspdxlib.as をインクルードして使用
タイプDxLib ゲームライブラリ
グループDxLib ウィンドウ
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\hspdxlib.hs