Performance and Optimization

Multimedia User Guide (UG1449)

Document ID
UG1449
Release Date
2022-04-21
Revision
1.4 English

Measuring Pipeline Performance

To measure pipeline performance, use the fpsdisplaysink in the pipeline. The following is a sample pipeline with fpsdisplaysink for file playback:

gst-launch-1.0 filesrc location="/media/card/input-file.mp4" !qtdemux name=demux
demux.video_0 ! h265parse ! omxh265dec ! queue max-size-bytes=0 ! 
fpsdisplaysink text-overlay=false video-sink="kmssink bus-id=a0070000.v_mix" -v

A sample performance log is as follows:

'GstPipeline:pipeline0/GstFPSDisplaySink:fpsdisplaysink0: last-message = rendered: 1079375, dropped: 6, current: 60.00, average: 59.99
'GstPipeline:pipeline0/GstFPSDisplaySink:fpsdisplaysink0: last-message = rendered: 1079406, dropped: 6, current: 60.00, average: 59.99
'GstPipeline:pipeline0/GstFPSDisplaySink:fpsdisplaysink0: last-message = rendered: 1079437, dropped: 6, current: 60.00, average: 59.99
'GstPipeline:pipeline0/GstFPSDisplaySink:fpsdisplaysink0: last-message = rendered: 1079468, dropped: 6, current: 60.00, average: 59.99
'GstPipeline:pipeline0/GstFPSDisplaySink:fpsdisplaysink0: last-message = rendered: 1079499, dropped: 6, current: 60.00, average: 59.99
'GstPipeline:pipeline0/GstFPSDisplaySink:fpsdisplaysink0: last-message = rendered: 1079529, dropped: 6, current: 60.00, average: 59.99
The log includes the following fields:
  • Current: The instance frame rate
  • Average: The average frame rate from the beginning
  • Dropped: The number of frame counts that are dropped
  • Rendered: The number of rendered frames