これらの Python 関数を使用すると、ゲームディレクトリーにあるファイルリソース、RPA アーカイブ、Android のリソースにアクセスできます。
renpy.
file
(fn, encoding=None) linkrenpy.open_file()
のエイリアスで、古いバージョンの Ren'Py との互換性のためのものです。
renpy.
list_files
(common=False) linkゲームディレクトリーとアーカイブ内のファイルをリストアップします。ディレクトリーの区切りとして / を使用し、ファイルのリストを返します。
True なら、 common ディレクトリーのファイルもリストに含まれます。
renpy.
loadable
(filename) link指定されたファイル名がロード可能、つまりそれがディスクかアーカイブ内からロード可能なら True を返します。それ以外の場合 False を返します。
renpy.
open_file
(fn, encoding=None) linkfn ファイルにアクセスする、読み込み専用のファイル風オブジェクトを返します。ファイルに Ren'Py の標準検索メソッドによってアクセスし、RPA アーカイブの中身や Android のリソースにもアクセスできます。
オブジェクトはバイナリモードで開かれた時の python 標準のファイルオブジェクトにあるフィールドやメソッドの広範なサブセットをサポートします ( 基本的には読み込み専用ファイルで有効なメソッドの全てです )。
指定されると、ファイルは指定のエンコードのテキストモードでファイルが開かれます。デフォルトでは None であり、 config.open_file_encoding
のエンコーディングが使用されます。 False ならファイルはバイナリモードで開かれます。
これらの関数は稀に使用されます。
renpy.
exists
(filename) linkサーチパスに指定されたファイル名が見付かれば True を返します。これはディスク上に物理ファイルが存在するときだけ動作し、アーカイブ内にある場合は発見出来ません。
ほとんどの場合この関数より renpy.loadable()
を使用した方がよいでしょう。
renpy.
fsdecode
(s) linkファイルシステムのエンコードから Unicode に変換します。
renpy.
fsencode
(s, force=False) linkUnicode からファイルシステムのエンコードに変換します。
renpy.
image_size
(im) linkイメージマニュピレーターを受け取り、ロードして、そのサイズのタプル (width
, height
) を返します。
これは画像のキャッシュを利用せずに、画像をディスクから読み込んで展開するため、動作が遅くなりがちです。