love.window.setMode (日本語)

LÖVE 0.9.0 から使用可能
love.graphics.setMode から移行。


ディスプレイ・モードとウィンドウのプロパティを設定します。

幅または高さに 0 を指定したとき setMode はデスクトップの幅と高さを使用します。

ディスプレイ・モードの変更には場合により副作用があります: 例えば、キャンバスは消去されて値はシェーダーである Shader:send へ送られた後に消去されます。事前にキャンバスの内容を保存しておくか必要であれば後で再描画を行ってください。

関数

概要

success = love.window.setMode( width, height, flags )

引数

number width
ウィンドウの幅。
number height
ウィンドウの高さ。
table flags
テーブルはウィンドウのプロパティです:
boolean fullscreen (false)
フルスクリーン (true), またはウィンドウ (false)。
FullscreenType fullscreentype ("desktop")
使用するフルスクリーンモードの種類。この標準値は 0.9.2 以前では "normal" です。
boolean vsync (true)
True ならば LÖVE は vsync (垂直同期) 待ちを行いますが、それ以外は false です。
number msaa (0)
アンチエイリアスのサンプル数。
boolean resizable (false)
True ならばウィンドウはサイズ変更可能なウィンドウモードであり、それ以外は false です。
boolean borderless (false)
True ならばウィンドウは枠なしウィンドウモードであり、それ以外は false です。
boolean centered (true)
True ならばウィンドウは中央表示のウィンドウモードであり、それ以外は false です。
number display (1)
マルチモニターが利用可能ならば、ウィンドウが表示されているディスプレイの番号。
number minwidth (1)
サイズ変更可能ならば、ウィンドウの最小の幅。 1 未満は指定できません。
number minheight (1)
サイズ変更可能ならば、ウィンドウの最大の高さ。 1 未満は指定できません。
boolean highdpi (false)
True ならば high-dpi mode は OS X および iOS で Retina ディスプレイで許可されています。これは非-Retina ディスプレイでは関係ありません。 0.9.1 から追加。
number x (nil)
指定されたディスプレイにおけるウィンドウの x 座標位置。0.9.2 から追加。
number y (nil)
指定されたディスプレイにおけるウィンドウの y 座標位置。0.9.2 から追加。
boolean srgb (false)
0.10.0 で廃止。(代わりに t.gammacorrect を conf.lua で設定してください)。True ならば 画面への描画時に sRGB ガンマ補正を適用します。 0.9.1 から追加。

返値

boolean success
true ならば成功であり、それ以外は false です。

注釈

フルスクリーンが有効になったが非対応の幅または高さである場合(love.window.getFullscreenModes を参照)、ウィンドウは最も近くて利用可能な解像度へサイズ変更されて resize イベントが発生します。

フルスクリーンの種類が "desktop" ならば、ウィンドウの大きさは自動的にデスクトップの解像度と同じ値へ変更されます。

conf.lua で window を無効 (つまり t.window = false) にしている場合および本関数を使用して手動でウィンドウを作成するならば、その前に love.graphics.* 全関数群の呼び出しを一切行ってはいけません。 OpenGL はウィンドウ無しでは正常に機能しない故に、そうしてしまうと不確定な振る舞いおよび・またはクラッシュの原因になります。

現在のところ背景の透過には対応していません。

用例

vsyncを無効にしたウインドウをサイズ変更可能して最小の幅と高さを設定します。

function love.load()
    love.window.setMode(800, 600, {resizable=true, vsync=false, minwidth=400, minheight=300})
end

関連


そのほかの言語

Dansk – Deutsch – English – Español – Français – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Polski – Português – Română – Slovenský – Suomi – Svenska – Türkçe – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – ไทย – 日本語 – 正體中文 – 简体中文 – Tiếng Việt – 한국어
More info

Retrieved from "http://www.love2d.org/w/index.php?title=love.window.setMode_(日本語)&oldid=17319"