文件讀寫

這些Python函數允許創作者讀寫資源文件，包括在game目錄下的文件、RPA歸檔和安卓資源(asset)。

renpy.file(fn)

只是 renpy.open_file() 函數的別名，保持與其他Ren’Py版本的相容。

renpy.list_files(common=False)

列出game目錄和歸檔文件下的所有文件。這個函數返回一個文件列表，使用“/”作為目錄分隔符號。

common

若為True，通用目錄也會包含在列表中。

renpy.loadable(filename)

如果 filename 表示的文件可以載入就返回True。可以載入表示可以從磁碟上或者某個歸檔文件內讀取數據。如果不能載入則返回False。

renpy.open_file(fn, encoding=None, directory=None)

接入名為 fn 的文件並返回一個只讀的類文件對象。使用Ren’Py的標準搜索方法，我們可以進行文件讀寫。還可以在RPA歸檔文件內部進行讀寫操作，或者以安卓asset形式讀寫。

以二進位制模式打開的Python標準文件對象上的欄位(field)和方法的寬泛子集都被這個對象支持。(基本上，針對一個制度文件的所有方法都是可用的。)

encoding

若指定，則根據對應編碼方式以文本模式打開文件。 若為None，即預設值，根據配置項 config.open_file_encoding 決定編碼方式。 若為False，以二進位制形式打開文件。

directory

若不是None，則會在game目錄中沒有找到對應文件時，再次在該入參指定的目錄中搜尋對應文件。 也就是說會將目錄名加到檔案名之前，並再次嘗試搜索。

極少使用

這些函數極少使用。

renpy.exists(filename)

如果在搜尋路徑中可以找到文件 filename 就返回True。這個函數對磁碟上存在的物理文件有效。它不能搜尋歸檔文件內部。

大多數情況下，這個函數會與 renpy.loadable() 函數一起使用。

renpy.fsdecode(s)

將 s 從文件系統(filesysteme)編碼轉為unicode。

renpy.fsencode(s)

將 s 從unicode轉為文件系統(filesysteme)編碼。

renpy.image_size(im)

給定一個圖像處理器(manipulator)，載入並返回一個表示尺寸的 (width, height) 元組。

這個函數從磁碟讀取圖片並解壓，不使用圖像快取。所以這個函數可能運行得很慢。