1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml"> 3 <head> 4 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 5 <meta http-equiv="Content-Style-Type" content="text/css" /> 6 <link rel="stylesheet" href="../css/manpage.css" type="text/css" /> 7<title>nngxGetCmdlistParameteri</title> 8 </head> 9 <body> 10<h1><CODE>nngxGetCmdlistParameteri</CODE> Function</h1> 11<h2>Syntax</h2> 12 <div class="section"> 13 <pre class="definition"> 14NNGX_APICALL void NNGX_APIENTRY nngxGetCmdlistParameteri( 15 GLenum pname, 16 GLint * param 17); 18</pre> 19 </div> 20<h2>Arguments</h2> 21 <div class="section"> 22 <table class="arguments"> 23 <thead> 24 <tr> 25 <td width="15" /> 26<th>Name</th> 27<td>Description</td> 28 </tr> 29 </thead> 30 <tr> 31<td>in</td> 32<th>pname</th> 33<td>Parameter name.</td> 34 </tr> 35 <tr> 36<td>out</td> 37<th>param</th> 38<td>Region where the parameter values are stored.</td> 39 </tr> </table> 40 </div> 41<h2>Return Values</h2> 42<div class="section">There is no return value. </div> 43<h2>Description</h2> 44 <div class="section"> 45<p>Gets a parameter value (<SPAN class="argument">param</SPAN>) configured for the current command list.</p><P> 46Set <SPAN class="argument">pname</SPAN> to one of the following values. 47<TABLE><TR><TH>NN_GX_CMDLIST_RUN_MODE</TH><TD>Gets the command list's execution mode.</TD></TR><TR><TH>NN_GX_CMDLIST_IS_RUNNING</TH><TD>Gets the execution status of the command list. If <CODE>GL_TRUE</CODE> is obtained, the command list is running. If <CODE>GL_FALSE</CODE> is obtained, the command list is not running.</TD></TR><TR><TH>NN_GX_CMDLIST_USED_BUFSIZE</TH><TD>Gets the size (in bytes) of the commands accumulated in the 3D command buffer.</TD></TR><TR><TH>NN_GX_CMDLIST_USED_REQCOUNT</TH><TD>Gets the number of command requests that are currently accumulated.</TD></TR><TR><TH>NN_GX_CMDLIST_MAX_BUFSIZE</TH><TD>Gets the maximum number of bytes that can be accumulated in the 3D command buffer.</TD></TR><TR><TH>NN_GX_CMDLIST_MAX_REQCOUNT</TH><TD>Gets the maximum number of command requests that can be accumulated.</TD></TR><TR><TH>NN_GX_CMDLIST_TOP_BUFADDR</TH><TD>Gets the starting address of the 3D command buffer.</TD></TR><TR><TH>NN_GX_CMDLIST_BINDING</TH><TD>Gets the ID of the command list object bound to the current object.</TD></TR><TR><TH>NN_GX_CMDLIST_CURRENT_BUFADDR</TH><TD>Gets the current export target address in the 3D command buffer.</TD></TR><TR><TH>NN_GX_CMDLIST_RUN_BUFSIZE</TH><TD>Gets the size in bytes of the 3D command buffer that has been executed.</TD></TR><TR><TH>NN_GX_CMDLIST_RUN_REQCOUNT</TH><TD>Gets the number of command requests that have been executed.</TD></TR><TR><TH>NN_GX_CMDLIST_TOP_REQADDR</TH><TD>Gets the starting address of the data memory region for the command request's request queue.</TD></TR><TR><TH>NN_GX_CMDLIST_NEXT_REQTYPE</TH><TD>When command execution is stopped, gets the type of command for the next command request to be executed. When a command is being executed, gets the type of command for the command request currently being executed. If all command requests have been executed, gets nothing. Command types are indicated by the following macros. 48<UL><LI>NN_GX_CMDLIST_REQTYPE_DMA: DMA transfer command</LI><LI>NN_GX_CMDLIST_REQTYPE_RUN3D: 3D execution command</LI><LI>NN_GX_CMDLIST_REQTYPE_FILLMEM: Memory fill command</LI><LI>NN_GX_CMDLIST_REQTYPE_POSTTRANS: Post-transfer command</LI><LI>NN_GX_CMDLIST_REQTYPE_COPYTEX: Render texture transfer command</LI></UL></TD></TR><TR><TH>NN_GX_CMDLIST_NEXT_REQINFO</TH><TD>When command execution is stopped, gets parameter information for the next command request to be executed. When a command is being executed, gets parameter information for the command request currently being executed. If all command requests have been executed, gets nothing. Only works when the command request to be executed or currently executed is for a 3D command. Gets nothing for any other command type. The first element of the <SPAN class="argument">param</SPAN> argument gets the command buffer address, and the second element gets the command buffer size in bytes.</TD></TR><TR><TH>NN_GX_CMDLIST_HW_STATE</TH><TD>Gets 32 bits of data indicating the hardware state. The meaning of each bit is as follows. 49<UL><LI>[20]: Set to 1 when a post-transfer is being executed.</LI><LI>[19]: Set to 1 when a memory fill is being executed.</LI><LI>[18]: Set to 1 when a FIFO underrun error occurs for the lower screen.</LI><LI>[17]: Set to 1 when a FIFO underrun error occurs for the upper screen.</LI><LI>[16]: Set to 1 when the post-vertex cache is busy.</LI><LI>[15]: Set to 1 when bit [1:0] of register 0x252 is set to 1.</LI><LI>[14]: Set to 1 when vertex processor 3 is busy.</LI><LI>[13]: Set to 1 when vertex processor 2 is busy.</LI><LI>[12]: Set to 1 when vertex processor 1 is busy.</LI><LI>[11]: Set to 1 when vertex processor 0 (which doubles as the geometry shader processor) is busy.</LI><LI>[10]: Set to 1 when bit [1:0] of register 0x229 is not set to 0.</LI><LI>[9]: Set to 1 when input is busy for the module that loads command buffers and vertex arrays.</LI><LI>[8]: Set to 1 when output is busy for the module that loads command buffers and vertex arrays.</LI><LI>[7]: Set to 1 when the early depth test module is busy.</LI><LI>[6]: Set to 1 when the color app data is busy.</LI><LI>[5]: Set to 1 when the color app data is busy.</LI><LI>[4]: Set to 1 when the texture combiner is busy.</LI><LI>[3]: Set to 1 when fragment lighting is busy.</LI><LI>[2]: Set to 1 when the texture unit is busy.</LI><LI>[1]: Set to 1 when the rasterization module is busy.</LI><LI>[0]: Set to 1 when the triangle setup is busy.</LI></UL></TD></TR></TABLE><!-- source NN_GX_CMDLIST_RUN_MODE ・・・ コマンドリストの実行モードを取得します。 NN_GX_CMDLIST_IS_RUNNING ・・・ コマンドリストの実行状態を取得します。 GL_TRUEが取得された場合、コマンドリストは実行中です。GL_FALSEが取得された場合、コマンドリストは実行中ではありません。 NN_GX_CMDLIST_USED_BUFSIZE ・・・ 蓄積された3Dコマンドバッファのバイトサイズを取得します。 NN_GX_CMDLIST_USED_REQCOUNT ・・・ 蓄積されたコマンドリクエストの個数を取得します。 NN_GX_CMDLIST_MAX_BUFSIZE ・・・ 3Dコマンドバッファの蓄積可能最大バイトサイズを取得します。 NN_GX_CMDLIST_MAX_REQCOUNT ・・・ コマンドリクエストの蓄積可能最大個数を取得します。 --></P><P> 50The following errors occur in this function. 51<TABLE><TR><TH>GL_ERROR_8017_DMP</TH><TD>The <span class="argument">pname</span> argument was set to an invalid value.</TD></TR><TR><TH>GL_ERROR_8018_DMP</TH><TD>The bound command list is 0, and something other than <CODE>NN_GX_CMDLIST_BINDING</CODE> was specified for <SPAN class="argument">pname</SPAN>.</TD></TR></TABLE></P></div> 52<h2>Revision History</h2> 53 <div class="section"> 54 <dl class="history"> 55 <dt>2010/10/25</dt> 56<dd>Added an explanation of <CODE>NN_GX_CMDLIST_CURRENT_BUFADDR</CODE><br /> 57 </dd> 58 <dt>2010/07/07</dt> 59<dd>Added values that can be specified for <SPAN class="argument">pname</SPAN>. 60 </dd> 61 <dt>2010/03/12</dt> 62<dd>Added extended error codes.<br /> 63 </dd> 64 <dt>2010/01/07</dt> 65<dd>Initial version.<br /> 66 </dd> 67 </dl> 68 </div> 69 <hr><p>CONFIDENTIAL</p></body> 70</html>