LibMikuMikuPenguin(libmmp) v0.1 リードミ（日本語）

English translation is available.

どうも初めまして。sn0w75です。

自分の好きなOSでミクミクしたくて、それを出来る為のライブラリやプログラムを作ってみました。まだバグだらけですし、APIが確定しているわけでもないのでMMPをライブラリとして使うのはまだまだ早いかと思います。ですが、これを起点として、Windows以外のOSでのMMDの開発が段々進めていったら～と思ってます。

最新のコードは以下のリンクで手に入れます： https://github.com/sn0w75/MikuMikuPenguin/

ディレクトリ構成

中身はこんな感じです：

COPYING: このコードのライセンス
doc: ドキュメンテーションを入れる為のフォルダですが、現時点では得に何も入ってません。
include: LibMikuMikuPenguinのヘッダ（.h）ファイルがここに入ってます。
INSTALL: このコードのインストール仕方（英語のみ）
libmmp: LibMikuMikuPenguinのソース（.cpp）ファイルがここに入ってます。
shaders: PMXViewerのシェーダーがここに入ってます。
src: PMXViewerのソースコード（.cpp、.h）がここに入ってます。
data: 必要なテクスチャ等が入ってます。

依存ライブラリ

LibMikuMikuPenguinにはlibglfw, libglew,libglm,libBulletが必要です。

PMXViewerにはlibmmp、libSOILが必要です。VMDと一緒に音楽を再生したい場合は、SDL2、SDL2_mixerも必要です。（なくてもコンパイル出来ます）

ライブラリの詳細（2014年1月20日）：

libglfw: 現在では2.7が必要です。3.0+は2.xと非対応です。
libglm: 現在では0.9.4(0.9.2、 0.9.3でも大丈夫かもしれません）が必要です。0.9.5+は0.9.4と非対応です。

注意！！！！！

GLM 0.9.3（<=0.9.2もそうかもしれない）ではバグがあります： g-truc/glm#15

このバグを回避する為には、-fpermissiveを使う必要があります。例えば：

$ export CXXFLAGS="-fpermissive"
$ autoreconf -i
$ ./configure
# make install

みたいな感じです。

インストール

このソースコードはautotoolsを利用していますので、コンパイルやインストールは簡単です：

コンパイルするにはターミナルで：

$ autoreconf -i
$ ./configure
$ make

をすれば大丈夫です。またシステムにインストールしたい場合は：

$ sudo make install

みたいな感じで大丈夫です。

あなたはどのブランチを使うべきか?

今のところ、あなたのコンピュータが、どのバージョンのOpenGLを使えるかによって、コンパイルするべき git branch は異なります。

確認方法

Linux

Linux での確認方法は、コマンドラインで、

 glxinfo | grep OpenGL

を実行して、

 OpenGL vendor string: Tungsten Graphics, Inc
 OpenGL renderer string: Mesa DRI Intel(R) Ironlake Mobile x86/MMX/SSE2
 OpenGL version string: 2.1 Mesa 8.0.5
 OpenGL shading language version string: 1.20
 OpenGL extensions:

とでてきたら、version strings に注目します。

例示はあなたのコンピュータの OpenGL は Version 2.1 だと示しています。

ブランチの切り替え方法

git を使ったことがないなら、http://progit-ja.github.io/ などで学ぶのがいいでしょう。

git clone した直後には

git checkout -b legacy-210 orign/legacy-210

を実行し、ローカルにブランチを作ります。確認方法は

git branch -a

です。2回目以降は、git checkout を上記のサイトや書籍などで学んでください。遅かれ早かれ、ブランチの更新も勉強することになるでしょうから。

他に質問がありました、気軽にメッセージ飛ばしてください。喜んで手伝います：

Twitter @sn0w75
E-mail ibenrunnin@gmail.com

yocchi / MikuMikuPenguin