SetGraphMode

画面モードの変更

SetGraphMode ScreenSizeX, ScreenSizeY, ColorBitDepth

SizeX , SizeY　:　画面の解像度
ColorBitNum　　:　カラービット数

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

解説

画面の解像度や最大表示色数を変更します。


＜注意＞

この関数を実行するとロードしたすべてのグラフィックハンドルと３Ｄモデルハンドル、
作成したフォントハンドルは自動的に削除され、SetDrawArea, SetDrawScreen, SetDrawMode,
SetDrawBlendMode, SetDrawBright 等の描画に関係する設定を行う関数による設定も全て初期状態に戻りますので、
画面モード変更後 LoadGraph関数や CreateFontToHandle関数等で再度ハンドルを作成し直し、
描画可能領域、描画対象画面等の各種描画系の設定も再度行う必要があります。



画面の解像度は画面を表現するのに使用されるドット（点）の数です。

パソコンのモニターが対応している解像度としては主に

640×480 800×600 1024×768 1280×1024 1280×720 1920×1080

があります。（ デフォルトは640×480です ）。

画面の解像度を上げると画面を構成する点の数が増え表現力も高くなりますが、
そのぶん画面の記憶に必要なメモリ容量も増えますので注意してください。

指定した解像度がモニターやグラフィックスデバイスが対応していない場合は SetFullScreenResolutionMode で設定できる解像度モードに沿ってモニターが対応している別の解像度に拡大されて表示されます。
( 別の解像度に拡大する処理は処理負荷がそこそこ高いので、モニターが対応している解像度を使用することをお勧めします )

カラービット数とは使用する画面の色の数です。

ビットとは２進数の１桁の事で、１６ビットで６５５３６色（Trueカラー）
２４ビットで１６７７万色（フルカラー）表現できます。
ビット数が上がれば上がるほど表現できる色の数は増えますが、その分必要なデータ量も増えますので注意してください。

このライブラリで指定できるカラービット数は１６ビットと３２ビットの二つになります。


指定したカラービット数に対応する３Ｄ機能を持たないグラフィックスデバイスでは３Ｄ機能が使用不可になります。

１６ビットはＤＸライブラリの標準色ビット数で、６５５３６色を使って画像を表現します。

３２ビットは内部的には２４ビットを使って１６６７万色で画像を表現します。（ 残りの８ビットは使用されません ）
このモードを選択するとグラフィックデータのサイズが１６bitモードに比べて２倍になります。

戻り値は、変更が成功した場合は DX_CAHNGESCREEN_OK が失敗して元の画面モードに戻された場合は DX_CHANGESCREEN_RETURN
が失敗して元の画面にも戻せず、デフォルトの画面モード( 640x480 16bit color)に変更された場合は DX_CHANGESCREEN_DEFAULT が、
それすらも失敗した場合はソフトが自動終了します。

なおこの関数を DxLib_Init 関数を使用する前に呼び出すことにより初期状態の画面モードを設定することが出来ます。

この場合は画面モードの変更は DxLib_Init が呼ばれた際に行われるので画面モードの変更が成功するかどうか分からず、
関数は必ず DX_CHANGESCREEN_OK を返します。

戻り値:
  DX_CHANGESCREEN_OK　　　: 画面変更は成功した
  DX_CHANGESCREEN_RETURN　: 画面の変更は失敗し元の画面モードに戻された
  DX_CHANGESCREEN_DEFAULT : 画面の変更は失敗し標準の画面モードに変更された

サンプル

SetGraphMode 1280, 720, 32  ; 1280x720 32bit

関連項目

情報