HN 日本語サマリー

← 一覧へ戻る
プログラミング

libsm64: 外部ゲームエンジンで使用可能なライブラリとしてのMario 64

Libsm64: Mario 64 as a library for use in external game engines (github.com)

186 pointsby klaussilveira21 コメント

要約

libsm64は、Super Mario 64の移動およびレンダリングコードを、外部ゲームエンジンに容易に統合できるライブラリ形式で提供するプロジェクトです。SM64の逆コンパイルプロジェクトから派生したコードを使用し、実行時に公式ROMからテクスチャとアニメーションデータを抽出します。このライブラリは、Windows、macOS、Linux、およびWeb(Emscripten)でのビルドをサポートしています。

全文翻訳

libsm64 - Super Mario 64をライブラリとして

このプロジェクトの目的は、SM64逆コンパイルプロジェクトによってSM64からリバースエンジニアリングされた移動およびレンダリングコードにクリーンなインターフェースを提供し、マリオを既存のゲームエンジンや他のシステムに最小限の労力で組み込めるようにすることです。このプロジェクトは、逆コンパイルプロジェクトからのコードを主に含む共有ライブラリファイルを生成し、アセット(テクスチャやアニメーションデータ)を取得するために公式のSM64 ROMをランタイム時にロードします。そのため、このライブラリを利用するいかなるプロジェクトも、ユーザーにROMの提供を求める必要があります。

共有ライブラリの外部公開API全体は libsm64.h にあります。ライブラリを利用するクライアントプロジェクトは、そのヘッダーのみを含め、ライブラリをロードする必要があります。ライブラリの使用方法を示す最小限のサンプルプロジェクトが test ディレクトリの下にあります。

バインディングとプラグイン

MacおよびLinuxでのビルド

  • python3がインストールされていることを確認してください。
  • テストプログラムをビルドする場合、SDL2およびGLEWライブラリがインストールされていることを確認してください(Ubuntuの場合: libsdl2-dev, libglew-dev)。
  • ビルドするには make を実行します。glibcの代わりにmusl libcをリンクしたい場合は、代わりに LIBSM64_MUSL=1 make を実行してください。
  • テストプログラムを実行するには、リポジトリのルートに baserom.us.z64 という名前のSM64 US ROMが必要です。

Windowsでのビルド

  • ここにあるMSYS2 MinGW 64の設定手順1〜4に従ってくださいが、リポジトリURLを https://github.com/libsm64/libsm64.git に置き換えてください。
  • テストプログラムをビルドする場合、SDL2およびGLEWライブラリがインストールされていることを確認してください。
    • 64ビット: pacman -S mingw-w64-x86_64-SDL2 mingw-w64-x86_64-glew。
    • 32ビット: pacman -S mingw-w64-i686-SDL2 mingw-w64-i686-glew。
  • ビルドするには make を実行します。
  • テストプログラムを実行するには、リポジトリのルートに baserom.us.z64 という名前のSM64 US ROMが必要です。

Emscripten(Web)向けビルド(開発中)

emmake make CC=emcc を実行します。

libsm64スタンドアロンをJSから呼び出したい場合(あまり有用ではないかもしれません?)、その後 emcc dist/libsm64.so -o libsm64.js を実行して libsm64.wasm と libsm64.js を生成してください。

それ以外の場合、dist/libsm64.so は、独自のCプロジェクトにリンクできるコンパイル済みのWebAssemblyオブジェクトになるはずです。

Makeターゲット(全プラットフォーム)

  • make lib: (デフォルト)共有オブジェクトまたはDLLと公開ヘッダーを含む dist ディレクトリをビルドします。
  • make test: ライブラリ dist ディレクトリとテストプログラムをビルドします。
  • make run: SDL+OpenGLテストプログラムをビルドして実行します。