Analysis tasks usually do not process every frame of a video.
This parameter specifies the minimum interval between frames that are selected to be analyzed. For example, if you set SampleInterval=125ms
then any two frames analyzed by the task will be separated by at least 125 milliseconds. This means that at most eight frames are analyzed for every second of video.
If the parameter IngestRate is set to 0
, the interval between the frames selected for analysis will be as close as possible to SampleInterval
.
If the parameter IngestRate is set to 1
, the interval between the frames selected for analysis will also be as close as possible to SampleInterval
. However, if the analysis task cannot process frames at this rate, it will increase the sample interval. For example, if you set SampleInterval=125ms
but the task is not able to analyze eight frames per second, it increases the sample interval and processes fewer frames than you requested.
In most cases HPE recommends that you use the default value of SampleInterval
. If you have set IngestRate=1
and a task significantly increases the sample interval, or if you have set IngestRate=0
and processing takes a long time, it might be due to the server having insufficient resources.
If you set the parameter RestrictToInputRegion to TRUE
, this parameter is ignored and Media Server processes all input frames.
Type: |
![]() The value of this parameter is a time duration. Specify the duration in the following format: 1days 2hours 3minutes 4seconds 500milliseconds 600microseconds You can omit any of the individual durations when they are not required: 4seconds 500milliseconds You can also shorten the string by abbreviating the units to their first letter (milliseconds abbreviates to ms, microseconds to us): 4s 500ms The following are all equivalent: 1minute 3seconds A single number without any units specifies the value in milliseconds, but this functionality is deprecated and HPE recommends that you specify the relevant units. |
Default: | 1000ms |
Required: | No |
Configuration Section: | TaskName |
Example: | SampleInterval=125ms
|
See Also: | IngestRate |
|