Method: Roi#precise_time_to_display

Defined in:

lib/roi/roi.rb

#precise_time_to_display(args = {}) ⇒ Object

Public: Measures the precise time for the given Roi to be displayed.

Corresponds to: api_hp_time_to_display_<ROI TYPE>

key - String key press to trigger evaluation (default: nil).

If default, no key will be pressed.

delay - Integer total milliseconds to delay before starting evaluation (default: 0). timeout - Integer total milliseconds to allow before timing out (default: nil).

If default, timeout will be calculated as [ delay + 5000 ].

scale - Boolean if the larger image should be scaled to the size of the smaller image (default: false).

Applies to image ROIs only.

priority - Symbol evaluation priority used to throttle CPU usage (default: :normal):

:critical   - Sleep 10 ms between intensive tasks (USE SPARINGLY)
:high       - Sleep 100 ms between intensive tasks
:normal     - Sleep 1 second between intensive tasks
:low        - Sleep 10 seconds between intensive tasks
:background - Sleep 1 minute between intensive tasks (USE SPARINGLY)

log_every - Integer total milliseconds between logs (default: 1000). report - Boolean indicating whether to report measurements to ITMS (default: true).

Returns the Float total milliseconds for the Roi to be displayed.

# File 'lib/roi/roi.rb', line 215

def precise_time_to_display(args={})
  logger.info("Measuring precise time to display #{self.class.name}")
  args[:precise] = true
  args[:with_last_frame] = true
  measure(args) do |frame, last_frame|
    displayed?(:frame => frame, :last_frame => last_frame, :set_roi_options => args)
  end
end