nngxStartProfiling Function

Syntax

NNGX_APICALL void NNGX_APIENTRY nngxStartProfiling(
     GLenum item
);

Parameters

Name Description
in item Profiling functionality

Return Values

No values are returned.

Description

Starts sampling profile information.

Starts the profiling functionality specified in item.

You can set the following values in item.

NN_GX_PROFILING_BUSY Starts incrementing the busy counter. Execution stops when the amount of time (measurement interval * sampling count) set in the nngxSetProfilingParameter function has elapsed or when the nngxStopProfiling function is called. When the sampling count is 0, execution does not stop until the nngxStopProfiling function is called. Operation is undefined when starting profiling without configuring the relevant parameters by calling the nngxSetProfilingParameter function. Be sure to configure the parameters with appropriate values before starting.
NN_GX_PROFILING_VERTEX_CACHE Starts the vertex cache input vertex count counter. Execution stops when the nngxStopProfiling function is called. Power consumption may rise when this feature starts. Always stop execution if this feature is not going to be used.

Some profiling items require the specification of start and stop times for the sampling of profiling information. If a profile item is not listed in the above table, the counter runs continuously for that item. The results of profiling can be obtained even if sampling is not explicitly started using this function.

If the vertex cache input count counter is not started using this function, you can still obtain a profiling result as if the counter were running, but the value may not be correct. Always start the counter by calling this function to get the correct profiling results.

Do not call this function while the GPU is executing (executing a command list). Although errors will not occur if called during GPU execution, the GPU may perform illegal operations.

This function generates the following errors.

GL_ERROR_80A2_DMPAn illegal value was specified in item.

See Also

nngxStopProfiling

Revision History

2011/08/24
Added explanation that parameters must be configured before starting the busy counter.
2011/07/28
Initial version.

CONFIDENTIAL