Skip Frames
The Skip Frames feature is a frame sampling filter that skips unnecessary frames to reduce processing load and time for tasks that do not require full-frame processing, such as previews, inspecting specific segments of a stream, and lightweight analysis pipelines.
Enabling Skip Frames
You can configure Skip Frames in Server.xml under <OutputProfiles><OutputProfile><Encodes> as follows:
<Server>
...
<OutputProfiles>
...
<OutputProfile>
...
<Encodes>
<Video>
<Name>h264_1080</Name>
<Codec>h264</Codec>
<Bitrate>7000000</Bitrate>
<Width>3840</Width>
<Height>2160</Height>
<!--
SkipFrames configuration:
-1 : Disable frame skipping (no frames are dropped).
0 : Enable automatic frame skipping.
The number of frames to drop is dynamically calculated
based on the current queue state and system load.
1 ~ 120 :
Enable fixed-ratio frame skipping.
Frames are dropped according to the configured value.
For example:
- 1 : Drop 1 frame out of every 2 frames
- 2 : Drop 2 frames out of every 3 frames
- N : Drop N frames out of every (N + 1) frames
The maximum allowed value is 120.
-->
<SkipFrames>1</SkipFrames>
</Video>
</Encodes>
</OutputProfiles>
...
</OutputProfiles>
...
</Server>
| Value | Input Range | Description |
|---|---|---|
| -1 | -1 | Disables the Skip Frames feature.
|
| 0 | 0 | Enables the Skip Frames feature (Auto). Dynamically adjusts the number of skipped frames based on system load and queue backlog. |
| N | 1~120 | Enables the Skip Frames feature with a fixed ratio. Skips frames based on the configured value (N). Fixed ratio: Skips N frames out of every (N+1) input frames, processing the remaining 1 frame.
|