Classes
class	ScopedInstantEnd

class	TraceFlow

Typedefs
using	TraceArg = const char *

using	TraceIDArg = int64_t

typedef void(*	TimelineEventHandler) (const char , int64_t, int64_t, intptr_t, const int64_t , Dart_Timeline_Event_Type, intptr_t, const char , const char )

using	TimelineMicrosSource = int64_t(*)()

Functions
void	TraceSetAllowlist (const std::vector< std::string > &allowlist)

void	TraceSetTimelineEventHandler (TimelineEventHandler handler)

bool	TraceHasTimelineEventHandler ()

int64_t	TraceGetTimelineMicros ()

void	TraceSetTimelineMicrosSource (TimelineMicrosSource source)

size_t	TraceNonce ()

void	TraceTimelineEvent (TraceArg category_group, TraceArg name, int64_t timestamp_micros, TraceIDArg identifier, size_t flow_id_count, const uint64_t flow_ids, Dart_Timeline_Event_Type type, const std::vector< const char > &c_names, const std::vector< std::string > &values)

void	TraceTimelineEvent (TraceArg category_group, TraceArg name, TraceIDArg identifier, size_t flow_id_count, const uint64_t flow_ids, Dart_Timeline_Event_Type type, const std::vector< const char > &c_names, const std::vector< std::string > &values)

void	TraceEvent0 (TraceArg category_group, TraceArg name, size_t flow_id_count, const uint64_t *flow_ids)

void	TraceEvent1 (TraceArg category_group, TraceArg name, size_t flow_id_count, const uint64_t *flow_ids, TraceArg arg1_name, TraceArg arg1_val)

void	TraceEvent2 (TraceArg category_group, TraceArg name, size_t flow_id_count, const uint64_t *flow_ids, TraceArg arg1_name, TraceArg arg1_val, TraceArg arg2_name, TraceArg arg2_val)

void	TraceEventEnd (TraceArg name)

void	TraceEventAsyncComplete (TraceArg category_group, TraceArg name, TimePoint begin, TimePoint end)

void	TraceEventAsyncBegin0 (TraceArg category_group, TraceArg name, TraceIDArg id, size_t flow_id_count, const uint64_t *flow_ids)

void	TraceEventAsyncEnd0 (TraceArg category_group, TraceArg name, TraceIDArg id)

void	TraceEventAsyncBegin1 (TraceArg category_group, TraceArg name, TraceIDArg id, size_t flow_id_count, const uint64_t *flow_ids, TraceArg arg1_name, TraceArg arg1_val)

void	TraceEventAsyncEnd1 (TraceArg category_group, TraceArg name, TraceIDArg id, TraceArg arg1_name, TraceArg arg1_val)

void	TraceEventInstant0 (TraceArg category_group, TraceArg name, size_t flow_id_count, const uint64_t *flow_ids)

void	TraceEventInstant1 (TraceArg category_group, TraceArg name, size_t flow_id_count, const uint64_t *flow_ids, TraceArg arg1_name, TraceArg arg1_val)

void	TraceEventInstant2 (TraceArg category_group, TraceArg name, size_t flow_id_count, const uint64_t *flow_ids, TraceArg arg1_name, TraceArg arg1_val, TraceArg arg2_name, TraceArg arg2_val)

void	TraceEventFlowBegin0 (TraceArg category_group, TraceArg name, TraceIDArg id)

void	TraceEventFlowStep0 (TraceArg category_group, TraceArg name, TraceIDArg id)

void	TraceEventFlowEnd0 (TraceArg category_group, TraceArg name, TraceIDArg id)

std::string	TraceToString (const char *string)

std::string	TraceToString (std::string string)

std::string	TraceToString (TimePoint point)

template<typename T , typename = std::enable_if_t<std::is_arithmetic<T>::value>>
std::string	TraceToString (T string)

void	SplitArgumentsCollect (std::vector< const char * > &keys, std::vector< std::string > &values)

template<typename Key , typename Value , typename... Args>
void	SplitArgumentsCollect (std::vector< const char * > &keys, std::vector< std::string > &values, Key key, Value value, Args... args)

std::pair< std::vector< const char * >, std::vector< std::string > >	SplitArguments ()

template<typename Key , typename Value , typename... Args>
std::pair< std::vector< const char * >, std::vector< std::string > >	SplitArguments (Key key, Value value, Args... args)

template<typename... Args>
void	TraceCounter (TraceArg category, TraceArg name, TraceIDArg identifier, Args... args)

template<typename... Args>
void	TraceCounterNopHACK (TraceArg category, TraceArg name, TraceIDArg identifier, Args... args)

template<typename... Args>
void	TraceEvent (TraceArg category, TraceArg name, size_t flow_id_count, const uint64_t *flow_ids, Args... args)

template<typename... Args>
void	TraceEventAsyncComplete (TraceArg category_group, TraceArg name, TimePoint begin, TimePoint end, Args... args)

Typedef Documentation

◆ TimelineEventHandler

typedef void(* fml::tracing::TimelineEventHandler) (const char *, int64_t, int64_t, intptr_t, const int64_t *, Dart_Timeline_Event_Type, intptr_t, const char **, const char **)

Definition at line 217 of file trace_event.h.

◆ TimelineMicrosSource

using fml::tracing::TimelineMicrosSource = typedef int64_t (*)()

Definition at line 227 of file trace_event.h.

◆ TraceArg

using fml::tracing::TraceArg = typedef const char*

Definition at line 212 of file trace_event.h.

◆ TraceIDArg

using fml::tracing::TraceIDArg = typedef int64_t

Definition at line 213 of file trace_event.h.

Function Documentation

◆ SplitArguments() [1/2]

std::pair< std::vector< const char * >, std::vector< std::string > > fml::tracing::SplitArguments ( )

inline

Definition at line 288 of file trace_event.h.

                 {
  return {};
}

Referenced by TraceCounter(), TraceEvent(), and TraceEventAsyncComplete().

◆ SplitArguments() [2/2]

template<typename Key , typename Value , typename... Args>

std::pair< std::vector< const char * >, std::vector< std::string > > fml::tracing::SplitArguments	(	Key	key,
		Value	value,
		Args...	args
	)

Definition at line 294 of file trace_event.h.

                                                   {
  std::vector<const char*> keys;
  std::vector<std::string> values;
  SplitArgumentsCollect(keys, values, key, std::move(value), args...);
  return std::make_pair(std::move(keys), std::move(values));
}

References args, key, SplitArgumentsCollect(), and value.

◆ SplitArgumentsCollect() [1/2]

void fml::tracing::SplitArgumentsCollect	(	std::vector< const char * > &	keys,
		std::vector< std::string > &	values
	)

inline

Definition at line 273 of file trace_event.h.

274 {}

Referenced by SplitArguments(), and SplitArgumentsCollect().

◆ SplitArgumentsCollect() [2/2]

template<typename Key , typename Value , typename... Args>

void fml::tracing::SplitArgumentsCollect	(	std::vector< const char * > &	keys,
		std::vector< std::string > &	values,
		Key	key,
		Value	value,
		Args...	args
	)

Definition at line 277 of file trace_event.h.

                                         {
  keys.emplace_back(key);
  values.emplace_back(TraceToString(std::move(value)));
  SplitArgumentsCollect(keys, values, args...);
}

References args, key, SplitArgumentsCollect(), TraceToString(), and value.

◆ TraceCounter()

template<typename... Args>

void fml::tracing::TraceCounter	(	TraceArg	category,
		TraceArg	name,
		TraceIDArg	identifier,
		Args...	args
	)

Definition at line 304 of file trace_event.h.

                                {
#if FLUTTER_TIMELINE_ENABLED
  auto split = SplitArguments(args...);
  TraceTimelineEvent(category, name, identifier, /*flow_id_count=*/0,
                     /*flow_ids=*/nullptr, Dart_Timeline_Event_Counter,
                     split.first, split.second);
#endif  // FLUTTER_TIMELINE_ENABLED
}

References args, name, SplitArguments(), and TraceTimelineEvent().

◆ TraceCounterNopHACK()

template<typename... Args>

void fml::tracing::TraceCounterNopHACK	(	TraceArg	category,
		TraceArg	name,
		TraceIDArg	identifier,
		Args...	args
	)

Definition at line 319 of file trace_event.h.

322 {}

◆ TraceEvent()

template<typename... Args>

void fml::tracing::TraceEvent	(	TraceArg	category,
		TraceArg	name,
		size_t	flow_id_count,
		const uint64_t *	flow_ids,
		Args...	args
	)

Definition at line 325 of file trace_event.h.

                              {
#if FLUTTER_TIMELINE_ENABLED
  auto split = SplitArguments(std::move(args)...);
  TraceTimelineEvent(category, name, 0, flow_id_count, flow_ids,
                     Dart_Timeline_Event_Begin, split.first, split.second);
#endif  // FLUTTER_TIMELINE_ENABLED
}

References args, name, SplitArguments(), and TraceTimelineEvent().

◆ TraceEvent0()

void fml::tracing::TraceEvent0	(	TraceArg	category_group,
		TraceArg	name,
		size_t	flow_id_count,
		const uint64_t *	flow_ids
	)

Definition at line 408 of file trace_event.cc.

411 {}

Referenced by flutter::FlutterEventTracer::addTraceEvent(), fml::tracing::TraceFlow::End(), FlutterEngineTraceEventDurationBegin(), fml::tracing::TraceFlow::Step(), and fml::tracing::TraceFlow::TraceFlow().

◆ TraceEvent1()

void fml::tracing::TraceEvent1	(	TraceArg	category_group,
		TraceArg	name,
		size_t	flow_id_count,
		const uint64_t *	flow_ids,
		TraceArg	arg1_name,
		TraceArg	arg1_val
	)

Definition at line 413 of file trace_event.cc.

418 {}

Referenced by flutter::FlutterEventTracer::addTraceEvent().

◆ TraceEvent2()

void fml::tracing::TraceEvent2	(	TraceArg	category_group,
		TraceArg	name,
		size_t	flow_id_count,
		const uint64_t *	flow_ids,
		TraceArg	arg1_name,
		TraceArg	arg1_val,
		TraceArg	arg2_name,
		TraceArg	arg2_val
	)

Definition at line 420 of file trace_event.cc.

427 {}

◆ TraceEventAsyncBegin0()

void fml::tracing::TraceEventAsyncBegin0	(	TraceArg	category_group,
		TraceArg	name,
		TraceIDArg	id,
		size_t	flow_id_count,
		const uint64_t *	flow_ids
	)

Definition at line 436 of file trace_event.cc.

440 {}

Referenced by flutter::FlutterEventTracer::addTraceEvent().

◆ TraceEventAsyncBegin1()

void fml::tracing::TraceEventAsyncBegin1	(	TraceArg	category_group,
		TraceArg	name,
		TraceIDArg	id,
		size_t	flow_id_count,
		const uint64_t *	flow_ids,
		TraceArg	arg1_name,
		TraceArg	arg1_val
	)

Definition at line 446 of file trace_event.cc.

452 {}

Referenced by flutter::FlutterEventTracer::addTraceEvent().

◆ TraceEventAsyncComplete() [1/2]

void fml::tracing::TraceEventAsyncComplete	(	TraceArg	category_group,
		TraceArg	name,
		TimePoint	begin,
		TimePoint	end
	)

Definition at line 431 of file trace_event.cc.

434 {}

◆ TraceEventAsyncComplete() [2/2]

template<typename... Args>

void fml::tracing::TraceEventAsyncComplete	(	TraceArg	category_group,
		TraceArg	name,
		TimePoint	begin,
		TimePoint	end,
		Args...	args
	)

Definition at line 361 of file trace_event.h.

                                           {
#if FLUTTER_TIMELINE_ENABLED
  auto identifier = TraceNonce();
  const auto split = SplitArguments(args...);
 
  if (begin > end) {
    std::swap(begin, end);
  }
 
  const int64_t begin_micros = begin.ToEpochDelta().ToMicroseconds();
  const int64_t end_micros = end.ToEpochDelta().ToMicroseconds();
 
  TraceTimelineEvent(category_group,                   // group
                     name,                             // name
                     begin_micros,                     // timestamp_micros
                     identifier,                       // identifier
                     0,                                // flow_id_count
                     nullptr,                          // flow_ids
                     Dart_Timeline_Event_Async_Begin,  // type
                     split.first,                      // names
                     split.second                      // values
  );
 
  TraceTimelineEvent(category_group,                 // group
                     name,                           // name
                     end_micros,                     // timestamp_micros
                     identifier,                     // identifier
                     0,                              // flow_id_count
                     nullptr,                        // flow_ids
                     Dart_Timeline_Event_Async_End,  // type
                     split.first,                    // names
                     split.second                    // values
  );
#endif  // FLUTTER_TIMELINE_ENABLED
}

References args, end, name, SplitArguments(), fml::TimePoint::ToEpochDelta(), fml::TimeDelta::ToMicroseconds(), TraceNonce(), and TraceTimelineEvent().

◆ TraceEventAsyncEnd0()

void fml::tracing::TraceEventAsyncEnd0	(	TraceArg	category_group,
		TraceArg	name,
		TraceIDArg	id
	)

Definition at line 442 of file trace_event.cc.

444 {}

Referenced by flutter::FlutterEventTracer::addTraceEvent().

◆ TraceEventAsyncEnd1()

void fml::tracing::TraceEventAsyncEnd1	(	TraceArg	category_group,
		TraceArg	name,
		TraceIDArg	id,
		TraceArg	arg1_name,
		TraceArg	arg1_val
	)

Definition at line 454 of file trace_event.cc.

458 {}

Referenced by flutter::FlutterEventTracer::addTraceEvent().

◆ TraceEventEnd()

void fml::tracing::TraceEventEnd ( TraceArg name )

Definition at line 429 of file trace_event.cc.

429{}

Referenced by flutter::FlutterEventTracer::addTraceEvent(), fml::tracing::TraceFlow::End(), FlutterEngineTraceEventDurationEnd(), fml::tracing::TraceFlow::Step(), fml::tracing::TraceFlow::TraceFlow(), flutter::FlutterEventTracer::updateTraceEventDuration(), and fml::tracing::ScopedInstantEnd::~ScopedInstantEnd().

◆ TraceEventFlowBegin0()

void fml::tracing::TraceEventFlowBegin0	(	TraceArg	category_group,
		TraceArg	name,
		TraceIDArg	id
	)

Definition at line 481 of file trace_event.cc.

483 {}

Referenced by fml::tracing::TraceFlow::TraceFlow().

◆ TraceEventFlowEnd0()

void fml::tracing::TraceEventFlowEnd0	(	TraceArg	category_group,
		TraceArg	name,
		TraceIDArg	id
	)

Definition at line 489 of file trace_event.cc.

489 {

490}

Referenced by fml::tracing::TraceFlow::End().

◆ TraceEventFlowStep0()

void fml::tracing::TraceEventFlowStep0	(	TraceArg	category_group,
		TraceArg	name,
		TraceIDArg	id
	)

Definition at line 485 of file trace_event.cc.

487 {}

Referenced by fml::tracing::TraceFlow::Step().

◆ TraceEventInstant0()

void fml::tracing::TraceEventInstant0	(	TraceArg	category_group,
		TraceArg	name,
		size_t	flow_id_count,
		const uint64_t *	flow_ids
	)

Definition at line 460 of file trace_event.cc.

463 {}

Referenced by flutter::FlutterEventTracer::addTraceEvent(), and FlutterEngineTraceEventInstant().

◆ TraceEventInstant1()

void fml::tracing::TraceEventInstant1	(	TraceArg	category_group,
		TraceArg	name,
		size_t	flow_id_count,
		const uint64_t *	flow_ids,
		TraceArg	arg1_name,
		TraceArg	arg1_val
	)

Definition at line 465 of file trace_event.cc.

470 {}

Referenced by flutter::FlutterEventTracer::addTraceEvent().

◆ TraceEventInstant2()

void fml::tracing::TraceEventInstant2	(	TraceArg	category_group,
		TraceArg	name,
		size_t	flow_id_count,
		const uint64_t *	flow_ids,
		TraceArg	arg1_name,
		TraceArg	arg1_val,
		TraceArg	arg2_name,
		TraceArg	arg2_val
	)

Definition at line 472 of file trace_event.cc.

479 {}

◆ TraceGetTimelineMicros()

int64_t fml::tracing::TraceGetTimelineMicros ( )

Definition at line 379 of file trace_event.cc.

                                 {
  return -1;
}

Referenced by flutter::testing::TEST_F().

◆ TraceHasTimelineEventHandler()

bool fml::tracing::TraceHasTimelineEventHandler ( )

Definition at line 375 of file trace_event.cc.

                                    {
  return false;
}

Referenced by flutter::testing::TEST_F().

◆ TraceNonce()

size_t fml::tracing::TraceNonce ( )

Definition at line 385 of file trace_event.cc.

                    {
  return 0;
}

Referenced by flutter::VsyncWaiter::FireCallback(), and TraceEventAsyncComplete().

◆ TraceSetAllowlist()

void fml::tracing::TraceSetAllowlist ( const std::vector< std::string > & allowlist )

Definition at line 371 of file trace_event.cc.

371{}

◆ TraceSetTimelineEventHandler()

void fml::tracing::TraceSetTimelineEventHandler ( TimelineEventHandler handler )

Definition at line 373 of file trace_event.cc.

373{}

Referenced by DartVMInitializer::Initialize(), and flutter::testing::TEST_F().

◆ TraceSetTimelineMicrosSource()

void fml::tracing::TraceSetTimelineMicrosSource ( TimelineMicrosSource source )

Definition at line 383 of file trace_event.cc.

383{}

Referenced by DartVMInitializer::Initialize().

◆ TraceTimelineEvent() [1/2]

void fml::tracing::TraceTimelineEvent	(	TraceArg	category_group,
		TraceArg	name,
		int64_t	timestamp_micros,
		TraceIDArg	identifier,
		size_t	flow_id_count,
		const uint64_t *	flow_ids,
		Dart_Timeline_Event_Type	type,
		const std::vector< const char * > &	c_names,
		const std::vector< std::string > &	values
	)

Definition at line 389 of file trace_event.cc.

397 {}

Referenced by TraceCounter(), TraceEvent(), and TraceEventAsyncComplete().

◆ TraceTimelineEvent() [2/2]

void fml::tracing::TraceTimelineEvent	(	TraceArg	category_group,
		TraceArg	name,
		TraceIDArg	identifier,
		size_t	flow_id_count,
		const uint64_t *	flow_ids,
		Dart_Timeline_Event_Type	type,
		const std::vector< const char * > &	c_names,
		const std::vector< std::string > &	values
	)

Definition at line 399 of file trace_event.cc.

406 {}

◆ TraceToString() [1/4]

std::string fml::tracing::TraceToString ( const char * string )

inline

Definition at line 256 of file trace_event.h.

                                                   {
  return std::string{string};
}

Referenced by SplitArgumentsCollect().

◆ TraceToString() [2/4]

std::string fml::tracing::TraceToString ( std::string string )

inline

Definition at line 260 of file trace_event.h.

                                                 {
  return string;
}

◆ TraceToString() [3/4]

template<typename T , typename = std::enable_if_t<std::is_arithmetic<T>::value>>

std::string fml::tracing::TraceToString ( T string )

Definition at line 269 of file trace_event.h.

                                  {
  return std::to_string(string);
}

◆ TraceToString() [4/4]

std::string fml::tracing::TraceToString ( TimePoint point )

inline

Definition at line 264 of file trace_event.h.

                                                {
  return std::to_string(point.ToEpochDelta().ToNanoseconds());
}

References fml::TimePoint::ToEpochDelta(), and fml::TimeDelta::ToNanoseconds().

Classes

Typedefs

Functions

Typedef Documentation

◆ TimelineEventHandler

◆ TimelineMicrosSource

◆ TraceArg

◆ TraceIDArg

Function Documentation

◆ SplitArguments() [1/2]

◆ SplitArguments() [2/2]

◆ SplitArgumentsCollect() [1/2]

◆ SplitArgumentsCollect() [2/2]

◆ TraceCounter()

◆ TraceCounterNopHACK()

◆ TraceEvent()

◆ TraceEvent0()

◆ TraceEvent1()

◆ TraceEvent2()

◆ TraceEventAsyncBegin0()

◆ TraceEventAsyncBegin1()

◆ TraceEventAsyncComplete() [1/2]

◆ TraceEventAsyncComplete() [2/2]

◆ TraceEventAsyncEnd0()

◆ TraceEventAsyncEnd1()

◆ TraceEventEnd()

◆ TraceEventFlowBegin0()

◆ TraceEventFlowEnd0()

◆ TraceEventFlowStep0()

◆ TraceEventInstant0()

◆ TraceEventInstant1()

◆ TraceEventInstant2()

◆ TraceGetTimelineMicros()

◆ TraceHasTimelineEventHandler()

◆ TraceNonce()

◆ TraceSetAllowlist()

◆ TraceSetTimelineEventHandler()

◆ TraceSetTimelineMicrosSource()

◆ TraceTimelineEvent() [1/2]

◆ TraceTimelineEvent() [2/2]

◆ TraceToString() [1/4]

◆ TraceToString() [2/4]

◆ TraceToString() [3/4]

◆ TraceToString() [4/4]