Difference between revisions of "Config Files (日本語)"
m (Unfinished. zzz...) |
m |
||
Line 1: | Line 1: | ||
== はじめに == | == はじめに == | ||
− | <code>conf.lua</code> ファイルがゲームのフォルダ(または .love ファイル)にある場合、そのファイルは LÖVE のモジュールが読み込まれる''前に''実行されます。このファイルは love.conf 関数を上書きするために使用でき、後で LÖVE の 'boot' スクリプトにより呼ばれます。 love.conf | + | <code>conf.lua</code> ファイルがゲームのフォルダ (または .love ファイル) にある場合、そのファイルは LÖVE のモジュールが読み込まれる''前に''実行されます。このファイルは love.conf 関数を上書きするために使用でき、後で LÖVE の 'boot' スクリプトにより呼ばれます。 love.conf 関数により、構成オプション、およびウィンドウのデフォルトの大きさ、読み込まれるモジュール、およびその他の要素などを変更できます。 |
== love.conf == | == love.conf == | ||
Line 21: | Line 21: | ||
ゲームの発表時は未使用のモジュールへ false を設定することは推奨されます。これにより起動開始時間を多少短縮して(特に joystick モジュールを無効にした場合)、メモリの使用量を(多少)減らせます。 | ゲームの発表時は未使用のモジュールへ false を設定することは推奨されます。これにより起動開始時間を多少短縮して(特に joystick モジュールを無効にした場合)、メモリの使用量を(多少)減らせます。 | ||
− | [[love.filesystem (日本語)|love.filesystem]] と [[love (日本語)|love]] | + | 注意すべきことは [[love.filesystem (日本語)|love.filesystem]] と [[love (日本語)|love]] モジュールは対象外であり、無効化できません。また、 [[love.graphics (日本語)|love.graphics]] を有効にするには [[love.window (日本語)|love.window]] が必要です。 |
− | + | ||
+ | LÖVE version 0.9.2 以前では、構成ファイルに異常があると、ゲームは起動はせず、エラーメッセージすら表示されません。ゲームが読み込まれない場合、最初に構成ファイルの異常を調べる必要がありました。 LÖVE version 0.10.2 以降では、構成ファイルに異常があると、青色のエラー画面で構成ファイルの異常内容を表示します。 | ||
== 最新版の構成ファイル == | == 最新版の構成ファイル == | ||
− | 下記は LÖVE [[11.3]] のオプションとデフォルト値のリストです: | + | 下記は LÖVE [[11.3 (日本語)|11.3]] のオプションとデフォルト値のリストです: |
<source lang="lua"> | <source lang="lua"> | ||
function love.conf(t) | function love.conf(t) | ||
t.identity = nil -- セーブ・ディレクトリの名称 (string) | t.identity = nil -- セーブ・ディレクトリの名称 (string) | ||
− | t.appendidentity = false -- | + | t.appendidentity = false -- このフラグはソースディレクトリの後にセーブディレクトリのファイルを検索するどうか (boolean) |
t.version = "11.3" -- このゲームの作成に使用した LÖVE のバージョン (string) | t.version = "11.3" -- このゲームの作成に使用した LÖVE のバージョン (string) | ||
t.console = false -- コンソールの表示 (boolean, Windows 専用) | t.console = false -- コンソールの表示 (boolean, Windows 専用) | ||
Line 37: | Line 38: | ||
t.gammacorrect = false -- 対応システムでの動作時、ガンマ補正レンダリングを有効にするか (boolean) | t.gammacorrect = false -- 対応システムでの動作時、ガンマ補正レンダリングを有効にするか (boolean) | ||
− | t.audio.mic = false -- | + | t.audio.mic = false -- Android で録音機能 (マイク) のアクセスと使用許可を得るかどうか (boolean) |
− | t.audio.mixwithsystem = true -- | + | t.audio.mixwithsystem = true -- LÖVE の起動中に他のアプリのバックグラウンド音楽を再生を続けるか (boolean, iOS と Android のみ) |
t.window.title = "Untitled" -- ウィンドウのタイトル (string) | t.window.title = "Untitled" -- ウィンドウのタイトル (string) | ||
Line 50: | Line 51: | ||
t.window.fullscreen = false -- 全画面表示の有効化 (boolean) | t.window.fullscreen = false -- 全画面表示の有効化 (boolean) | ||
t.window.fullscreentype = "desktop" -- 排他的な全画面表示 ("exclusive") またはデスクトップ ("desktop") による全画面表示方式の中から選択 (string) | t.window.fullscreentype = "desktop" -- 排他的な全画面表示 ("exclusive") またはデスクトップ ("desktop") による全画面表示方式の中から選択 (string) | ||
− | t.window.usedpiscale = true -- | + | t.window.usedpiscale = true -- DPI の自動スケーリングの有効化 (boolean) |
t.window.vsync = 1 -- 垂直同期の有効化 (boolean) | t.window.vsync = 1 -- 垂直同期の有効化 (boolean) | ||
t.window.msaa = 0 -- 多重サンプリングされたアンチエイリアシングにて使用するサンプル数 (number) | t.window.msaa = 0 -- 多重サンプリングされたアンチエイリアシングにて使用するサンプル数 (number) | ||
− | t.window.depth = nil -- | + | t.window.depth = nil -- 深度バッファにおけるビット当たりのサンプル数です |
− | t.window.stencil = nil -- | + | t.window.stencil = nil -- ステンシルバッファにおけるビット当たりのサンプル数です |
t.window.display = 1 -- ウィンドウの表示先となるモニタの番号 (number) | t.window.display = 1 -- ウィンドウの表示先となるモニタの番号 (number) | ||
t.window.highdpi = false -- Retina ディスプレイ上のウィンドウで high-dpi モードを有効にするか (boolean) | t.window.highdpi = false -- Retina ディスプレイ上のウィンドウで high-dpi モードを有効にするか (boolean) | ||
Line 83: | Line 84: | ||
== フラグ == | == フラグ == | ||
==== identity ==== | ==== identity ==== | ||
− | + | このフラグはゲーム用のセーブ・ディレクトリの名前を設定します。作成場所ではなく、名前のみ指定することに注意してください。 | |
<source lang="lua"> | <source lang="lua"> | ||
t.identity = "gabe_HL3" -- 正しい | t.identity = "gabe_HL3" -- 正しい | ||
t.identity = "c:/Users/gabe/HL3" -- 誤り | t.identity = "c:/Users/gabe/HL3" -- 誤り | ||
</source> | </source> | ||
− | + | 構成ファイル以外でセーブ・ディレクトリを設定するには [[love.filesystem.setIdentity (日本語)|love.filesystem.setIdentity]] を使用します。 | |
==== appendidentity ==== | ==== appendidentity ==== | ||
− | {{newin (日本語)|[[11.0]]|110|type=フラグ}} | + | {{newin (日本語)|[[11.0 (日本語)|11.0]]|110|type=フラグ}} |
− | + | このフラグはゲームディレクトリの後にセーブディレクトリを検索するか設定します (<code>true</code> または <code>false</code>)。 | |
==== version ==== | ==== version ==== | ||
− | {{newin (日本語)|[[0.8.0]]|080|type=フラグ}} | + | {{newin (日本語)|[[0.8.0 (日本語)|0.8.0]]|080|type=フラグ}} |
<code>t.version</code> は文字列であり、ゲームの制作に使用された LÖVE のバージョン表記です。 | <code>t.version</code> は文字列であり、ゲームの制作に使用された LÖVE のバージョン表記です。 | ||
− | [[11.0 (日本語)|11.0]] 以前では、 <code>"''X.Y.Z''"</code> 形式であり、 <code>''X''</code> は上位リリース番号、 <code>''Y''</code> は下位リリース番号、および <code>''Z''</code> は修正レベルです。 [[11.0 (日本語)|11.0]] 以降では、 <code>"''X.Y.Z''"</code> 形式であり、 <code>''X''</code> および <code>''Y''</code> は上位と下位のリリース番号です。 | + | LÖVE [[11.0 (日本語)|11.0]] 以前では、 <code>"''X.Y.Z''"</code> 形式であり、 <code>''X''</code> は上位リリース番号、 <code>''Y''</code> は下位リリース番号、および <code>''Z''</code> は修正レベルです。 [[11.0 (日本語)|11.0]] 以降では、 <code>"''X.Y.Z''"</code> 形式であり、 <code>''X''</code> および <code>''Y''</code> は上位と下位のリリース番号です。 |
− | このフラグを構成ファイルに設定した場合はゲーム実行開始時に、現在のバージョンの LÖVE とゲームとの互換性がないならば LÖVE | + | このフラグを構成ファイルに設定した場合はゲーム実行開始時に、現在のバージョンの LÖVE とゲームとの互換性がないならば LÖVE は警告を表示します。デフォルトでは実行中の LÖVE のバージョンです。 |
==== console ==== | ==== console ==== | ||
− | + | ゲームのウィンドウの横にコンソールを開くかどうかを設定します (Windows 専用)。注意: OSX では、ターミナルから LÖVE を実行することによりコンソール出力を取得できます。また、 LÖVE [[0.10.2 (日本語)|0.10.2]] の Windows 版では、 <code>love.exe</code> ではなく <code>lovec.exe</code> で実行中の場合もコンソール出力を取得できます。 | |
− | |||
− | |||
==== accelerometerjoystick ==== | ==== accelerometerjoystick ==== | ||
− | {{newin (日本語)|[[0.10.0]]|100|type=フラグ}} | + | {{newin (日本語)|[[0.10.0 (日本語)|0.10.0]]|100|type=フラグ}} |
iOS と Andorid で加速度センサーデバイスを三軸の[[Joystick (日本語)|ジョイスティック]]として割り当てるかどうかを設定します。この機能を使用しない場合は加速度センサーを停止することにより CPU の使用量を減らせるかもしれません。 | iOS と Andorid で加速度センサーデバイスを三軸の[[Joystick (日本語)|ジョイスティック]]として割り当てるかどうかを設定します。この機能を使用しない場合は加速度センサーを停止することにより CPU の使用量を減らせるかもしれません。 | ||
==== externalstorage ==== | ==== externalstorage ==== | ||
− | {{newin (日本語)|[[0.10.1]]|101|type=フラグ}} | + | {{newin (日本語)|[[0.10.1 (日本語)|0.10.1]]|101|type=フラグ}} |
− | Android でファイルを外部ストレージ (true) | + | Android でファイルを外部ストレージ (true)、または内部ストレージ (false) に保存するかどうかを設定します。 |
==== gammacorrect ==== | ==== gammacorrect ==== | ||
− | {{newin (日本語)|[[0.10.0]]|100|type=フラグ}} | + | {{newin (日本語)|[[0.10.0 (日本語)|0.10.0]]|100|type=フラグ}} |
− | システムで対応している場合に、[[love.graphics.isGammaCorrect (日本語)|ガンマ補正レンダリング]] | + | システムで対応している場合に、[[love.graphics.isGammaCorrect (日本語)|ガンマ補正レンダリング]]を有効にするかどうかを設定します。 |
==== audio.mic ==== | ==== audio.mic ==== | ||
− | {{newin (日本語)|[[11.3]]|113|type=フラグ}} | + | {{newin (日本語)|[[11.3 (日本語)|11.3]]|113|type=フラグ}} |
− | + | ユーザからマイクのアクセス許可を要求します。許可時は [[love.audio.getRecordingDevices (日本語)| love.audio.getRecordingDevices]] で利用できる録音デバイスのリストを取得できます。却下時は [[love.audio.getRecordingDevices (日本語)|love.audio.getRecordingDevices]] を呼び出すと空テーブルを返し、ユーザにメッセージを通知します。 | |
− | |||
==== audio.mixwithsystem ==== | ==== audio.mixwithsystem ==== | ||
− | {{newin (日本語)|[[11.0]]|110|type=フラグ}} | + | {{newin (日本語)|[[11.0 (日本語)|11.0]]|110|type=フラグ}} |
− | + | LÖVE の起動中に、他のアプリのバックグラウンド音声や音楽を再生するか設定します。詳細情報は [[love.system.hasBackgroundMusic (日本語)|love.system.hasBackgroundMusic]] をご確認ください。 | |
==== window ==== | ==== window ==== | ||
− | {{newin (日本語)|[[0.9.0]]|090|type=フラグs|plural='y'}} | + | {{newin (日本語)|[[0.9.0 (日本語)|0.9.0]]|090|type=フラグs|plural='y'}} |
− | [[love.window.setMode (日本語)|love.window.setMode]] をコードから最初に呼ぶまでウィンドウの作成を延期することが可能になります。こうするには、 <code>t.window = nil</code> (または旧版では <code>t.screen = nil</code>) にて設定してください。これが処理された場合は、最初の [[love.window.setMode (日本語)|love.window.setMode]] の前に [[love.graphics (日本語)|love.graphics]] | + | [[love.window.setMode (日本語)|love.window.setMode]] をコードから最初に呼ぶまでウィンドウの作成を延期することが可能になります。こうするには、 <code>t.window = nil</code> (または旧版では <code>t.screen = nil</code>) にて設定してください。これが処理された場合は、最初の [[love.window.setMode (日本語)|love.window.setMode]] の前に [[love.graphics (日本語)|love.graphics]] に属する関数をコードから呼び出すと LÖVE はクラッシュします。 |
− | <code>t.window</code> テーブルは LÖVE [[0.9.0]] 以前のバージョンでは <code>t.screen</code> の名称でした。 <code>t.screen</code> テーブルは LÖVE 0.9.0 の love.conf では存在せず、 <code>t.window</code> テーブルは LÖVE 0.8.0 の love.conf では存在しません。 この意味は使用されている LÖVE のバージョンに関する正確なテーブルを使用することに注意しない場合には、 '''love.conf''' の実行は失敗します (従って保護機能によりデフォルト値に復帰されます)。 | + | <code>t.window</code> テーブルは LÖVE [[0.9.0 (日本語)|0.9.0]] 以前のバージョンでは <code>t.screen</code> の名称でした。 <code>t.screen</code> テーブルは LÖVE 0.9.0 の love.conf では存在せず、 <code>t.window</code> テーブルは LÖVE 0.8.0 の love.conf では存在しません。 この意味は使用されている LÖVE のバージョンに関する正確なテーブルを使用することに注意しない場合には、 '''love.conf''' の実行は失敗します (従って保護機能によりデフォルト値に復帰されます)。 |
==== window.title ==== | ==== window.title ==== | ||
− | {{newin (日本語)|[[0.9.0]]|090|type=フラグ}} | + | {{newin (日本語)|[[0.9.0 (日本語)|0.9.0]]|090|type=フラグ}} |
ゲームのウィンドウのタイトルを設定します。構成ファイル以外でウィンドウのタイトルを変更するには [[love.window.setTitle (日本語)|love.window.setTitle]] を使用します。 | ゲームのウィンドウのタイトルを設定します。構成ファイル以外でウィンドウのタイトルを変更するには [[love.window.setTitle (日本語)|love.window.setTitle]] を使用します。 | ||
==== window.icon ==== | ==== window.icon ==== | ||
− | {{newin (日本語)|[[0.9.0]]|090|type=フラグ}} | + | {{newin (日本語)|[[0.9.0 (日本語)|0.9.0]]|090|type=フラグ}} |
− | ウィンドウのアイコンとして使用する画像のファイルパスです。全てのオペレーティングシステムが非常に大きいアイコンの画像に対応しているわけではありません。 | + | ウィンドウのアイコンとして使用する画像のファイルパスです。全てのオペレーティングシステムが非常に大きいアイコンの画像に対応しているわけではありません。 [[love.window.setIcon (日本語)|love.window.setIcon]] でアイコンを変更できます。 |
==== window.width & window.height ==== | ==== window.width & window.height ==== | ||
− | {{newin (日本語)|[[0.9.0]]|090|type=フラグ|plural='y'}} | + | {{newin (日本語)|[[0.9.0 (日本語)|0.9.0]]|090|type=フラグ|plural='y'}} |
ウィンドウの寸法を設定します。これらのフラグへ 0 を設定する場合、LÖVE は自動的に利用者のデスクトップの寸法を使用します。 | ウィンドウの寸法を設定します。これらのフラグへ 0 を設定する場合、LÖVE は自動的に利用者のデスクトップの寸法を使用します。 | ||
==== window.borderless ==== | ==== window.borderless ==== | ||
− | {{newin (日本語)|[[0.9.0]]|090|type=フラグ}} | + | {{newin (日本語)|[[0.9.0 (日本語)|0.9.0]]|090|type=フラグ}} |
ウィンドウからボーダー・ビジュアルを除去します。オペレーティング・システム間での効果に警戒することに注意してください。 | ウィンドウからボーダー・ビジュアルを除去します。オペレーティング・システム間での効果に警戒することに注意してください。 | ||
==== window.resizable ==== | ==== window.resizable ==== | ||
− | {{newin (日本語)|[[0.9.0]]|090|type=フラグ}} | + | {{newin (日本語)|[[0.9.0 (日本語)|0.9.0]]|090|type=フラグ}} |
true に設定された場合は利用者によりゲーム・ウィンドウの大きさを変更することを許可します。 | true に設定された場合は利用者によりゲーム・ウィンドウの大きさを変更することを許可します。 | ||
− | ==== window.minwidth | + | ==== window.minwidth & window.minheight ==== |
− | {{newin (日本語)|[[0.9.0]]|090|type= | + | {{newin (日本語)|[[0.9.0 (日本語)|0.9.0]]|090|type=フラグs|plural='y'}} |
利用者がウィンドウの大きさを変更できる場合にゲームのウィンドウの最小幅および高さを設定します。 <code>window.width</code> および <code>window.height</code> へ低い値を設定する場合、 LÖVE は <code>window.minwidth</code> および <code>window.minheight</code> を用いて常に最小寸法を指定します。 | 利用者がウィンドウの大きさを変更できる場合にゲームのウィンドウの最小幅および高さを設定します。 <code>window.width</code> および <code>window.height</code> へ低い値を設定する場合、 LÖVE は <code>window.minwidth</code> および <code>window.minheight</code> を用いて常に最小寸法を指定します。 | ||
==== window.fullscreen ==== | ==== window.fullscreen ==== | ||
− | {{newin (日本語)|[[0.9.0]]|090|type=フラグ}} | + | {{newin (日本語)|[[0.9.0 (日本語)|0.9.0]]|090|type=フラグ}} |
ゲームを全画面表示 (<code>true</code>) またはウィンドウ (<code>false</code>) 表示方式で実行するかどうかを指定します。全画面表示に関しては [[love.window.setFullscreen (日本語)|love.window.setFullscreen]] または [[love.window.setMode (日本語)|love.window.setMode]] を用いて全画面表示・ウィンドウ表示の相互間切り替えを行うことができます。 | ゲームを全画面表示 (<code>true</code>) またはウィンドウ (<code>false</code>) 表示方式で実行するかどうかを指定します。全画面表示に関しては [[love.window.setFullscreen (日本語)|love.window.setFullscreen]] または [[love.window.setMode (日本語)|love.window.setMode]] を用いて全画面表示・ウィンドウ表示の相互間切り替えを行うことができます。 | ||
==== window.fullscreentype ==== | ==== window.fullscreentype ==== | ||
− | {{newin (日本語)|[[0.9.0]]|090|type=フラグ}} | + | {{newin (日本語)|[[0.9.0 (日本語)|0.9.0]]|090|type=フラグ}} |
− | [[FullscreenType (日本語)| | + | [[FullscreenType (日本語)|全画面表示方式]]から指定します (<code>exclusive</code> または <code>desktop</code>)。 |
+ | 一般的に <code>desktop</code> を推奨しますが、特定のオペレーティング・システムでは <code>exclusive</code> 方式のほうが制限は少ないです (注釈: [[0.9.2 (日本語)|0.9.2]] 以前では <code>exclusive</code> ではなく <code>normal</code> を使用します)。 | ||
==== window.usedpiscale ==== | ==== window.usedpiscale ==== | ||
− | {{newin (日本語)|[[11.3]]|113|type=フラグ}} | + | {{newin (日本語)|[[11.3 (日本語)|11.3]]|113|type=フラグ}} |
− | + | [[love.window.getDPIScale (日本語)|DPI]] の自動スケーリングの有効、または無効化を設定します。 | |
==== window.vsync ==== | ==== window.vsync ==== | ||
− | {{newin (日本語)|[[0.9.0]]|090|type=フラグ}} | + | {{newin (日本語)|[[0.9.0 (日本語)|0.9.0]]|090|type=フラグ}} |
− | 垂直同期 (VSYNC) | + | 垂直同期 (VSYNC) の有効または無効化します。 VSYNC は安定したフレームレートでゲームを持続させることで画面のティアリング (ちらつき、歪み) に関する問題を予防できます。これを無効にする意味に関して、なるべく多くの知識がなければ VSYNC を有効にしたままにおくことが推奨されます。 LÖVE 11.0 以前では、この値はブール値です (<code>true</code> または <code>false</code>)。 LÖVE 11.0 以降では、この値は数値です (1 は垂直同期の有効化、 0 は垂直同期の無効化、 -1 は対応時に適応型垂直同期を使用します)。 |
− | + | iOS での注意点として、垂直同期は常時有効であり変更不能です。 | |
==== window.depth ==== | ==== window.depth ==== | ||
− | {{newin (日本語)|[[11.0]]|110|type=フラグ}} | + | {{newin (日本語)|[[11.0 (日本語)|11.0]]|110|type=フラグ}} |
− | + | 深度バッファにおけるビット当たりのサンプル数です (16/24/32 より指定。デフォルトは <code>nil</code>) | |
==== window.stencil ==== | ==== window.stencil ==== | ||
− | {{newin (日本語)|[[11.0]]|110|type=フラグ}} | + | {{newin (日本語)|[[11.0 (日本語)|11.0]]|110|type=フラグ}} |
− | + | ステンシルバッファにおけるビット当たりのサンプル数です (通常は 8 を指定。デフォルトは <code>nil</code>) | |
==== window.msaa ==== | ==== window.msaa ==== | ||
− | {{newin (日本語)|[[0.9.2]]|092|type=フラグ}} | + | {{newin (日本語)|[[0.9.2 (日本語)|0.9.2]]|092|type=フラグ}} |
多重サンプリングされたアンチエイアシングで使用するサンプル数。 | 多重サンプリングされたアンチエイアシングで使用するサンプル数。 | ||
==== window.display ==== | ==== window.display ==== | ||
− | {{newin (日本語)|[[0.9.0]]|090|type=フラグ}} | + | {{newin (日本語)|[[0.9.0 (日本語)|0.9.0]]|090|type=フラグ}} |
マルチモニターを利用できるならば、ウィンドウを表示するディスプレイの番号を指定します。 | マルチモニターを利用できるならば、ウィンドウを表示するディスプレイの番号を指定します。 | ||
==== window.highdpi ==== | ==== window.highdpi ==== | ||
− | {{newin (日本語)|[[0.9.1]]|091|type=フラグ}} | + | {{newin (日本語)|[[0.9.1 (日本語)|0.9.1]]|091|type=フラグ}} |
[[love.window.fromPixels (日本語)|love.window.getPixelScale]], [[love.window.toPixels (日本語)|love.window.toPixels]], および [[love.window.fromPixels (日本語)|love.window.fromPixels]] を参照してください。正確な表示を確実にするためにコードの微調整が必要であるため、Retina ディスプレイが搭載されている Mac または iOS システムでゲームの動作確認ができない場合は、このオプションは無効にしたままにしておくことを推奨します。 | [[love.window.fromPixels (日本語)|love.window.getPixelScale]], [[love.window.toPixels (日本語)|love.window.toPixels]], および [[love.window.fromPixels (日本語)|love.window.fromPixels]] を参照してください。正確な表示を確実にするためにコードの微調整が必要であるため、Retina ディスプレイが搭載されている Mac または iOS システムでゲームの動作確認ができない場合は、このオプションは無効にしたままにしておくことを推奨します。 | ||
− | + | LÖVE [[11.0 (日本語)|11.0]] 以降より、このフラグに関係なく Android で High DPI は常時有効であることに注意してください。 | |
− | ==== window.x | + | ==== window.x & window.y ==== |
− | {{newin (日本語)|[[0.9.2]]|092|type=フラグ|plural='y'}} | + | {{newin (日本語)|[[0.9.2 (日本語)|0.9.2]]|092|type=フラグ|plural='y'}} |
− | + | 利用者の画面上にあるウィンドウの位置を設定します。代わりに [[love.window.setPosition (日本語)|love.window.setPosition]] を位置の即時変更にて使用することができます。 | |
==== window.fsaa ==== | ==== window.fsaa ==== | ||
− | {{newinoldin (日本語)|[[0.9.0]]|090|[[0.10.0]]|100|type=フラグ|text=このフラグは window.msaa フラグへ変更されました}} | + | {{newinoldin (日本語)|[[0.9.0 (日本語)|0.9.0]]|090|[[0.10.0 (日本語)|0.10.0]]|100|type=フラグ|text=このフラグは window.msaa フラグへ変更されました}} |
多重サンプリングされたアンチエイアシングで使用するサンプル数。 | 多重サンプリングされたアンチエイアシングで使用するサンプル数。 | ||
==== window.srgb ==== | ==== window.srgb ==== | ||
− | {{newinoldin (日本語)|[[0.9.1]]|091|[[0.10.0]]|100|type=フラグ|text=このフラグは gammacorrect フラグへ変更されました}} | + | {{newinoldin (日本語)|[[0.9.1 (日本語)|0.9.1]]|091|[[0.10.0 (日本語)|0.10.0]]|100|type=フラグ|text=このフラグは gammacorrect フラグへ変更されました}} |
このウィンドウのフラグを有効にすると、主画面へ描画された全ての物に対して線形 RGB 色空間から sRGB 色空間へ自動的に色を変換します - ウィンドウの表面はガンマ空間の sRGB として処理されます。これはガンマ補正表示の要素のみであり、混乱しやすい高度な話題であるため、意味が理解できない場合は、このオプションは無効化しておくことを推奨します。 | このウィンドウのフラグを有効にすると、主画面へ描画された全ての物に対して線形 RGB 色空間から sRGB 色空間へ自動的に色を変換します - ウィンドウの表面はガンマ空間の sRGB として処理されます。これはガンマ補正表示の要素のみであり、混乱しやすい高度な話題であるため、意味が理解できない場合は、このオプションは無効化しておくことを推奨します。 | ||
==== リリース・モード ==== | ==== リリース・モード ==== | ||
− | {{newinoldin (日本語)|[[0.8.0]]|080|[[0.9.0]]|090|type=フラグ}} | + | {{newinoldin (日本語)|[[0.8.0 (日本語)|0.8.0]]|080|[[0.9.0 (日本語)|0.9.0]]|090|type=フラグ}} |
<code>t.release</code> を有効にしたとき、 LÖVE は[[love.releaseerrhand (日本語)|リリース・エラー・ハンドラ]]を使用します。これにより、デフォルトの情報は少しだけ出力されるようになります。もちろん、オーバーライドできます。 | <code>t.release</code> を有効にしたとき、 LÖVE は[[love.releaseerrhand (日本語)|リリース・エラー・ハンドラ]]を使用します。これにより、デフォルトの情報は少しだけ出力されるようになります。もちろん、オーバーライドできます。 | ||
Line 216: | Line 215: | ||
デフォルトのリリース・エラー・ハンドラは開発者と連絡を取るための情報として conf.lua にて指定された <i>title, author および url</i> の値を使用して遊技者へ通知メッセージを出力します。 | デフォルトのリリース・エラー・ハンドラは開発者と連絡を取るための情報として conf.lua にて指定された <i>title, author および url</i> の値を使用して遊技者へ通知メッセージを出力します。 | ||
− | リリース・モードで結合型実行形式 (fused mode) を有効にしたゲームを実行する場合は LÖVE のセーブ・ディレクトリには保存されません。正確には Windows | + | リリース・モードで結合型実行形式 (fused mode) を有効にしたゲームを実行する場合は LÖVE のセーブ・ディレクトリには保存されません。正確には Windows において、以前は <code>%APPDATA%\\LOVE\\game</code> でしたが、現在は <code>%APPDATA%\\game</code> となります。この概念は Windows 以外の動作環境でも適用されます。 |
== 旧バージョン == | == 旧バージョン == | ||
− | 下記は LÖVE [[11.0]] ~ [[11.2]] までのオプションとデフォルト値のリストです: | + | 下記は LÖVE [[11.0 (日本語)|11.0]] ~ [[11.2 (日本語)|11.2]] までのオプションとデフォルト値のリストです: |
<source lang="lua"> | <source lang="lua"> | ||
function love.conf(t) | function love.conf(t) | ||
t.identity = nil -- セーブ・ディレクトリの名称 (string) | t.identity = nil -- セーブ・ディレクトリの名称 (string) | ||
− | t.appendidentity = false -- | + | t.appendidentity = false -- このフラグはソースディレクトリの後にセーブディレクトリのファイルを検索するどうか (boolean) |
t.version = "11.0" -- このゲームの作成に使用した LÖVE のバージョン (string) | t.version = "11.0" -- このゲームの作成に使用した LÖVE のバージョン (string) | ||
t.console = false -- コンソールの表示 (boolean, Windows 専用) | t.console = false -- コンソールの表示 (boolean, Windows 専用) | ||
Line 230: | Line 229: | ||
t.gammacorrect = false -- 対応システムでの動作時、ガンマ補正レンダリングを有効にするか (boolean) | t.gammacorrect = false -- 対応システムでの動作時、ガンマ補正レンダリングを有効にするか (boolean) | ||
− | t.audio.mixwithsystem = true -- | + | t.audio.mixwithsystem = true -- LÖVE の起動中に他のアプリのバックグラウンド音楽を再生を続けるか (boolean, iOS と Android のみ) |
t.window.title = "Untitled" -- ウィンドウのタイトル (string) | t.window.title = "Untitled" -- ウィンドウのタイトル (string) | ||
Line 244: | Line 243: | ||
t.window.vsync = 1 -- 垂直同期の有効化 (boolean) | t.window.vsync = 1 -- 垂直同期の有効化 (boolean) | ||
t.window.msaa = 0 -- 多重サンプリングされたアンチエイリアシングにて使用するサンプル数 (number) | t.window.msaa = 0 -- 多重サンプリングされたアンチエイリアシングにて使用するサンプル数 (number) | ||
− | t.window.depth = nil -- | + | t.window.depth = nil -- 深度バッファにおけるビット当たりのサンプル数です |
− | t.window.stencil = nil -- | + | t.window.stencil = nil -- ステンシルバッファにおけるビット当たりのサンプル数です |
t.window.display = 1 -- ウィンドウの表示先となるモニタの番号 (number) | t.window.display = 1 -- ウィンドウの表示先となるモニタの番号 (number) | ||
t.window.highdpi = false -- Retina ディスプレイ上のウィンドウで high-dpi モードを有効にするか (boolean) | t.window.highdpi = false -- Retina ディスプレイ上のウィンドウで high-dpi モードを有効にするか (boolean) | ||
Line 272: | Line 271: | ||
</source> | </source> | ||
− | 下記は LÖVE [[0.10.1]] および [[0.10.2]] のオプションとデフォルト値における全てのリストです: | + | 下記は LÖVE [[0.10.1 (日本語)|0.10.1]] および [[0.10.2 (日本語)|0.10.2]] のオプションとデフォルト値における全てのリストです: |
<source lang="lua"> | <source lang="lua"> | ||
function love.conf(t) | function love.conf(t) | ||
Line 318: | Line 317: | ||
</source> | </source> | ||
− | 下記は LÖVE [[0.10.0]] のオプションとデフォルト値のリストです: | + | 下記は LÖVE [[0.10.0 (日本語)|0.10.0]] のオプションとデフォルト値のリストです: |
<source lang="lua"> | <source lang="lua"> | ||
function love.conf(t) | function love.conf(t) | ||
Line 362: | Line 361: | ||
end | end | ||
</source> | </source> | ||
− | 下記は LÖVE [[0.9.2]] のオプションとデフォルト値のリストです: | + | 下記は LÖVE [[0.9.2 (日本語)|0.9.2]] のオプションとデフォルト値のリストです: |
<source lang="lua"> | <source lang="lua"> | ||
function love.conf(t) | function love.conf(t) | ||
Line 404: | Line 403: | ||
</source> | </source> | ||
− | 下記は LÖVE [[0.9.1]] のオプションとデフォルト値のリストです: | + | 下記は LÖVE [[0.9.1 (日本語)|0.9.1]] のオプションとデフォルト値のリストです: |
<source lang="lua"> | <source lang="lua"> | ||
function love.conf(t) | function love.conf(t) | ||
Line 444: | Line 443: | ||
</source> | </source> | ||
− | 下記は LÖVE [[0.9.0]] のオプションとデフォルト値のリストです: | + | 下記は LÖVE [[0.9.0 (日本語)|0.9.0]] のオプションとデフォルト値のリストです: |
<source lang="lua"> | <source lang="lua"> | ||
function love.conf(t) | function love.conf(t) | ||
Line 482: | Line 481: | ||
</source> | </source> | ||
− | 下記は LÖVE [[0.8.0]] のオプションとデフォルト値のリストです: | + | 下記は LÖVE [[0.8.0 (日本語)|0.8.0]] のオプションとデフォルト値のリストです: |
<source lang="lua"> | <source lang="lua"> | ||
function love.conf(t) | function love.conf(t) | ||
Line 511: | Line 510: | ||
</source> | </source> | ||
− | 下記は LÖVE [[0.7.2]] 以前のオプションとデフォルト値のリストです: | + | 下記は LÖVE [[0.7.2 (日本語)|0.7.2]] 以前のオプションとデフォルト値のリストです: |
<source lang="lua"> | <source lang="lua"> | ||
function love.conf(t) | function love.conf(t) | ||
Line 542: | Line 541: | ||
[[Category:Callbacks]] | [[Category:Callbacks]] | ||
{{#set:Subcategory=General}} | {{#set:Subcategory=General}} | ||
− | {{#set:Description= | + | {{#set:Description=ゲームのシステム構成を設定します。}} |
{{#set:Since=000}} | {{#set:Since=000}} | ||
== そのほかの言語 == | == そのほかの言語 == | ||
{{i18n (日本語)|Config_Files}} | {{i18n (日本語)|Config_Files}} |
Revision as of 23:55, 9 December 2019
Contents
- 1 はじめに
- 2 love.conf
- 3 最新版の構成ファイル
- 4 フラグ
- 4.1 identity
- 4.2 appendidentity
- 4.3 version
- 4.4 console
- 4.5 accelerometerjoystick
- 4.6 externalstorage
- 4.7 gammacorrect
- 4.8 audio.mic
- 4.9 audio.mixwithsystem
- 4.10 window
- 4.11 window.title
- 4.12 window.icon
- 4.13 window.width & window.height
- 4.14 window.borderless
- 4.15 window.resizable
- 4.16 window.minwidth & window.minheight
- 4.17 window.fullscreen
- 4.18 window.fullscreentype
- 4.19 window.usedpiscale
- 4.20 window.vsync
- 4.21 window.depth
- 4.22 window.stencil
- 4.23 window.msaa
- 4.24 window.display
- 4.25 window.highdpi
- 4.26 window.x & window.y
- 4.27 window.fsaa
- 4.28 window.srgb
- 4.29 リリース・モード
- 5 旧バージョン
- 6 関連
- 7 そのほかの言語
はじめに
conf.lua
ファイルがゲームのフォルダ (または .love ファイル) にある場合、そのファイルは LÖVE のモジュールが読み込まれる前に実行されます。このファイルは love.conf 関数を上書きするために使用でき、後で LÖVE の 'boot' スクリプトにより呼ばれます。 love.conf 関数により、構成オプション、およびウィンドウのデフォルトの大きさ、読み込まれるモジュール、およびその他の要素などを変更できます。
love.conf
love.conf
関数は引数を一つ使用します: テーブルの中にある全てのデフォルト値を望むものへ上書きできます。ウィンドウのデフォルトの大きさを変更したい場合は、例えばこう記述します:
function love.conf(t)
t.window.width = 1024
t.window.height = 768
end
physics モジュールまたは joystick モジュールが不要であれば、下記を記述します。
function love.conf(t)
t.modules.joystick = false
t.modules.physics = false
end
ゲームの発表時は未使用のモジュールへ false を設定することは推奨されます。これにより起動開始時間を多少短縮して(特に joystick モジュールを無効にした場合)、メモリの使用量を(多少)減らせます。
注意すべきことは love.filesystem と love モジュールは対象外であり、無効化できません。また、 love.graphics を有効にするには love.window が必要です。
LÖVE version 0.9.2 以前では、構成ファイルに異常があると、ゲームは起動はせず、エラーメッセージすら表示されません。ゲームが読み込まれない場合、最初に構成ファイルの異常を調べる必要がありました。 LÖVE version 0.10.2 以降では、構成ファイルに異常があると、青色のエラー画面で構成ファイルの異常内容を表示します。
最新版の構成ファイル
下記は LÖVE 11.3 のオプションとデフォルト値のリストです:
function love.conf(t)
t.identity = nil -- セーブ・ディレクトリの名称 (string)
t.appendidentity = false -- このフラグはソースディレクトリの後にセーブディレクトリのファイルを検索するどうか (boolean)
t.version = "11.3" -- このゲームの作成に使用した LÖVE のバージョン (string)
t.console = false -- コンソールの表示 (boolean, Windows 専用)
t.accelerometerjoystick = true -- iOS と Andorid で加速度センサーをジョイスティックと見せかけることを有効にするか (boolean)
t.externalstorage = false -- true にすると Android で外部ストレージにファイルの保存 (およびセーブ・ディレクトリからの読み込み) を行います (boolean)
t.gammacorrect = false -- 対応システムでの動作時、ガンマ補正レンダリングを有効にするか (boolean)
t.audio.mic = false -- Android で録音機能 (マイク) のアクセスと使用許可を得るかどうか (boolean)
t.audio.mixwithsystem = true -- LÖVE の起動中に他のアプリのバックグラウンド音楽を再生を続けるか (boolean, iOS と Android のみ)
t.window.title = "Untitled" -- ウィンドウのタイトル (string)
t.window.icon = nil -- ウィンドウのアイコンとして使用する画像のファイルパス (string)
t.window.width = 800 -- ウィンドウの幅 (number)
t.window.height = 600 -- ウィンドウの高さ (number)
t.window.borderless = false -- ウィンドウの境界線を非表示 (boolean)
t.window.resizable = false -- 利用者がウィンドウの大きさを変更できるかどうか (boolean)
t.window.minwidth = 1 -- ウィンドウの大きさが変更可能な場合におけるウィンドウの最小の幅 (number)
t.window.minheight = 1 -- ウィンドウの大きさが変更可能な場合におけるウィンドウの最小の高さ (number)
t.window.fullscreen = false -- 全画面表示の有効化 (boolean)
t.window.fullscreentype = "desktop" -- 排他的な全画面表示 ("exclusive") またはデスクトップ ("desktop") による全画面表示方式の中から選択 (string)
t.window.usedpiscale = true -- DPI の自動スケーリングの有効化 (boolean)
t.window.vsync = 1 -- 垂直同期の有効化 (boolean)
t.window.msaa = 0 -- 多重サンプリングされたアンチエイリアシングにて使用するサンプル数 (number)
t.window.depth = nil -- 深度バッファにおけるビット当たりのサンプル数です
t.window.stencil = nil -- ステンシルバッファにおけるビット当たりのサンプル数です
t.window.display = 1 -- ウィンドウの表示先となるモニタの番号 (number)
t.window.highdpi = false -- Retina ディスプレイ上のウィンドウで high-dpi モードを有効にするか (boolean)
t.window.x = nil -- 指定先のディスプレイにあるウィンドウ位置の x 座標 (number)
t.window.y = nil -- 指定先のディスプレイにあるウィンドウ位置の y 座標 (number)
t.modules.audio = true -- audio モジュールの有効化 (boolean)
t.modules.data = true -- data モジュールの有効化 (boolean)
t.modules.event = true -- event モジュールの有効化 (boolean)
t.modules.font = true -- font モジュールの有効化 (boolean)
t.modules.graphics = true -- graphics モジュールの有効化 (boolean)
t.modules.image = true -- image モジュールの有効化 (boolean)
t.modules.joystick = true -- joystick モジュールの有効化 (boolean)
t.modules.keyboard = true -- keyboard モジュールの有効化 (boolean)
t.modules.math = true -- math モジュールの有効化 (boolean)
t.modules.mouse = true -- mouse モジュールの有効化 (boolean)
t.modules.physics = true -- physics モジュールの有効化 (boolean)
t.modules.sound = true -- sound モジュールの有効化 (boolean)
t.modules.system = true -- system モジュールの有効化 (boolean)
t.modules.thread = true -- thread モジュールの有効化 (boolean)
t.modules.timer = true -- timer モジュールの有効化 (boolean)、無効にすると love.update のデルタ時間は 0 になります。
t.modules.touch = true -- touch モジュールの有効化 (boolean)
t.modules.video = true -- video モジュールの有効化 (boolean)
t.modules.window = true -- window モジュールの有効化 (boolean)
end
フラグ
identity
このフラグはゲーム用のセーブ・ディレクトリの名前を設定します。作成場所ではなく、名前のみ指定することに注意してください。
t.identity = "gabe_HL3" -- 正しい
t.identity = "c:/Users/gabe/HL3" -- 誤り
構成ファイル以外でセーブ・ディレクトリを設定するには love.filesystem.setIdentity を使用します。
appendidentity
LÖVE 11.0 から使用可能 |
このフラグは以前のバージョンでは非対応です。 |
このフラグはゲームディレクトリの後にセーブディレクトリを検索するか設定します (true
または false
)。
version
LÖVE 0.8.0 から使用可能 |
このフラグは以前のバージョンでは非対応です。 |
t.version
は文字列であり、ゲームの制作に使用された LÖVE のバージョン表記です。
LÖVE 11.0 以前では、 "X.Y.Z"
形式であり、 X
は上位リリース番号、 Y
は下位リリース番号、および Z
は修正レベルです。 11.0 以降では、 "X.Y.Z"
形式であり、 X
および Y
は上位と下位のリリース番号です。
このフラグを構成ファイルに設定した場合はゲーム実行開始時に、現在のバージョンの LÖVE とゲームとの互換性がないならば LÖVE は警告を表示します。デフォルトでは実行中の LÖVE のバージョンです。
console
ゲームのウィンドウの横にコンソールを開くかどうかを設定します (Windows 専用)。注意: OSX では、ターミナルから LÖVE を実行することによりコンソール出力を取得できます。また、 LÖVE 0.10.2 の Windows 版では、 love.exe
ではなく lovec.exe
で実行中の場合もコンソール出力を取得できます。
accelerometerjoystick
LÖVE 0.10.0 から使用可能 |
このフラグは以前のバージョンでは非対応です。 |
iOS と Andorid で加速度センサーデバイスを三軸のジョイスティックとして割り当てるかどうかを設定します。この機能を使用しない場合は加速度センサーを停止することにより CPU の使用量を減らせるかもしれません。
externalstorage
LÖVE 0.10.1 から使用可能 |
このフラグは以前のバージョンでは非対応です。 |
Android でファイルを外部ストレージ (true)、または内部ストレージ (false) に保存するかどうかを設定します。
gammacorrect
LÖVE 0.10.0 から使用可能 |
このフラグは以前のバージョンでは非対応です。 |
システムで対応している場合に、ガンマ補正レンダリングを有効にするかどうかを設定します。
audio.mic
LÖVE 11.3 から使用可能 |
このフラグは以前のバージョンでは非対応です。 |
ユーザからマイクのアクセス許可を要求します。許可時は love.audio.getRecordingDevices で利用できる録音デバイスのリストを取得できます。却下時は love.audio.getRecordingDevices を呼び出すと空テーブルを返し、ユーザにメッセージを通知します。
audio.mixwithsystem
LÖVE 11.0 から使用可能 |
このフラグは以前のバージョンでは非対応です。 |
LÖVE の起動中に、他のアプリのバックグラウンド音声や音楽を再生するか設定します。詳細情報は love.system.hasBackgroundMusic をご確認ください。
window
LÖVE 0.9.0 から使用可能 |
これらのフラグsは以前のバージョンでは非対応です。 |
love.window.setMode をコードから最初に呼ぶまでウィンドウの作成を延期することが可能になります。こうするには、 t.window = nil
(または旧版では t.screen = nil
) にて設定してください。これが処理された場合は、最初の love.window.setMode の前に love.graphics に属する関数をコードから呼び出すと LÖVE はクラッシュします。
t.window
テーブルは LÖVE 0.9.0 以前のバージョンでは t.screen
の名称でした。 t.screen
テーブルは LÖVE 0.9.0 の love.conf では存在せず、 t.window
テーブルは LÖVE 0.8.0 の love.conf では存在しません。 この意味は使用されている LÖVE のバージョンに関する正確なテーブルを使用することに注意しない場合には、 love.conf の実行は失敗します (従って保護機能によりデフォルト値に復帰されます)。
window.title
LÖVE 0.9.0 から使用可能 |
このフラグは以前のバージョンでは非対応です。 |
ゲームのウィンドウのタイトルを設定します。構成ファイル以外でウィンドウのタイトルを変更するには love.window.setTitle を使用します。
window.icon
LÖVE 0.9.0 から使用可能 |
このフラグは以前のバージョンでは非対応です。 |
ウィンドウのアイコンとして使用する画像のファイルパスです。全てのオペレーティングシステムが非常に大きいアイコンの画像に対応しているわけではありません。 love.window.setIcon でアイコンを変更できます。
window.width & window.height
LÖVE 0.9.0 から使用可能 |
これらのフラグは以前のバージョンでは非対応です。 |
ウィンドウの寸法を設定します。これらのフラグへ 0 を設定する場合、LÖVE は自動的に利用者のデスクトップの寸法を使用します。
window.borderless
LÖVE 0.9.0 から使用可能 |
このフラグは以前のバージョンでは非対応です。 |
ウィンドウからボーダー・ビジュアルを除去します。オペレーティング・システム間での効果に警戒することに注意してください。
window.resizable
LÖVE 0.9.0 から使用可能 |
このフラグは以前のバージョンでは非対応です。 |
true に設定された場合は利用者によりゲーム・ウィンドウの大きさを変更することを許可します。
window.minwidth & window.minheight
LÖVE 0.9.0 から使用可能 |
これらのフラグsは以前のバージョンでは非対応です。 |
利用者がウィンドウの大きさを変更できる場合にゲームのウィンドウの最小幅および高さを設定します。 window.width
および window.height
へ低い値を設定する場合、 LÖVE は window.minwidth
および window.minheight
を用いて常に最小寸法を指定します。
window.fullscreen
LÖVE 0.9.0 から使用可能 |
このフラグは以前のバージョンでは非対応です。 |
ゲームを全画面表示 (true
) またはウィンドウ (false
) 表示方式で実行するかどうかを指定します。全画面表示に関しては love.window.setFullscreen または love.window.setMode を用いて全画面表示・ウィンドウ表示の相互間切り替えを行うことができます。
window.fullscreentype
LÖVE 0.9.0 から使用可能 |
このフラグは以前のバージョンでは非対応です。 |
全画面表示方式から指定します (exclusive
または desktop
)。
一般的に desktop
を推奨しますが、特定のオペレーティング・システムでは exclusive
方式のほうが制限は少ないです (注釈: 0.9.2 以前では exclusive
ではなく normal
を使用します)。
window.usedpiscale
LÖVE 11.3 から使用可能 |
このフラグは以前のバージョンでは非対応です。 |
DPI の自動スケーリングの有効、または無効化を設定します。
window.vsync
LÖVE 0.9.0 から使用可能 |
このフラグは以前のバージョンでは非対応です。 |
垂直同期 (VSYNC) の有効または無効化します。 VSYNC は安定したフレームレートでゲームを持続させることで画面のティアリング (ちらつき、歪み) に関する問題を予防できます。これを無効にする意味に関して、なるべく多くの知識がなければ VSYNC を有効にしたままにおくことが推奨されます。 LÖVE 11.0 以前では、この値はブール値です (true
または false
)。 LÖVE 11.0 以降では、この値は数値です (1 は垂直同期の有効化、 0 は垂直同期の無効化、 -1 は対応時に適応型垂直同期を使用します)。
iOS での注意点として、垂直同期は常時有効であり変更不能です。
window.depth
LÖVE 11.0 から使用可能 |
このフラグは以前のバージョンでは非対応です。 |
深度バッファにおけるビット当たりのサンプル数です (16/24/32 より指定。デフォルトは nil
)
window.stencil
LÖVE 11.0 から使用可能 |
このフラグは以前のバージョンでは非対応です。 |
ステンシルバッファにおけるビット当たりのサンプル数です (通常は 8 を指定。デフォルトは nil
)
window.msaa
LÖVE 0.9.2 から使用可能 |
このフラグは以前のバージョンでは非対応です。 |
多重サンプリングされたアンチエイアシングで使用するサンプル数。
window.display
LÖVE 0.9.0 から使用可能 |
このフラグは以前のバージョンでは非対応です。 |
マルチモニターを利用できるならば、ウィンドウを表示するディスプレイの番号を指定します。
window.highdpi
LÖVE 0.9.1 から使用可能 |
このフラグは以前のバージョンでは非対応です。 |
love.window.getPixelScale, love.window.toPixels, および love.window.fromPixels を参照してください。正確な表示を確実にするためにコードの微調整が必要であるため、Retina ディスプレイが搭載されている Mac または iOS システムでゲームの動作確認ができない場合は、このオプションは無効にしたままにしておくことを推奨します。
LÖVE 11.0 以降より、このフラグに関係なく Android で High DPI は常時有効であることに注意してください。
window.x & window.y
LÖVE 0.9.2 から使用可能 |
これらのフラグは以前のバージョンでは非対応です。 |
利用者の画面上にあるウィンドウの位置を設定します。代わりに love.window.setPosition を位置の即時変更にて使用することができます。
window.fsaa
LÖVE 0.9.0 まで使用可能でしたが LÖVE 0.10.0 で廃止されました |
このフラグは window.msaa フラグへ変更されました。 |
多重サンプリングされたアンチエイアシングで使用するサンプル数。
window.srgb
LÖVE 0.9.1 まで使用可能でしたが LÖVE 0.10.0 で廃止されました |
このフラグは gammacorrect フラグへ変更されました。 |
このウィンドウのフラグを有効にすると、主画面へ描画された全ての物に対して線形 RGB 色空間から sRGB 色空間へ自動的に色を変換します - ウィンドウの表面はガンマ空間の sRGB として処理されます。これはガンマ補正表示の要素のみであり、混乱しやすい高度な話題であるため、意味が理解できない場合は、このオプションは無効化しておくことを推奨します。
リリース・モード
LÖVE 0.8.0 まで使用可能でしたが LÖVE 0.9.0 で廃止されました |
このフラグは以降のバージョンでは非対応です。 |
t.release
を有効にしたとき、 LÖVE はリリース・エラー・ハンドラを使用します。これにより、デフォルトの情報は少しだけ出力されるようになります。もちろん、オーバーライドできます。
デフォルトのリリース・エラー・ハンドラは開発者と連絡を取るための情報として conf.lua にて指定された title, author および url の値を使用して遊技者へ通知メッセージを出力します。
リリース・モードで結合型実行形式 (fused mode) を有効にしたゲームを実行する場合は LÖVE のセーブ・ディレクトリには保存されません。正確には Windows において、以前は %APPDATA%\\LOVE\\game
でしたが、現在は %APPDATA%\\game
となります。この概念は Windows 以外の動作環境でも適用されます。
旧バージョン
下記は LÖVE 11.0 ~ 11.2 までのオプションとデフォルト値のリストです:
function love.conf(t)
t.identity = nil -- セーブ・ディレクトリの名称 (string)
t.appendidentity = false -- このフラグはソースディレクトリの後にセーブディレクトリのファイルを検索するどうか (boolean)
t.version = "11.0" -- このゲームの作成に使用した LÖVE のバージョン (string)
t.console = false -- コンソールの表示 (boolean, Windows 専用)
t.accelerometerjoystick = true -- iOS と Andorid で加速度センサーをジョイスティックと見せかけることを有効にするか (boolean)
t.externalstorage = false -- true にすると Android で外部ストレージにファイルの保存 (およびセーブ・ディレクトリからの読み込み) を行います (boolean)
t.gammacorrect = false -- 対応システムでの動作時、ガンマ補正レンダリングを有効にするか (boolean)
t.audio.mixwithsystem = true -- LÖVE の起動中に他のアプリのバックグラウンド音楽を再生を続けるか (boolean, iOS と Android のみ)
t.window.title = "Untitled" -- ウィンドウのタイトル (string)
t.window.icon = nil -- ウィンドウのアイコンとして使用する画像のファイルパス (string)
t.window.width = 800 -- ウィンドウの幅 (number)
t.window.height = 600 -- ウィンドウの高さ (number)
t.window.borderless = false -- ウィンドウの境界線を非表示 (boolean)
t.window.resizable = false -- 利用者がウィンドウの大きさを変更できるかどうか (boolean)
t.window.minwidth = 1 -- ウィンドウの大きさが変更可能な場合におけるウィンドウの最小の幅 (number)
t.window.minheight = 1 -- ウィンドウの大きさが変更可能な場合におけるウィンドウの最小の高さ (number)
t.window.fullscreen = false -- 全画面表示の有効化 (boolean)
t.window.fullscreentype = "desktop" -- 排他的な全画面表示 ("exclusive") またはデスクトップ ("desktop") による全画面表示方式の中から選択 (string)
t.window.vsync = 1 -- 垂直同期の有効化 (boolean)
t.window.msaa = 0 -- 多重サンプリングされたアンチエイリアシングにて使用するサンプル数 (number)
t.window.depth = nil -- 深度バッファにおけるビット当たりのサンプル数です
t.window.stencil = nil -- ステンシルバッファにおけるビット当たりのサンプル数です
t.window.display = 1 -- ウィンドウの表示先となるモニタの番号 (number)
t.window.highdpi = false -- Retina ディスプレイ上のウィンドウで high-dpi モードを有効にするか (boolean)
t.window.x = nil -- 指定先のディスプレイにあるウィンドウ位置の x 座標 (number)
t.window.y = nil -- 指定先のディスプレイにあるウィンドウ位置の y 座標 (number)
t.modules.audio = true -- audio モジュールの有効化 (boolean)
t.modules.data = true -- data モジュールの有効化 (boolean)
t.modules.event = true -- event モジュールの有効化 (boolean)
t.modules.font = true -- font モジュールの有効化 (boolean)
t.modules.graphics = true -- graphics モジュールの有効化 (boolean)
t.modules.image = true -- image モジュールの有効化 (boolean)
t.modules.joystick = true -- joystick モジュールの有効化 (boolean)
t.modules.keyboard = true -- keyboard モジュールの有効化 (boolean)
t.modules.math = true -- math モジュールの有効化 (boolean)
t.modules.mouse = true -- mouse モジュールの有効化 (boolean)
t.modules.physics = true -- physics モジュールの有効化 (boolean)
t.modules.sound = true -- sound モジュールの有効化 (boolean)
t.modules.system = true -- system モジュールの有効化 (boolean)
t.modules.thread = true -- thread モジュールの有効化 (boolean)
t.modules.timer = true -- timer モジュールの有効化 (boolean)、無効にすると love.update のデルタ時間は 0 になります。
t.modules.touch = true -- touch モジュールの有効化 (boolean)
t.modules.video = true -- video モジュールの有効化 (boolean)
t.modules.window = true -- window モジュールの有効化 (boolean)
end
下記は LÖVE 0.10.1 および 0.10.2 のオプションとデフォルト値における全てのリストです:
function love.conf(t)
t.identity = nil -- セーブ・ディレクトリの名称 (string)
t.version = "0.10.2" -- このゲームの作成に使用した LÖVE のバージョン (string)
t.console = false -- コンソールの表示 (boolean, Windows 専用)
t.accelerometerjoystick = true -- iOS と Andorid で加速度センサーをジョイスティックと見せかけることを有効にするか (boolean)
t.externalstorage = false -- true にすると Android で外部ストレージにファイルの保存 (およびセーブ・ディレクトリからの読み込み) を行います (boolean)
t.gammacorrect = false -- 対応システムでの動作時、ガンマ補正レンダリングを有効にするか (boolean)
t.window.title = "Untitled" -- ウィンドウのタイトル (string)
t.window.icon = nil -- ウィンドウのアイコンとして使用する画像のファイルパス (string)
t.window.width = 800 -- ウィンドウの幅 (number)
t.window.height = 600 -- ウィンドウの高さ (number)
t.window.borderless = false -- ウィンドウの境界線を非表示 (boolean)
t.window.resizable = false -- 利用者がウィンドウの大きさを変更できるかどうか (boolean)
t.window.minwidth = 1 -- ウィンドウの大きさが変更可能な場合におけるウィンドウの最小の幅 (number)
t.window.minheight = 1 -- ウィンドウの大きさが変更可能な場合におけるウィンドウの最小の高さ (number)
t.window.fullscreen = false -- 全画面表示の有効化 (boolean)
t.window.fullscreentype = "desktop" -- 排他的な全画面表示 ("exclusive") またはデスクトップ ("desktop") による全画面表示方式の中から選択 (string)
t.window.vsync = true -- 垂直同期の有効化 (boolean)
t.window.msaa = 0 -- 多重サンプリングされたアンチエイリアシングにて使用するサンプル数 (number)
t.window.display = 1 -- ウィンドウの表示先となるモニタの番号 (number)
t.window.highdpi = false -- Retina ディスプレイ上のウィンドウで high-dpi モードを有効にするか (boolean)
t.window.x = nil -- 指定先のディスプレイにあるウィンドウ位置の x 座標 (number)
t.window.y = nil -- 指定先のディスプレイにあるウィンドウ位置の y 座標 (number)
t.modules.audio = true -- audio モジュールの有効化 (boolean)
t.modules.event = true -- event モジュールの有効化 (boolean)
t.modules.graphics = true -- graphics モジュールの有効化 (boolean)
t.modules.image = true -- image モジュールの有効化 (boolean)
t.modules.joystick = true -- joystick モジュールの有効化 (boolean)
t.modules.keyboard = true -- keyboard モジュールの有効化 (boolean)
t.modules.math = true -- math モジュールの有効化 (boolean)
t.modules.mouse = true -- mouse モジュールの有効化 (boolean)
t.modules.physics = true -- physics モジュールの有効化 (boolean)
t.modules.sound = true -- sound モジュールの有効化 (boolean)
t.modules.system = true -- system モジュールの有効化 (boolean)
t.modules.timer = true -- timer モジュールの有効化 (boolean)、無効にすると love.update のデルタ時間は 0 になります。
t.modules.touch = true -- touch モジュールの有効化 (boolean)
t.modules.video = true -- video モジュールの有効化 (boolean)
t.modules.window = true -- window モジュールの有効化 (boolean)
t.modules.thread = true -- thread モジュールの有効化 (boolean)
end
下記は LÖVE 0.10.0 のオプションとデフォルト値のリストです:
function love.conf(t)
t.identity = nil -- セーブ・ディレクトリの名称 (string)
t.version = "0.10.0" -- このゲームの作成に使用した LÖVE のバージョン (string)
t.console = false -- コンソールの表示 (boolean, Windows 専用)
t.accelerometerjoystick = true -- iOS と Andorid で加速度センサーをジョイスティックと見せかけることを有効にするか (boolean)
t.gammacorrect = false -- 対応システムでの動作時、ガンマ補正レンダリングを有効にするか (boolean)
t.window.title = "Untitled" -- ウィンドウのタイトル (string)
t.window.icon = nil -- ウィンドウのアイコンとして使用する画像のファイルパス (string)
t.window.width = 800 -- ウィンドウの幅 (number)
t.window.height = 600 -- ウィンドウの高さ (number)
t.window.borderless = false -- ウィンドウの境界線を非表示 (boolean)
t.window.resizable = false -- 利用者がウィンドウの大きさを変更できるかどうか (boolean)
t.window.minwidth = 1 -- ウィンドウの大きさが変更可能な場合におけるウィンドウの最小の幅 (number)
t.window.minheight = 1 -- ウィンドウの大きさが変更可能な場合におけるウィンドウの最小の高さ (number)
t.window.fullscreen = false -- 全画面表示の有効化 (boolean)
t.window.fullscreentype = "desktop" -- 排他的な全画面表示 ("exclusive") またはデスクトップ ("desktop") による全画面表示方式の中から選択 (string)
t.window.vsync = true -- 垂直同期の有効化 (boolean)
t.window.msaa = 0 -- 多重サンプリングされたアンチエイリアシングにて使用するサンプル数 (number)
t.window.display = 1 -- ウィンドウの表示先となるモニタの番号 (number)
t.window.highdpi = false -- Retina ディスプレイ上のウィンドウで high-dpi モードを有効にするか (boolean)
t.window.x = nil -- 指定先のディスプレイにあるウィンドウ位置の x 座標 (number)
t.window.y = nil -- 指定先のディスプレイにあるウィンドウ位置の y 座標 (number)
t.modules.audio = true -- audio モジュールの有効化 (boolean)
t.modules.event = true -- event モジュールの有効化 (boolean)
t.modules.graphics = true -- graphics モジュールの有効化 (boolean)
t.modules.image = true -- image モジュールの有効化 (boolean)
t.modules.joystick = true -- joystick モジュールの有効化 (boolean)
t.modules.keyboard = true -- keyboard モジュールの有効化 (boolean)
t.modules.math = true -- math モジュールの有効化 (boolean)
t.modules.mouse = true -- mouse モジュールの有効化 (boolean)
t.modules.physics = true -- physics モジュールの有効化 (boolean)
t.modules.sound = true -- sound モジュールの有効化 (boolean)
t.modules.system = true -- system モジュールの有効化 (boolean)
t.modules.timer = true -- timer モジュールの有効化 (boolean)、無効にすると love.update のデルタ時間は 0 になります。
t.modules.touch = true -- touch モジュールの有効化 (boolean)
t.modules.video = true -- video モジュールの有効化 (boolean)
t.modules.window = true -- window モジュールの有効化 (boolean)
t.modules.thread = true -- thread モジュールの有効化 (boolean)
end
下記は LÖVE 0.9.2 のオプションとデフォルト値のリストです:
function love.conf(t)
t.identity = nil -- セーブ・ディレクトリの名称 (string)
t.version = "0.9.2" -- このゲームの作成に使用した LÖVE のバージョン (string)
t.console = false -- コンソールの表示 (boolean, Windows 専用)
t.window.title = "Untitled" -- ウィンドウのタイトル (string)
t.window.icon = nil -- ウィンドウのアイコンとして使用する画像のファイルパス (string)
t.window.width = 800 -- ウィンドウの幅 (number)
t.window.height = 600 -- ウィンドウの高さ (number)
t.window.borderless = false -- ウィンドウの境界線を非表示 (boolean)
t.window.resizable = false -- 利用者がウィンドウの大きさを変更できるかどうか (boolean)
t.window.minwidth = 1 -- ウィンドウの大きさが変更可能な場合におけるウィンドウの最小の幅 (number)
t.window.minheight = 1 -- ウィンドウの大きさが変更可能な場合におけるウィンドウの最小の高さ (number)
t.window.fullscreen = false -- 全画面表示の有効化 (boolean)
t.window.fullscreentype = "normal" -- デフォルト的な全画面表示 ("normal") またはデスクトップ ("desktop") による全画面表示方式の中から選択 (string)
t.window.vsync = true -- 垂直同期の有効化 (boolean)
t.window.fsaa = 0 -- 多重サンプリングされたアンチエイリアシングにて使用するサンプル数 (number)
t.window.display = 1 -- ウィンドウの表示先となるモニタの番号 (number)
t.window.highdpi = false -- Retina ディスプレイ上のウィンドウで high-dpi モードを有効にするか (boolean)
t.window.srgb = false -- 画面描画時の sRGB ガンマ補正の有効化 (boolean)
t.window.x = nil -- 指定先のディスプレイにあるウィンドウ位置の x 座標 (number)
t.window.y = nil -- 指定先のディスプレイにあるウィンドウ位置の y 座標 (number)
t.modules.audio = true -- audio モジュールの有効化 (boolean)
t.modules.event = true -- event モジュールの有効化 (boolean)
t.modules.graphics = true -- graphics モジュールの有効化 (boolean)
t.modules.image = true -- image モジュールの有効化 (boolean)
t.modules.joystick = true -- joystick モジュールの有効化 (boolean)
t.modules.keyboard = true -- keyboard モジュールの有効化 (boolean)
t.modules.math = true -- math モジュールの有効化 (boolean)
t.modules.mouse = true -- mouse モジュールの有効化 (boolean)
t.modules.physics = true -- physics モジュールの有効化 (boolean)
t.modules.sound = true -- sound モジュールの有効化 (boolean)
t.modules.system = true -- system モジュールの有効化 (boolean)
t.modules.timer = true -- timer モジュールの有効化 (boolean)、無効にすると love.update のデルタ時間は 0 になります。
t.modules.window = true -- window モジュールの有効化 (boolean)
t.modules.thread = true -- thread モジュールの有効化 (boolean)
end
下記は LÖVE 0.9.1 のオプションとデフォルト値のリストです:
function love.conf(t)
t.identity = nil -- セーブ・ディレクトリの名称 (string)
t.version = "0.9.1" -- このゲームの作成に使用した LÖVE のバージョン (string)
t.console = false -- コンソールの表示 (boolean, Windows 専用)
t.window.title = "Untitled" -- ウィンドウのタイトル (string)
t.window.icon = nil -- ウィンドウのアイコンとして使用する画像のファイルパス (string)
t.window.width = 800 -- ウィンドウの幅 (number)
t.window.height = 600 -- ウィンドウの高さ (number)
t.window.borderless = false -- ウィンドウの境界線を非表示 (boolean)
t.window.resizable = false -- 利用者がウィンドウの大きさを変更できるかどうか (boolean)
t.window.minwidth = 1 -- ウィンドウの大きさが変更可能な場合におけるウィンドウの最小の幅 (number)
t.window.minheight = 1 -- ウィンドウの大きさが変更可能な場合におけるウィンドウの最小の高さ (number)
t.window.fullscreen = false -- 全画面表示の有効化 (boolean)
t.window.fullscreentype = "normal" -- 準的な全画面表示またはデスクトップによる全画面表示方式 (string)
t.window.vsync = true -- 垂直同期の有効化 (boolean)
t.window.fsaa = 0 -- 多重サンプリングされたアンチエイリアシングにて使用するサンプル数 (number)
t.window.display = 1 -- ウィンドウの表示先となるモニタの番号 (number)
t.window.highdpi = false -- Retina ディスプレイ上のウィンドウで high-dpi モードを有効にするか (boolean)
t.window.srgb = false -- 画面描画時の sRGB ガンマ補正の有効化 (boolean)
t.modules.audio = true -- audio モジュールの有効化 (boolean)
t.modules.event = true -- event モジュールの有効化 (boolean)
t.modules.graphics = true -- graphics モジュールの有効化 (boolean)
t.modules.image = true -- image モジュールの有効化 (boolean)
t.modules.joystick = true -- joystick モジュールの有効化 (boolean)
t.modules.keyboard = true -- keyboard モジュールの有効化 (boolean)
t.modules.math = true -- math モジュールの有効化 (boolean)
t.modules.mouse = true -- mouse モジュールの有効化 (boolean)
t.modules.physics = true -- physics モジュールの有効化 (boolean)
t.modules.sound = true -- sound モジュールの有効化 (boolean)
t.modules.system = true -- system モジュールの有効化 (boolean)
t.modules.timer = true -- timer モジュールの有効化 (boolean)
t.modules.window = true -- window モジュールの有効化 (boolean)
t.modules.thread = true -- thread モジュールの有効化 (boolean)
end
下記は LÖVE 0.9.0 のオプションとデフォルト値のリストです:
function love.conf(t)
t.identity = nil -- セーブ・ディレクトリの名称 (string)
t.version = "0.9.0" -- このゲームの作成に使用した LÖVE のバージョン (string)
t.console = false -- コンソールの表示 (boolean, Windows 専用)
t.window.title = "Untitled" -- ウィンドウのタイトル (string)
t.window.icon = nil -- ウィンドウのアイコンとして使用する画像のファイルパス (string)
t.window.width = 800 -- ウィンドウの幅 (number)
t.window.height = 600 -- ウィンドウの高さ (number)
t.window.borderless = false -- ウィンドウの境界線を非表示 (boolean)
t.window.resizable = false -- 利用者がウィンドウの大きさを変更できるかどうか (boolean)
t.window.minwidth = 1 -- ウィンドウの大きさが変更可能な場合におけるウィンドウの最小の幅 (number)
t.window.minheight = 1 -- ウィンドウの大きさが変更可能な場合におけるウィンドウの最小の高さ (number)
t.window.fullscreen = false -- 全画面表示の有効化 (boolean)
t.window.fullscreentype = "normal" -- 準的な全画面表示またはデスクトップによる全画面表示方式 (string)
t.window.vsync = true -- 垂直同期の有効化 (boolean)
t.window.fsaa = 0 -- 多重サンプリングされたアンチエイリアシングにて使用するサンプル数 (number)
t.window.display = 1 -- ウィンドウの表示先となるモニタの番号 (number)
t.modules.audio = true -- audio モジュールの有効化 (boolean)
t.modules.event = true -- event モジュールの有効化 (boolean)
t.modules.graphics = true -- graphics モジュールの有効化 (boolean)
t.modules.image = true -- image モジュールの有効化 (boolean)
t.modules.joystick = true -- joystick モジュールの有効化 (boolean)
t.modules.keyboard = true -- keyboard モジュールの有効化 (boolean)
t.modules.math = true -- math モジュールの有効化 (boolean)
t.modules.mouse = true -- mouse モジュールの有効化 (boolean)
t.modules.physics = true -- physics モジュールの有効化 (boolean)
t.modules.sound = true -- sound モジュールの有効化 (boolean)
t.modules.system = true -- system モジュールの有効化 (boolean)
t.modules.timer = true -- timer モジュールの有効化 (boolean)
t.modules.window = true -- window モジュールの有効化 (boolean)
t.modules.thread = true -- thread モジュールの有効化 (boolean)
end
下記は LÖVE 0.8.0 のオプションとデフォルト値のリストです:
function love.conf(t)
t.title = "Untitled" -- ゲームのウィンドウ・タイトル (string)
t.author = "Unnamed" -- ゲーム開発者の名称 (string)
t.url = nil -- ゲームのウェブサイトの URL アドレス (string)
t.identity = nil -- セーブ・ディレクトリの名称 (string)
t.version = "0.8.0" -- このゲームの作成に使用した LÖVE のバージョン (string)
t.console = false -- コンソールの表示 (boolean, Windows 専用)
t.release = false -- リリース・モードの有効化 (boolean)
t.screen.width = 800 -- ウィンドウの幅 (number)
t.screen.height = 600 -- ウィンドウの高さ (number)
t.screen.fullscreen = false -- 全画面表示の有効化 (boolean)
t.screen.vsync = true -- 垂直同期の有効化 (boolean)
t.screen.fsaa = 0 -- MSAA のサンプル数 (number)
t.modules.joystick = true -- joystick モジュールの有効化 (boolean)
t.modules.audio = true -- audio モジュールの有効化 (boolean)
t.modules.keyboard = true -- keyboard モジュールの有効化 (boolean)
t.modules.event = true -- event モジュールの有効化 (boolean)
t.modules.image = true -- image モジュールの有効化 (boolean)
t.modules.graphics = true -- graphics モジュールの有効化 (boolean)
t.modules.timer = true -- timer モジュールの有効化 (boolean)
t.modules.mouse = true -- mouse モジュールの有効化 (boolean)
t.modules.sound = true -- sound モジュールの有効化 (boolean)
t.modules.physics = true -- physics モジュールの有効化 (boolean)
t.modules.thread = true -- thread モジュールの有効化 (boolean)
end
下記は LÖVE 0.7.2 以前のオプションとデフォルト値のリストです:
function love.conf(t)
t.title = "Untitled" -- ゲームのウィンドウ・タイトル (string)
t.author = "Unnamed" -- ゲーム開発者の名称 (string)
t.identity = nil -- セーブ・ディレクトリの名称 (string)
t.version = 0 -- このゲームの作成に使用した LÖVE のバージョン (number)
t.console = false -- コンソールの表示 (boolean, Windows 専用)
t.screen.width = 800 -- ウィンドウの幅 (number)
t.screen.height = 600 -- ウィンドウの高さ (number)
t.screen.fullscreen = false -- 全画面表示の有効化 (boolean)
t.screen.vsync = true -- 垂直同期の有効化 (boolean)
t.screen.fsaa = 0 -- MSAA のサンプル数 (number)
t.modules.joystick = true -- joystick モジュールの有効化 (boolean)
t.modules.audio = true -- audio モジュールの有効化 (boolean)
t.modules.keyboard = true -- keyboard モジュールの有効化 (boolean)
t.modules.event = true -- event モジュールの有効化 (boolean)
t.modules.image = true -- image モジュールの有効化 (boolean)
t.modules.graphics = true -- graphics モジュールの有効化 (boolean)
t.modules.timer = true -- timer モジュールの有効化 (boolean)
t.modules.mouse = true -- mouse モジュールの有効化 (boolean)
t.modules.sound = true -- sound モジュールの有効化 (boolean)
t.modules.physics = true -- physics モジュールの有効化 (boolean)
end
関連