Method: Roi#time_to_change

Defined in:

lib/roi/roi.rb

#time_to_change(args = {}) ⇒ Object

Public: Measures the approximate time for the given Roi to change.

Corresponds to: api_time_to_<ROI TYPE>_change

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

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

def time_to_change(args={})
  logger.info("Measuring time for #{self.class.name} to change")
  set_roi_options(args)
  first = retrieve
  measure(args) do
    retrieve != first
  end
end