python3d引擎

A. Ren'Py引擎從入門到放棄(支線10)——3D渲染1

在探索 Ren'Py 引擎中實現 3D 渲染的途中，我遇到了一系列挑戰，其中最令我頭疼的問題是如何配置所需的環境。在 bitsawer 在 GitHub 上發布的 renpy-shader 項目中，我發現項目已經四五年沒有更新了，最後一次更新僅僅是修改了 README 文件，提及某款包含不適宜內容的游戲採用了該項目的某些技術。盡管如此，項目中的大部分代碼仍然可以在最近的 7.5 版本上運行。

在嘗試配置時，我首先下載了項目文件，並按照 README 中的 Installation 指南將各種文件放置在對應位置。實際上，只需要將 pythonlib2.7 目錄中的 ctypes 中的 util.py 文件復制到 SDK 同名目錄下，以及確保 PyOpenGL 的版本（盡管 README 中建議使用 3.1.1a1，實際上更高的版本也是可以的，因為最終都會報錯）在具體項目或 SDK 中均可。

在配置完成後，嘗試運行 ShaderDemo 項目時，我遇到了一個令人困惑的提示：項目不支持。為了繞過這個問題，我直接在任意的 rpy 文件中加入一句代碼，強制使用 gl 渲染器，成功運行了 ShaderDemo。但這里有一個友情提示：在 gl2 渲染器下嘗試進行 3D 渲染時，你可能會直接遇到一個 1282 錯誤，這是無效操作的提示。此外，shader 模塊在渲染過程中的某些標識項與 gl2 存在沖突，可能會引發各種令人頭疼的錯誤。

接下來，我面對的是如何導入模型文件和紋理的問題。為了解決這個問題，我提供了一段示例代碼，定義了一個名為 cube3d 的界面，其中添加了一個自定義可視組件 ShaderDisplayable，並將它放置在界面中心。在配置正確的情況下，運行這段代碼可以觀察到一個畫面中心旋轉的立方體。這個立方體沒有紋理貼圖，其各個面上的顏色是著色器「shader.PS_3D_NORMALS」根據表面法線換算出來的。

若要使用帶紋理坐標的模型並同時設置了紋理貼圖，則在載入模型時需要添加紋理。比如，熟悉的奶牛模型就是通過這種方式呈現的。值得注意的是，ShaderDisplayable 對象初始化時的第二個參數是一個 image，通常會在 image 目錄下放置一張圖片，渲染結果會與圖片尺寸大小相匹配。

最後，我遇到了在載入模型過程中報錯的問題。幸運的是，我發現原項目中存在一個 bug，需要對 shader 目錄下的 mesh.py 文件進行修改以解決問題。後續的開發計劃中，我可能會繼續修復幾個 bug，並深入講解技術原理。