guParseRdpDL.htm 3.53 KB

Raw Blame History Permalink

<HTML>

<HEAD>

<TITLE>HTML 文書</TITLE>

<META NAME="GENERATOR" CONTENT="Internet Assistant for Microsoft Word 2.0j">
</HEAD>

<BODY>

<P>
<A NAME="_Toc366998666"></A><B>guParseRdpDL(3P) <BR>
</B>
<P>
<B>関数名<BR>
</B>
<P>
guParseRdpDL
<P>
→ 解読可能な形式でロウレベルディスプレイリストをプリントします。
<BR>

<P>
<B>構文　<BR>
</B>
<P>
#include &quot;gu.h&quot;
<P>
void guParseRdpDL(u64 *rdp_dl, u64 nbytes, u8 flags)<BR>

<P>
<B>パラメータ　<BR>
</B>
<P>
<B>rdp_dl</B>
<P>
DRAM内のRDPディスプレイリストポインタ。これは、タスクヘッダにパスされるアレイです。詳細については<A HREF="../os/osSpTaskLoad.htm">osSpTaskLoad</A>(3P)を参照してください。
<P>
<B>nbytes</B>
<P>
グラフィクスタスクによって返されたRDPディスプレイリスト中のバイトの数。詳細は<A HREF="../os/osSpTaskLoad.htm">osSpTaskLoad</A>(3P)を参照してください。
<P>
<B>flags</B>
<P>
以下のフラグはディスプレイリストに関する付加情報のプリントをイネーブルにするために、それぞれbitORされます。

<P>
<B>GU_PARSERDP_VERBOSE</B>
<P>
ディスプレイリストについての追加情報プリントします。通常デバッグで使用します。
<P>
<B>GU_PARSERDP_PRAREA</B>
<P>
各プリミティブのスパンのエリア／数についての情報をプリ ントします。
<BR>
<B>GU_PARSERDP_DUMPONLY</B>
<P>
RDPディスプレイリストを16進数でダンプ表示します。<BR>

<P>
<B>説明<BR>
</B>
<P>
この関数はリアリティディスプレイプロセッサ(RDP)ディスプレイリストを人が解読できる形にダンプします。また、ディスプレイリストの共通的なエラーを検出します。この関数を使用するにはIndy上で<A HREF="../tool/dlprint.htm" >dlprint</A>(1)を起動しておかなければなりません。オプションで、各プリミティブのエリア情報やプリミティブのスパン数をプリントすることもできます。コマンド類はプリミティブ、アトリビュート、同期、ロードコマンドのどれかに分類されます。また、それぞれのコマンドタイプの数は、ディスプレイリストのダンプ後にプリントされます。
<BR>

<P>
RDPディスプレイリストはRSP上で実行されているグラフィックマイクロコードの出力形式となっています。適切なマイクロコード(.dramの拡張子がついたマイクロコード)を使用し、RSPはユーザが使用するDRAMバッファにディスプレイリストを出力します。ディスプレイリストをプリントするために、いったんDRAM内で、<B>guParseRdpDL</B>(3P)を使用することができます。DRAM中のディスプレイリストは<A HREF="../os/osDpSetNextBuffer.htm">osDpSetNextBuffer</A>(3P)関数を使用してRDPに送ることができます。この手順により、アプリケーション，RSP，RDPの間の問題を切り離すことができます。<B>
guParseRdpDL</B>(3P)はDRAMマイクロコード以外では使用出来ません(.dramの拡張子がついていないマイクロコードでは使用できません)。
<P>
<B>guParseRdpDL</B>(3P)は以下の条件を検出します : <BR>

<P>
●カラー／Zイメージが最初の2M中にない
<P>
●イメージポインタが最初の2M中にない
<P>
●イメージポインタが正確にアラインされていない。
<P>
●同期ミス
<P>
●プリミティブ係数が適切でない
<P>
●シザリングされていない長方形　<BR>

<P>
<B>バグ<BR>
</B>
<P>
テクスチュアをロードするサイクル数の想定はされていません。同期チェックはいつも簡単にできるというわけではありません。トライアングルのエリア計算は時々誤った値を出すことがあります。推定クロック数は、DRAM遅延，サイクルタイプ，リード／モディファイ／ライトモードなどを考慮に入れていません。つまり、ディスプレイリストのパフォーマンスの概要を知るためにしか使用できません。
<BR>

<P>
<B>参照　<BR>
</B>
<P>
<A HREF="../tool/dlprint.htm" >dlprint</A>(1), <A HREF="guParseGbiDL.htm">guParseGbiDL</A>(3P),
<A HREF="../al/alParseAbiCL.htm">alParseAbiCL</A>(3P), <A HREF="../os/osSpTaskLoad.htm">osSpTaskLoad</A>(3P),
<A HREF="../os/osDpSetNextBuffer.htm">osDpSetNextBuffer</A>(3P)
<BR>

</BODY>

</HTML>