VOGLのソースを表示

[[Category:開発]]
[[Category:グラフィックス]]
[[en:VOGL]]
{{Related articles start}}
{{Related|ステップバイステップデバッグガイド}}
{{Related|デバッグ - トレースを取得}}
{{Related articles end}}

[https://github.com/ValveSoftware/vogl VOGL] は Valve Software と RAD Game Tools により作成された､OpenGL のデバッグのためのツールです｡OpenGL のコールトレースファイルを取得・リプレイ・調査することができます｡
==インストール==
[[AUR|AUR]] より､開発バージョン {{AUR|vogl-git}} が利用可能です｡

32ビットのアプリケーションをキャプチャ・デバッグするには {{AUR|lib32-vogl-git}}{{Broken package link|パッケージが存在しません}} から libvogltrace32.so, voglreplay32, vogleditor32 が必要です。

==トレースファイルを取得する==
以下のコマンドを実行してトレースファイルを取得します:
{{bc|1=$ VOGL_CMD_LINE="--vogl_debug --vogl_dump_stats --vogl_tracefile /tmp/vogltrace.bin" LD_PRELOAD=/usr/lib/libvogltrace64.so <command>}}    
<command> の部分は OpenGL アプリケーションを実行するコマンドに置き換えてください｡/tmp 以下にトレースファイルが作成されます｡
{{Warning|ファイルは急激に巨大化します｡1-2分ほどでキャプチャされたコールは約1GBになります｡}}

VOGL はソースの中にテスト用に使える OpenGL のサンプルを含みます｡サンプルはパッケージには含まれていませんが手動でビルドすることができます｡最新の OpenGL サンプルは [http://ogl-samples.g-truc.net/ OpenGL Samples Pack] もしくは [http://www.openglsuperbible.com/ OpenGL SuperBible] から入手することができます｡

==トレースファイルをトリミングする==

より小さいトレースファイルを作成したい場合、例えばフレーム Y から開始して X フレーム分だけトレースを取得するには:

{{bc|$ voglreplay64 original_trace.bin --trim_file trimmed_trace.bin --trim_len X --trim_frame Y}}

==トレースファイルのリプレイ==
トレースをリプレイするには vogl ディレクトリ内から voglreplayer を実行します:
{{bc|$ voglreplay64 /tmp/vogltrace.bin}}

トレースの詳細なデバッグ出力を表示するには:
{{bc|$ voglreplay64 --debug --verbose vogltrace.bin}}

GL コールと拡張の統計を表示するには:
{{bc|$ voglreplay64 --info vogltrace.bin}}

==トレースファイルの調査==

vogleditor を実行し､"File - Open Trace" から tracefile.bin を開きます:
{{bc|$ vogleditor64}}

==制約==
制約については [http://richg42.blogspot.it/2014/03/current-vogl-limitations.html ブログの投稿] を読んでください｡