nngxSetProfilingParameter Function

Syntax

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

Arguments

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 features.

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 per sample of the busy counter in clock ticks. 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 value set here 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 value set here 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 samples of the busy counter. Specify a 16-bit value other than 0 in param. If 0 is specified, once sampling starts, it continues until nngxStopProfiling is called.

This function generates the following errors.

GL_ERROR_80A5_DMP An invalid value was specified for the pname parameter.
GL_ERROR_80A6_DMP An invalid value was specified for the param parameter.

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, NN_GX_PROFILING_BUSY_SAMPLING_TIME_NANO_SECOND.
2011/07/28
Initial version.

CONFIDENTIAL