nngxSetProfilingParameter Function

Syntax

NNGX_APICALL void NNGX_APIENTRY nngxSetProfilingParameter(
     GLenum pname,
     GLuint param
);

Parameters

Name Description
in pname Parameter for the profiling functionality.
in param Value to set.

Return Values

No values are returned.

Description

Sets a parameter for the profiling functionality.

Operation is undefined when starting the profiling features (busy counters) before setting the parameters. Be sure to configure the parameters with appropriate values before starting the profiling features.

The following table lists the parameter names and values that can be specified in pname.

NN_GX_PROFILING_BUSY_SAMPLING_TIME Specifies the amount of time, in clock ticks, to spend profiling the busy counter each time it is sampled. Specify a 16-bit value other than 0 in param.
If 0 is specified for NN_GX_PROFILING_BUSY_SAMPLING_COUNT, it does not affect operations. (If some 16-bit value other than 0 is specified, the behavior is the same no matter what is set.)
NN_GX_PROFILING_BUSY_SAMPLING_TIME_MICRO_SECOND Set to the same value as NN_GX_PROFILING_BUSY_SAMPLING_TIME in microseconds. You can set to a value between 1 and 244.
(The specified value is converted internally to clock cycles for a 268-MHz operation clock and set to the hardware. The value converted to clock cycles must fit within 16 bits.)
NN_GX_PROFILING_BUSY_SAMPLING_TIME_NANO_SECOND Set to the same value as NN_GX_PROFILING_BUSY_SAMPLING_TIME in nanoseconds. You can set to a value between 1 and 244537.
(The specified value is converted internally to clock cycles for a 268-MHz operation clock and set to the hardware. The value converted to clock cycles must fit within 16 bits.)
NN_GX_PROFILING_BUSY_SAMPLING_COUNT Specifies the number of samplings of the busy counter. Specify a 16-bit value for param. If 0 is specified, once sampling starts, it continues until nngxStopProfiling is called.

This function generates the following errors.

GL_ERROR_80A5_DMP The pname parameter is not valid.
GL_ERROR_80A6_DMP The param parameter is not valid.

Revision History

2012/02/03
Added more comments for various parameters.
2011/08/24
Added explanations about NN_GX_PROFILING_BUSY_SAMPLING_TIME_MICRO_SECOND and NN_GX_PROFILING_BUSY_SAMPLING_TIME_NANO_SECOND.
2011/07/28
Initial version.

CONFIDENTIAL