impeller::GPUTracerGLES Class Reference

Trace GPU execution times using GL_EXT_disjoint_timer_query on GLES. More...

#include <gpu_tracer_gles.h>

Public Member Functions
	GPUTracerGLES (const ProcTableGLES &gl, bool enable_tracing)
	~GPUTracerGLES ()=default
void	RecordRasterThread ()
	Record the thread id of the raster thread. More...
void	MarkFrameStart (const ProcTableGLES &gl)
	Record the start of a frame workload, if one hasn't already been started. More...
void	MarkFrameEnd (const ProcTableGLES &gl)
	Record the end of a frame workload. More...

Detailed Description

Trace GPU execution times using GL_EXT_disjoint_timer_query on GLES.

Note: there are a substantial number of GPUs where usage of the this API is known to cause crashes. As a result, this functionality is disabled by default and can only be enabled in debug/profile mode via a specific opt-in flag that is exposed in the Android manifest.

To enable, add the following metadata to the application's Android manifest: <meta-data android:name="io.flutter.embedding.android.EnableOpenGLGPUTracing" android:value="false" />

Definition at line 27 of file gpu_tracer_gles.h.

Constructor & Destructor Documentation

GPUTracerGLES()

impeller::GPUTracerGLES::GPUTracerGLES	(	const ProcTableGLES &	gl,
		bool	enable_tracing
	)

Definition at line 11 of file gpu_tracer_gles.cc.

                                                                         {
#ifdef IMPELLER_DEBUG
  auto desc = gl.GetDescription();
  enabled_ =
      enable_tracing && desc->HasExtension("GL_EXT_disjoint_timer_query");
#endif  // IMPELLER_DEBUG
}

References impeller::ProcTableGLES::GetDescription().

~GPUTracerGLES()

impeller::GPUTracerGLES::~GPUTracerGLES ( )

default

Member Function Documentation

MarkFrameEnd()

void impeller::GPUTracerGLES::MarkFrameEnd

(

const ProcTableGLES &

gl

)

Record the end of a frame workload.

Definition at line 75 of file gpu_tracer_gles.cc.

                                                        {
  if (!enabled_ || std::this_thread::get_id() != raster_thread_ ||
      !active_frame_.has_value()) {
    return;
  }
 
  auto query = active_frame_.value();
  gl.EndQueryEXT(GL_TIME_ELAPSED_EXT);
 
  pending_traces_.push_back(query);
  active_frame_ = std::nullopt;
}

MarkFrameStart()

void impeller::GPUTracerGLES::MarkFrameStart

(

const ProcTableGLES &

gl

)

Record the start of a frame workload, if one hasn't already been started.

Definition at line 19 of file gpu_tracer_gles.cc.

                                                          {
  if (!enabled_ || active_frame_.has_value() ||
      std::this_thread::get_id() != raster_thread_) {
    return;
  }
 
  // At the beginning of a frame, check the status of all pending
  // previous queries.
  ProcessQueries(gl);
 
  uint32_t query = 0;
  gl.GenQueriesEXT(1, &query);
  if (query == 0) {
    return;
  }
 
  active_frame_ = query;
  gl.BeginQueryEXT(GL_TIME_ELAPSED_EXT, query);
}

RecordRasterThread()

void impeller::GPUTracerGLES::RecordRasterThread

(

)

Record the thread id of the raster thread.

Definition at line 39 of file gpu_tracer_gles.cc.

                                       {
  raster_thread_ = std::this_thread::get_id();
}

---

The documentation for this class was generated from the following files:

• impeller/renderer/backend/gles/gpu_tracer_gles.h
• impeller/renderer/backend/gles/gpu_tracer_gles.cc